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

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

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

1. 前置准备

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

2. 安装 Node.js

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

打开 Node.js 官网:https://nodejs.org/
下载 Windows 安装程序（.msi），当前 LTS 版本即可（v22+）
双击运行安装包，一路「下一步」完成安装
打开 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 后会依次问你：

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

第四步：配置频道

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

第五步：安装 Gateway 服务

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

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

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

配置项	值
Endpoint compatibility	OpenAI-compatible
Model ID	`deepseek-chat` （V3）或 `deepseek-reasoner`（R1）
Base URL	`https://api.deepseek.com`
API Key	在 platform.deepseek.com 获取

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

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

6. 配置飞书机器人

6.1 安装飞书插件

openclaw plugins install @openclaw/feishu

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

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

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

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

{  "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"    ]  }}

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

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

6.3 在 OpenClaw 中配置飞书

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

openclaw channels add

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

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

编辑 C:Users你的用户名.openclawopenclaw.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。

设置开机自启动：

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

9. Web 管理界面

Gateway 启动后，浏览器打开：

http://127.0.0.1:18789

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

10. 安全建议

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

定期安全审计：

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.openclawextensionsfeishu"

然后重启 Gateway：openclaw gateway restart

飞书机器人不回复

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

飞书 App ID 和 App Secret 填反了

编辑配置文件修正：

notepad "$env:USERPROFILE.openclawopenclaw.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 的所有痕迹就清理干净了。

你学废了吗？

{{userData.name}}已认证

目录