Windows 系统 OpenClaw 完整安装教程

前置环境配置

Node.js 安装
OpenClaw 基于 Node.js 运行。

下载

• 官网下载：Node.js 官网
• 淘宝镜像：npm 淘宝镜像
• 选择 Windows Installer (.msi)，64 位版本
• 

安装

• 双击运行安装程序，全部选择默认选项
• 确保勾选 “Add to PATH”
• 不需要勾选自动安装必要工具
• 
  

验证安装

node -v
# 应显示：v24.14.0（或类似，OpenClaw 要求 Node 版本 >= 22）
npm -v
# 应显示：10.8.3（或类似）

配置 npm 镜像

npm config set registry https://registry.npmmirror.com/
# 验证
npm config get registry
# 应显示：https://registry.npmmirror.com/

Git 安装

• 访问 Git 官方下载地址
• 一路默认安装即可
  

---

获取大模型 API Key

Qwen（百练大模型）

1. 进入 百练大模型官网
2. 注册后免费赠送 1000w token
3. 完成注册认证后，在 API Key 管理中新建 API Key
   

Kimi
1、进入 Kimi 官网
2、注册后完成个人认证

3、在 API Key 管理中新建 API Key

智谱 GLM（可选）
1、进入 智谱官网
2、注册账号并完成实名认证
3、保存 API Key

---

OpenClaw 安装

以管理员身份打开 CMD

• 方式一：

  • 按下 Win + R
  • 输入 cmd
  • 同时按下 Ctrl + Shift + Enter
  • 确认 UAC 提示

• 方式二：

  • 搜索栏输入 cmd，右键选择“以管理员身份运行”
    

安装 OpenClaw

npm install -g openclaw@latest
# 验证安装
openclaw --version
# 应显示版本号，如：2026.2.26

常见错误

• 错误：npm error syscall spawn git

  • 解决方案：安装 Git
    

• 错误：npm error code 128

  • 解决方案：

    git config --global url."https://github.com/".insteadOf git@github.com:
    git config --global url."https://".insteadOf git://
    npm cache clean --force
    # 再次尝试安装
    npm install -g openclaw@latest
    

---

新手引导流程

完成引导流程

openclaw onboard --install-daemon

• 风险提示选择 yes

• 引导模式选择 Quickstart

• 模型供应商选择 Moonshot AI

• 验证方式选择 Kimi API key(.cn)

• 提供 API Key 的方式选择 Paste

• 选择默认模型 kimi-k2.5
  

• 跳过交互频道、Skills、以及hooks 配置
  

• 选择交互窗口 TUI
  

验证安装

• 输入测试消息“你好”，成功回复后按 Ctrl + C 退出
  

查看服务状态

openclaw status
# 显示 `reachable` 表示服务已启动

在这里插入图片描述

访问 Web UI 面板

• 浏览器输入：http://127.0.0.1:18789/Dashboard
  

• 授权 Dashboard：

  openclaw dashboard
  

• 复制带 token 的 URL 到浏览器打开
  

---

接入频道（钉钉）

安装钉钉插件

1. 下载插件：openclaw-channel-dingtalk
   
2. 解压后进入项目根目录
3. 安装依赖：

   npm install
   

4. 以软连接模式安装：

   openclaw plugins install -l .
   

钉钉配置
5. 进入 钉钉开发者平台

6. 创建应用并添加机器人能力
   
   配置应用描述
   

添加机器人
在应用开发的左侧导航栏中，点击「添加应用能力」，然后点击添加「机器人」。

7. 确保消息接收模式为 stream
   

8. 发布应用
   

9. 获取凭证：

• Client ID (AppKey)
• Client Secret (AppSecret)
• Robot Code（与 Client ID 相同）
• Agent ID
• Corp ID
  
  

OpenClaw 服务配置
编辑 openclaw.json（默认路径：C:\Users\用户名\.openclaw\openclaw.json），添加 channels 配置：

"channels": {
  "dingtalk": {
    "enabled": true,
    "clientId": "钉钉的 client id",
    "clientSecret": "钉钉的 client secret",
    "robotCode": "钉钉的 client id",
    "corpId": "你的钉钉 corpId",
    "agentId": "你的钉钉 Agent ID",
    "dmPolicy": "open",
    "groupPolicy": "open",
    "messageType": "markdown",
    "debug": false
  }
}

重启服务

openclaw gateway restart

多端同步

• 在本地网页中查看钉钉的聊天记录