手把手教你在 Windows 上部署自己的小龙虾！很丝滑~

推荐语

想在Windows上轻松部署OpenClaw？跟着这篇教程，20分钟就能搞定！

核心内容：
1. 详细的前置准备与Node.js安装指南
2. OpenClaw的安装与初始化配置步骤
3. AI模型配置与飞书机器人连接方法

杨芳贤

53AI创始人/腾讯云(TVP)最具价值专家

都说在Windows上部署OpenClaw有点小复杂，今天特意试了一下，也不算难呀，全程都是Kiro（一款AI编程工具，）帮我安装的，我就发了一个如下的指令，20分钟不到就搞定了。

本文也是用Kiro总结的，手把手教你在 Windows 上部署。

目录

1. 前置准备
2. 安装 Node.js
3. 安装 OpenClaw
4. 运行初始化向导
5. 配置 AI 模型（以 DeepSeek 为例）
6. 配置飞书机器人
7. 启动与管理
8. 后台运行（关掉终端不停机）
9. Web 管理界面
10. 安全建议
11. 常见问题
12. 卸载 OpenClaw

1. 前置准备

• Windows 10 或 Windows 11
• 能上网
• 一个 AI 模型的 API Key（如 DeepSeek、OpenAI、Claude 等）
• 我用的是DeepSeek:https://platform.deepseek.com/usage
• 如果要连飞书：需要飞书开放平台的企业自建应用权限

2. 安装 Node.js

OpenClaw 需要 Node.js 22 或更高版本。

1. 打开 Node.js 官网:https://nodejs.org/
2. 下载 Windows 安装程序（.msi），当前 LTS 版本即可（v22+）
3. 双击运行安装包，一路「下一步」完成安装
4. 打开 PowerShell命令框，验证安装：

node --version   # 应显示 v22.x.x 或更高npm --version    # 应显示 10.x.x 或更高

如果 npm 报错「禁止运行脚本」

运行以下命令解除限制：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

3. 安装 OpenClaw

打开命令框输入下面的指令

npm install -g openclaw@latest

安装完成后验证：

openclaw --version   # 应显示版本号，如 2026.3.2

4. 运行初始化向导

openclaw onboard --install-daemon

向导会依次引导你完成以下配置：

第一步：安全声明确认

会显示一段安全说明，告诉你 OpenClaw 默认是个人使用的，多用户场景需要额外加固。

选择 Yes 继续。

第二步：选择模型提供商

会列出一长串提供商（OpenAI、Google、Qwen、MiniMax 等）。

• 如果你用 DeepSeek、或其他兼容 OpenAI 格式的国内模型 → 选 Custom Provider
• 如果你直接用 OpenAI → 选 OpenAI
• 如果你用 Claude → 选 Anthropic

第三步：配置模型详情

选 Custom Provider 后会依次问你：

1. Endpoint compatibility → 选 OpenAI-compatible
2. Model ID → 输入模型名称（如 deepseek-chat）
3. Base URL → 选 Change base URL，输入 API 地址
4. API Key → 输入你的 API Key
5. Model alias → 可选，给模型起个简称（如 deepseek），也可以留空跳过

第四步：配置频道

选择你要连接的聊天平台（飞书、Telegram、Discord 等），按提示输入对应的凭证。也可以先跳过，后面再配。

第五步：安装 Gateway 服务

向导最后会尝试安装 Gateway 后台服务。如果提示需要管理员权限，可以先跳过，后面手动安装。

5. 配置 AI 模型（以 DeepSeek 为例）

如果你在向导里选了 Custom Provider，配置如下：

配置完成后，也可以直接编辑配置文件 C:\Users\你的用户名\.openclaw\openclaw.json：

{  "Agent": {    "model": "custom-api-deepseek-com/deepseek-chat"  }}

6. 配置飞书机器人

6.1 安装飞书插件

openclaw plugins install @openclaw/feishu

6.2 在飞书开放平台创建应用

1. 打开 飞书开放平台，登录：https://open.feishu.cn/app
2. 点击「创建企业自建应用」，填写应用名称和描述
3. 在「凭证与基础信息」页面，复制 App ID（格式 cli_xxx）和 App Secret

⚠️ 注意区分：App ID 是 cli_ 开头的短字符串，App Secret 是一串更长的随机字符。别填反了！

1. 在「权限管理」页面，点击「批量导入」，粘贴以下权限：

{  "scopes": {    "tenant": [      "im:message",      "im:message.p2p_msg:readonly",      "im:message.group_at_msg:readonly",      "im:message:readonly",      "im:message:send_as_bot",      "im:resource",      "im:chat.members:bot_access",      "im:chat.access_event.bot_p2p_chat:read"    ],    "user": [      "im:chat.access_event.bot_p2p_chat:read"    ]  }}

1. 在「应用能力 > 机器人」中，启用机器人能力，设置机器人名称
2. 在「事件订阅」中：

• 选择「使用长连接接收事件（WebSocket）」
• 添加事件：im.message.receive_v1
• 在「版本管理与发布」中创建版本，提交审核并发布

6.3 在 OpenClaw 中配置飞书

方式一：用命令行配置（推荐）

openclaw channels add

选择 Feishu，输入 App ID 和 App Secret。

方式二：直接编辑配置文件

编辑 C:\Users\你的用户名\.openclaw\openclaw.json：

{  "channels": {    "feishu": {      "enabled": true,      "dmPolicy": "pairing",      "accounts": {        "main": {          "appId": "cli_你的AppID",          "appSecret": "你的AppSecret",          "botName": "我的AI助手"        }      }    }  }}

6.4 配对授权

配置完成并启动 Gateway 后，在飞书里给机器人发一条消息，机器人会回复一个配对码，例如：

Pairing code: 58JZKNP4

打开一个新的 PowerShell 窗口（别关运行 Gateway 的那个），运行：

openclaw pairing approve feishu 58JZKNP4

批准后就可以正常聊天了。

---

7. 启动与管理

前台启动（能看到日志）

openclaw gateway

按 Ctrl+C 停止。

常用命令

命令	说明
openclaw gateway	前台启动 Gateway
openclaw gateway status	查看运行状态
openclaw gateway restart	重启 Gateway
openclaw gateway stop	停止 Gateway
openclaw logs --follow	实时查看日志
openclaw doctor	诊断检查
openclaw channels add	添加新频道
openclaw pairing list feishu	查看待批准的配对请求
openclaw pairing approve feishu <CODE>	批准配对

---

8. 后台运行（关掉终端不停机）

方式一：安装系统服务（会弹窗口）

用管理员身份打开 PowerShell（右键 PowerShell → 以管理员身份运行），执行：

openclaw gateway install

启动服务：

openclaw gateway start

⚠️ 注意：Windows 上这种方式会弹出一个命令窗口，最小化即可，关掉窗口 Gateway 会停止。

方式二：VBScript 隐藏窗口启动（推荐）

创建一个文件 start-openclaw.vbs，内容如下：

Set WshShell = CreateObject("WScript.Shell")WshShell.Run "openclaw gateway", 0, False

双击这个文件就能无窗口启动 OpenClaw。

设置开机自启动：

1. 按 Win + R，输入 shell:startup，回车打开启动文件夹
2. 把 start-openclaw.vbs 文件复制或创建快捷方式到这个文件夹里
3. 以后每次开机 OpenClaw 就会自动在后台启动

---

9. Web 管理界面

Gateway 启动后，浏览器打开：

http://127.0.0.1:18789

这是 OpenClaw 的 Control UI，可以查看状态、在线聊天、管理配置。









---

10. 安全建议

1. 保持配对模式 — 默认 dmPolicy: "pairing" 已开启，只有你批准的人才能和机器人对话
2. 不要暴露到公网 — Gateway 默认绑定 127.0.0.1（仅本机访问），不要改成 0.0.0.0
3. 保护配置文件 — C:\Users\你的用户名\.openclaw\openclaw.json 里有 API Key 和 App Secret，不要分享
4. 定期安全审计：

   openclaw security audit --deepopenclaw security audit --fix

   
   
• 
  
• 
  
• 运行诊断：

  openclaw doctor

• 
  
• 
  
• 飞书群聊谨慎配置 — 不要同时设置 groupPolicy: "open" 和 requireMention: false，否则群里所有消息都会触发机器人

---

11. 常见问题

npm 安装时报错「Permission denied (publickey)」

Git 没配置 SSH Key，运行以下命令让 Git 走 HTTPS：

git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"git config --global url."https://github.com/".insteadOf "git@github.com:"

然后重新运行 npm install -g openclaw@latest。

npm 报错「禁止运行脚本」

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

飞书插件重复警告（duplicate plugin id detected）

删除多余的插件目录：

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw\extensions\feishu"

然后重启 Gateway：openclaw gateway restart

飞书机器人不回复

1. 确认 Gateway 正在运行：openclaw gateway status
2. 确认飞书应用已发布并审批通过
3. 确认事件订阅已添加 im.message.receive_v1
4. 确认已启用「使用长连接接收事件」
5. 确认已完成配对：openclaw pairing approve feishu <CODE>
6. 查看日志排查：openclaw logs --follow

飞书 App ID 和 App Secret 填反了

编辑配置文件修正：

notepad "$env:USERPROFILE\.openclaw\openclaw.json"

找到 channels.feishu.accounts.main，修改 appId 和 appSecret，保存后重启：

openclaw gateway restart

Gateway 服务安装提示需要管理员权限

右键 PowerShell → 以管理员身份运行，再执行 openclaw gateway install。

关掉终端后机器人停了

参考第 8 节「后台运行」，使用 VBScript 方式启动。

---

12. 卸载 OpenClaw

停止服务

openclaw gateway stop

卸载全局包

npm uninstall -g openclaw

删除配置和数据

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

删除计划任务（如果安装了服务）

以管理员身份运行 PowerShell：

schtasks /Delete /TN "OpenClaw Gateway" /F

卸载完成后，OpenClaw 的所有痕迹就清理干净了。

你学废了吗？