Harness 与 Agent 工程 · AI研发与测试工程 · 2026-03-09

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

想在Windows上轻松部署OpenClaw?跟着这篇教程,20分钟就能搞定!

核心内容:

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

都说在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. 前置准备


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 等)。

第三步:配置模型详情

选 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,配置如下:

配置项 值
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 在飞书开放平台创建应用

  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", "…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/Openclaw/2026030979352.html