Windows上安装 OpenClaw 的详细教程

有两种主流方案，你可以根据自己的技术偏好选择：

⚠️ 重要提示

OpenClaw具备操控电脑的能力，拥有较高权限。为了安全起见，建议不要直接在主力个人电脑上安装，可以考虑在虚拟机或一台不常用的电脑上体验。下面进入详细的安装步骤。

方案一：PowerShell直接安装（新手推荐）

这是官方推荐给大多数Windows用户的快速安装方式，整个流程可以在30-60分钟内完成。

第一步：准备工作

1. 检查系统：确保你的Windows版本是Windows 10 64位或Windows 11。硬件方面，建议内存至少4GB，硬盘有50GB以上空闲空间。
2. 准备API密钥：OpenClaw本身不具备AI能力，需要接入大模型。你可以提前在阿里云百炼（新用户有免费额度）、智谱AI（BigModel） 或 Ollama（本地模型）等平台注册，获取一个API密钥。本教程以智谱AI的GLM模型为例。

第二步：安装Node.js

OpenClaw的运行依赖Node.js环境，且要求版本 ≥ v22。

1. 访问 Node.js官网，下载Windows安装包（.msi文件）。
2. 双击安装，在“Custom Setup”页面，务必确保 “Add Node.js to PATH” 选项被勾选，这是自动配置环境变量的关键步骤。之后一路“Next”完成安装。
3. 重启你的电脑，确保环境变量生效。

第三步：打开PowerShell并执行安装

1. 在开始菜单搜索“PowerShell”，右键点击，选择“以管理员身份运行”。

2. 解锁脚本执行权限：输入以下命令并回车，出现提示时输入 Y 确认：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 执行一键安装：在PowerShell中输入以下命令并回车，等待屏幕显示安装成功即可：

   iwr -useb https://clawd.bot/install.ps1 | iex

   如果上述链接失效，可以尝试官方备用链接：iwr -useb https://openclaw.ai/install.ps1 | iex。

第四步：运行初始化向导

1. 安装成功后，在PowerShell中输入以下命令启动配置向导：

   openclaw onboard --install-daemon

2. 根据向导提示进行配置，新手可按以下推荐选项一路选择即可：

   • Onboarding mode：选择 Quick Start（快速启动）。
   • Model/auth provider：选择你准备使用的模型服务商，例如 Z.AI (智谱) 或 Qwen (通义)。
   • Enter API Key：粘贴你之前准备好的API密钥。
   • Default model：保持默认，直接回车。
   • Select channel / Configure skills / Enable hooks：这几步都是配置额外的通信渠道和功能插件，新手可以先选择 Skip for now 或 No 跳过，以后熟悉了再慢慢添加。
   • How do you want to hatch your bot？：如果想在浏览器里使用，可以选择 Hatch in Dashboard；如果想在命令行里直接聊天，可以选择 Hatch in TUI。这里推荐选择前者。

第五步：验证和授权

1. 向导完成后，OpenClaw的网关服务（Gateway）应该会自动启动。打开浏览器，访问 http://127.0.0.1:18789。
2. 如果页面提示“未授权：网关令牌缺失”，别担心。打开文件资源管理器，进入 C:\Users\你的用户名\.clawdbot 文件夹，用记事本打开 clawdbot.json 文件。
3. 在文件中找到形如 "token": "xxxxxxxx" 的一行，复制引号内的长字符串（令牌）。
4. 回到浏览器页面，点击右上角的红色状态提示，粘贴令牌，状态变绿即代表授权成功，你的OpenClaw就正式上线了！

方案二：WSL2安装（更稳定、功能完整）

如果你希望OpenClaw运行得更稳定，或者想体验它的全部功能（特别是涉及文件系统操作的部分），那么在WSL2的Linux子系统中安装是更好的选择。这个方法虽然多了一步，但能提供与Linux一致的原生体验。

第一步：安装WSL2和Ubuntu

1. 以管理员身份打开PowerShell，输入以下命令启用WSL并安装Ubuntu（默认最新LTS版）：

   wsl --install

2. 命令执行后，系统会提示你重启电脑。重启后，系统会自动完成安装并打开一个Ubuntu窗口，按照提示设置你的Linux用户名和密码即可。

第二步：在Ubuntu中安装OpenClaw

1. 打开你刚安装好的 Ubuntu 应用（这是一个Linux终端）。

2. 首先更新软件包列表并安装curl（后续命令需要）：

   sudo apt update
   sudo apt install -y curl

3. 安装Node.js 22：在Ubuntu终端中执行以下命令：

   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
   sudo apt install -y nodejs
   node --version # 验证版本应为v22.x.x

4. 执行一键安装：最后，运行OpenClaw的Linux安装脚本：

   curl -fsSL https://openclaw.ai/install.sh | bash

第三步：配置与使用

1. 安装完成后，后续的初始化向导（openclaw onboard）、模型配置、网关启动等步骤，与方案一的第四步、第五步完全一致，在Ubuntu终端中操作即可。
2. 配置成功后，你可以在Windows的浏览器中直接访问 http://127.0.0.1:18789 来使用OpenClaw，和在Windows原生安装的体验是一样的。

常见问题与解决

• openclaw 命令找不到？
  安装后需要重启终端，或者将npm全局安装路径添加到系统环境变量中。临时解决可以用 npx openclaw 命令 代替。

• 访问 http://127.0.0.1:18789 显示“未授权”或“无法访问”？

  1. 确保网关服务正在运行：在PowerShell或Ubuntu终端中执行 openclaw gateway status 查看状态，如果没有运行，执行 openclaw gateway start。
  2. 参考方案一第五步，从配置文件中找到Token进行授权。
• WSL2无法操作Windows文件？
  你的Windows磁盘默认被挂载在 /mnt/ 目录下，例如C盘的内容在 /mnt/c/。你可以让OpenClaw直接读写这些路径下的文件。

OpenClaw的配置选项非常灵活，等你上手之后，可以根据需要慢慢探索添加更多技能（Skills）和通信渠道（Channels）。如果在安装过程中遇到任何报错，直接把错误信息复制给我，我帮你分析解决。