都说在Windows上部署OpenClaw有点小复杂,今天特意试了一下,也不算难呀,全程都是Kiro(一款AI编程工具,)帮我安装的,我就发了一个如下的指令,20分钟不到就搞定了。
本文也是用Kiro总结的,手把手教你在 Windows 上部署。
目录
- 前置准备
- 安装 Node.js
- 安装 OpenClaw
- 运行初始化向导
- 配置 AI 模型(以 DeepSeek 为例)
- 配置飞书机器人
- 启动与管理
- 后台运行(关掉终端不停机)
- Web 管理界面
- 安全建议
- 常见问题
- 卸载 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 或更高版本。
- 打开 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\你的用户名\.openclaw\openclaw.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", "…— 以上为试看内容(约 40%),开通会员后阅读全文 —