Windows 安装 OpenClaw 指南

💡 写给谁看：本指南专为没有技术背景的用户设计，每一步都有详细说明。如果你懂技术，可以跳过基础说明直接看命令。

📋 两种安装方式对比

特性	WSL2（推荐）⭐	原生 Windows
稳定性	✅ 完整兼容	⚠️ 部分功能受限
适合人群	所有人（推荐）	仅高级用户
配置难度	中等（按步骤即可）	简单但功能少
中国渠道插件	✅ 完整支持	⚠️ 可能有问题

🎯 建议选择：除非你有特殊需求，否则请务必选择 WSL2 方案。虽然步骤多一点，但后续使用更稳定，功能更完整。

🚀 方案一：WSL2 安装（强烈推荐）

❓ 什么是 WSL2？WSL2 是 Windows 的一个功能，让你在 Windows 里可以运行 Linux 系统。OpenClaw 在 Linux 环境下运行最稳定。

📌 步骤 1：安装 WSL2 + Ubuntu

1.1 打开 PowerShell（管理员模式）

按 Win 键，输入 powershell
在"Windows PowerShell"上右键 → 选择"以管理员身份运行"
如果弹出确认窗口，点"是"

1.2 执行安装命令

在打开的蓝色窗口中，输入以下命令（可以复制粘贴），然后按回车：

wsl --install

💡 提示：这个命令会自动下载并安装 Ubuntu（一个流行的 Linux 系统）。下载可能需要几分钟，取决于你的网速。

1.3 重启电脑

如果提示需要重启，保存好工作，然后重启电脑。

1.4 首次启动 Ubuntu

重启后，系统会自动打开 Ubuntu 窗口
等待安装完成，然后会让你设置用户名和密码
用户名：随便起（比如 fanwei）
密码：设置一个你记得住的密码（输入时不显示，正常现象）

📌 步骤 2：启用 systemd（重要！）

systemd 是 Linux 的系统管理服务，OpenClaw 需要它才能开机自启动。

2.1 打开 Ubuntu

按 Win 键，输入 ubuntu
点击"Ubuntu"打开
如果提示输入密码，输入刚才设置的密码

2.2 创建配置文件

在 Ubuntu 窗口中，输入以下命令（可以分段复制粘贴）：

# 创建配置文件
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
            

输入密码后，会显示 Permission denied 是正常的，继续下一步。

2.3 重启 WSL

关闭 Ubuntu 窗口，然后在 PowerShell（管理员）中执行：

wsl --shutdown

然后重新打开 Ubuntu。

2.4 验证是否成功

systemctl --user status

如果看到一些服务信息（不是报错），说明成功了。按 Ctrl+C 退出。

📌 步骤 3：安装 Node.js 和 pnpm

Node.js 是一个运行环境，OpenClaw 需要在它上面运行。

# 安装 Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

# 安装 pnpm（包管理工具）
npm install -g pnpm
            

💡 解释：

node --version 会显示类似 v24.x.x
npm --version 会显示类似 10.x.x
如果看到版本号，说明安装成功

📌 步骤 4：安装 OpenClaw

# 克隆代码仓库（下载 OpenClaw）
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖（需要几分钟）
pnpm install

# 构建 UI 界面（第一次需要，后续不用）
pnpm ui:build

# 构建项目
pnpm build

# 启动配置向导
openclaw onboard
            

💡 注意：

pnpm install 会下载很多依赖，可能需要 5-10 分钟
如果网络慢，可以休息一下等它完成
openclaw onboard 会启动交互式配置，跟着提示操作即可

📌 步骤 5：安装 Gateway 服务（开机自启）

# 安装服务
openclaw onboard --install-daemon

# 或者用这个命令也可以
openclaw gateway install

# 查看服务状态
openclaw gateway status
            

✅ 完成！现在 OpenClaw 已经安装好并且会开机自启动了。

📁 OpenClaw 文件结构解析

安装完成后，OpenClaw 会在你的用户目录下创建一个 .openclaw 文件夹。以下是详细的文件结构说明：

~/.openclaw/ # OpenClaw 的主目录 ├── agents/ # AI 助手配置（每个助手一个文件夹） │ ├── main/ # 主助手的工作区 │ ├── daily-agent/ # 日常助手（海绵宝宝） │ ├── game-agent/ # 游戏助手（派大星） │ ├── web-agent/ # 网站助手（蟹老板） │ └── dev-agent/ # 开发助手（珊迪） │ ├── browser/ # 浏览器控制相关 ├── canvas/ # 画布功能（可视化界面） ├── cron/ # 定时任务 ├── logs/ # 日志文件（排查问题用） ├── media/ # 收到的图片/文件 ├── memory/ # AI 记忆存储 ├── skills/ # 技能包（扩展功能） ├── workspace/ # 默认工作区 │ ├── AGENTS.md # 助手角色说明 │ ├── SOUL.md # 助手性格设定 │ ├── TOOLS.md # 工具使用说明 │ ├── MEMORY.md # 长期记忆 │ └── HEARTBEAT.md # 心跳任务配置 │ ├── openclaw.json # ⭐ 主配置文件（最重要） ├── .env # 环境变量（API 密钥等） └── exec-approvals.json # 命令执行授权记录

📌 重要文件说明

🔑 openclaw.json（主配置文件）

位置：~/.openclaw/openclaw.json

作用：这是 OpenClaw 的"大脑"，控制所有功能的行为。

如何编辑：

方式 1（推荐）：使用命令 openclaw config set
方式 2：直接编辑文件（需要小心）
方式 3：访问 http://127.0.0.1:18789 使用网页界面

🔐 .env（环境变量文件）

位置：~/.openclaw/.env

作用：存储敏感信息，如 API 密钥、密码等。

# 示例内容
OPENAI_API_KEY=sk-xxxxxxxxxxxxxx
TELEGRAM_BOT_TOKEN=123:ABCxxxxxx
                

⚠️ 注意：不要把这个文件的内容发给别人，里面包含你的密钥！

🧠 workspace/ 文件夹（工作区）

位置：~/.openclaw/workspace/

作用：每个 AI 助手有自己的"工作区"，包含它的角色设定、记忆、工具等。

AGENTS.md - 定义助手是谁、能做什么
SOUL.md - 定义助手的性格、说话风格
TOOLS.md - 记录可用的工具和命令
MEMORY.md - 长期记忆（你告诉它的重要事情）

⚙️ 配置文件详解（openclaw.json）

配置文件是 OpenClaw 的核心，下面用通俗的语言解释每个部分的作用：

1️⃣ agents - AI 助手配置

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"  # 默认使用的 AI 模型
      },
      "workspace": "~/.openclaw/workspace"  # 工作区位置
    },
    "list": [
      {
        "id": "web-agent",  # 助手 ID
        "workspace": "~/.openclaw/workspaces/workspace-web-agent",
        "identity": {
          "name": "蟹老板 (Mr. Krabs)",  # 助手名字
          "emoji": "🦀"  # 助手图标
        }
      }
    ]
  }
}
                

作用：定义有哪些 AI 助手，每个助手用什么模型、在哪里工作、叫什么名字。

2️⃣ channels - 聊天渠道配置

{
  "channels": {
    "wecom-app": {  # 企业微信应用
      "enabled": true,  # 是否启用
      "webhookPath": "/wecom-app",  # 回调路径
      "token": "ANjbF6k0F1s",  # 验证令牌
      "corpId": "ww71268a0f4ab5a2c4",  # 企业 ID
      "agentId": 1000002  # 应用 ID
    }
  }
}
                

作用：配置 OpenClaw 可以接收哪些地方的消息（企业微信、钉钉、QQ 等）。

3️⃣ models - AI 模型配置

{
  "models": {
    "providers": {
      "bailian": {  # 阿里云百炼
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxx",  # API 密钥
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus"
          }
        ]
      }
    }
  }
}
                

作用：配置可以使用哪些 AI 模型（通义千问、GLM、Kimi 等），以及对应的 API 密钥。

4️⃣ bindings - 消息路由配置

{
  "bindings": [
    {
      "agentId": "web-agent",  # 哪个助手处理
      "match": {
        "channel": "wecom-app",  # 来自哪个渠道
        "accountId": "web"  # 哪个账号
      }
    }
  ]
}
                

作用：定义"谁的消息由哪个助手处理"。比如企业微信"web"账号的消息交给"蟹老板"处理。

5️⃣ gateway - 网关配置

{
  "gateway": {
    "port": 18789,  # 服务端口
    "mode": "local",  # 运行模式
    "auth": {
      "mode": "token",  # 认证方式
      "token": "xxxxxx"  # 访问令牌
    }
  }
}
                

作用：配置 OpenClaw 服务的网络设置，包括端口、认证等。

6️⃣ plugins - 插件配置

{
  "plugins": {
    "enabled": true,
    "installs": {
      "channels": {
        "source": "npm",
        "spec": "@openclaw-china/channels"  # OpenClaw 中国插件
      }
    }
  }
}
                

作用：配置已安装的插件，比如中国渠道插件（支持企业微信、钉钉等）。

🔧 常用命令速查

Gateway 管理

# 启动 Gateway
openclaw gateway run

# 安装 Gateway 服务（开机自启）
openclaw gateway install

# 查看服务状态
openclaw gateway status

# 重启 Gateway
openclaw gateway restart

# 停止 Gateway
openclaw gateway stop

# 查看日志
openclaw logs
            

配置管理

# 启动配置向导
openclaw onboard

# 查看配置
openclaw config get

# 修改单个配置项
openclaw config set channels.wecom-app.enabled true

# 诊断问题
openclaw doctor

# 自动修复问题
openclaw doctor --fix
            

插件管理

# 列出已安装插件
openclaw plugins list

# 安装插件
openclaw plugins install @openclaw-china/channels

# 更新插件
openclaw plugins update channels

# 卸载插件
openclaw plugins uninstall @openclaw-china/channels
            

会话管理

# 查看活跃会话
openclaw sessions list

# 重置会话（清空记忆）
openclaw reset

# 查看会话状态
openclaw status
            

🇨🇳 安装 OpenClaw China 插件（中国渠道）

OpenClaw China 提供对中国 IM 平台的支持，包括企业微信、钉钉、QQ、飞书、微信公众号等。

步骤 1：安装插件

# 方式 1：安装统一包（包含所有渠道）
openclaw plugins install @openclaw-china/channels

# 方式 2：安装单个渠道
openclaw plugins install @openclaw-china/wecom-app  # 企业微信
openclaw plugins install @openclaw-china/dingtalk   # 钉钉
openclaw plugins install @openclaw-china/qqbot      # QQ
            

步骤 2：运行配置向导

openclaw china setup

按照向导提示，一步步输入你的企业微信/钉钉等配置信息。

⚠️ Windows 用户注意：如果遇到 spawn npm ENOENT 错误，请使用源码安装：

git clone https://github.com/BytePioneer-AI/openclaw-china.git
cd openclaw-china
pnpm install
pnpm build
openclaw plugins install -l ./packages/channels
openclaw china setup
                

❓ 常见问题解答

Q1: 安装过程中遇到"权限拒绝"怎么办？

💡 解决：在命令前加 sudo，然后输入密码。比如：sudo apt-get install nodejs

Q2: 下载速度很慢怎么办？

💡 解决：可以配置国内镜像源。编辑 ~/.npmrc 文件，添加：registry=https://registry.npmmirror.com

Q3: 如何知道 OpenClaw 是否在运行？

💡 解决：执行 openclaw gateway status，如果显示 running 说明在运行。

Q4: 如何修改 AI 助手的性格？

💡 解决：编辑对应工作区的 SOUL.md 文件。比如修改蟹老板的性格：~/.openclaw/workspaces/workspace-web-agent/SOUL.md

Q5: 如何查看 AI 的记忆？

💡 解决：查看 MEMORY.md 文件。路径：~/.openclaw/workspaces/workspace-web-agent/MEMORY.md

Q6: 配置改错了怎么办？

💡 解决：OpenClaw 会自动备份配置文件。可以恢复备份：cp ~/.openclaw/openclaw.json.bak ~/.openclaw/openclaw.json

Q7: 如何完全卸载 OpenClaw？

💡 解决：

停止服务：openclaw gateway stop
卸载服务：openclaw gateway uninstall
删除目录：rm -rf ~/.openclaw

🔗 相关资源

OpenClaw 官方文档：docs.openclaw.ai
OpenClaw 中国插件：GitHub 仓库
WSL2 官方安装指南：Microsoft 文档
OpenClaw 主仓库：GitHub
Discord 社区：加入讨论
本文档源码：FunWay 文档中心

🪟 Windows 安装 OpenClaw 指南