安装调试过程颇有些繁琐，写点笔记，做个备忘。

安全提醒：

1. OpenClaw 在安装和部署后将获得较高的系统权限，有可能误删用户数据。
2. 如果安装OpenClaw服务器部署在公网环境还可能被黑客攻击。
3. OpenClaw会疯狂的燃烧Tokens，也就是传说中的烧钱 。如果处理复杂任务或碰到特殊情况，OpenClaw有可能很快就会把你的Tokens快速烧光。

安装时主要使用到如下系统、组件与平台服务与文档。

组件与平台说明表格如下：

组件与服务之间的关系：OpenClaw 运行在 Node.js 环境上，通过飞书插件连接飞书平台以收发消息，当收到用户消息（用户手机上的飞书发送的消息）后，OpenClaw 调用 DeepSeek API 生成回答内容，最后通过飞书插件将回答返回给用户手机上的飞书客户端。

Node.js是OpenClaw运行的基础环境，所以需要先安装。截至2026年3月，应该安装Node.js 22及以上的新版本。

1. 访问nodejs.org，下载Windows安装程序(.msi)。
2. 双击安装，要选择 “Add to PATH” (默认是安装的)。
3. 如何验证是否安装成功，打开PowerShell、终端或命令提示符(CMD)，输入命令，确认版本号是否大于等于22。

如何打开PowerShell？

1. 右键点击任务栏上的“开始”按钮（或按 ）。
2. 选择 “PowerShell(管理员)”。注：在Windows 11中选择终端管理员，或者直接使用命令行提示符亦可。
   • 这里并不需要管理员权限，但后面的很多操作需要。
     说明：后面涉及到命令行操作的，使用PowerShell、终端(本质上还是PowerShell)、命令行提示符均可，不再赘述。
     
     
     
     

打开OpenClaw官网，找到Quick Start，发现4种安装方式：

1. One-liner
   一行命令安装，适合小白，不过灵活性不足。
   
   
   
   
2. npm（我们选择的安装方式）：
   Node.js包管理器安装。适合熟悉Node.js生态的开发者。通过npm全局安装后，OpenClaw会作为一个命令行工具常驻系统中，后续使用openclaw命令时无需再次下载，启动速度更快。
   
   
   
   
3. Hackable
   面向希望深度定制、贡献代码或对安全性有极高要求的进阶用户。
   
   
   
   
4. macOS
   macOS上的安装方式。
   
   
   
   

npm安装命令：。注意：一定要以管理员权限启动PowerShell运行。
安装后验证命令：

1. DeepSeek的API Key：形如格式的key(密钥)。
2. base_url:
3. 模型名称或id：或。前者为非思考模式、后者为思考模式。

步骤：

1. 打开DeepSeek官网,点击开放平台;
2. 登录后点击左侧API Key去创建API Keys；
3. 创建你的Key，会生成一个形如（）的key。这时候把他复制下来存在一个文本文件里(如果不现在复制下来，以后就看不到了)，方便后面配置OpenClaw的Model的时候使用。

1. 运行配置向导

2. openclaw onboard 配置步骤一览

注意：新版本的OpenClaw可能还会有多余的步骤，比如让你配置Geimi的API，可以暂时忽略都不要配置。

经过如上操作，如果一切顺利，你就已经在OpenClaw配置好DeepSeek大模型。这时候可能会打开一个OpenClaw的Web页面（地址通常是类似），或者直接打开一个命令行终端。在这个页面或终端窗口你就可以和OpenClaw Bot聊天了。

注意：网址中的token是一个一次性的身份验证令牌，让你无需输入密码即可直接登录控制台。它保证了只有能在你电脑上打开这个链接的人（也就是你自己）才能访问。重启OpenClaw这个token就不能用了。

该步骤的常用命令

• 启动 OpenClaw 网关(gateway)：命令或
• 打开 OpenClaw 网页控制台：命令。注意：如果配置不正确，即使打开了网页也不能正常使用。
• 打开 OpenClaw 终端控制台：命令

3. 如果没有成功怎么办？

尝试使用全部重新配置，或者对某个单项进行配置，比如重新配置Model。

当你在配置时误操作，可按退出。

1. 在飞书开放平台创建飞书应用

打开飞书开放平台，登录后，点击发开着后台，点击创建企业自建应用 → 点击添加应用能力，选择添加机器人。点击网页左侧凭证与基础信息，获得 和 。最后点击“创建版本”进行发布上线。
关键： 必须发布上线（不能是草稿）

2. 安装飞书插件并进行配置

1. 如果前面你没安装飞书插件，可以使用如下命令安装：
   。
   
   
   
   
   
2. 将飞书配置到OpenClaw：
   openclaw config set channels.feishu.appId "你的App ID"
   openclaw config set channels.feishu.appSecret "你的App Secret"
   
   
   
   
   
   
   
   
   
   
   
   
3. 安装、配置后为了让其生效，需重新启动网关：
   
   
   
   
   
   

3. 在飞书开放平台进一步配置事件订阅与权限

1. 配置事件订阅（最关键的一步）：

   打开 飞书开放平台 → 你的应用 → 事件与回调

   订阅方式选择 “使用长连接接收事件”（⚠️ 不是Webhook）。注意：应先把OpenClaw gateway启动好以后再做，要不然不成功。

   最后，添加事件 im.message.receive_v1

2. 设置飞书机器人权限

   打开 飞书开放平台，点击左侧权限管理，然后点击批量导入/导出权限。粘贴如下json字符串，批量赋予权限。主要赋予了基于对话、文件处理、应用管理等权限。

在飞书平台上都设置好以后，一定要点击“创建版本”进行发布上线。

4. 在OpenClaw中进行配对

所有配置都完成后，还需要在 OpenClaw 中执行一次配对操作，才能让你的飞书账号获得使用机器人的权限。

这一步是 OpenClaw 的安全机制——只有经过你（管理员）明确批准的飞书用户，才能和你的 AI 助手对话。

配对步骤：

第一步：在飞书中获取配对码

1. 打开飞书电脑端（手机端也行，但建议电脑端方便复制）
2. 找到你刚才创建并发布的机器人，给它发一条消息（比如“你好”或任意内容）
3. 机器人会自动回复一条消息，其中包含一个 8位大写字母+数字的配对码，例如：

GPT plus 代充 只需 145

第二步：在 OpenClaw 中批准配对

在终端输入

（请将 X379S5M8 替换为你实际收到的配对码）

第三步：确认批准成功

第四步：验证

GPT plus 代充 只需 145

1. 把出错信息粘贴给DeepSeek，问它。
2. 打开或重新进行设置。设置后，重新启动网关。
3. 打开OpenClaw网关(或)访问进行验证。
4. 有的时候根据提示，启动进行检查。
5. 在openclaw中直接问他，让他帮你解决。

总的来说还是要多看出错提示，在出错提示的指导下进行配置。

如何升级OpenClaw？

管理员权限运行命令或,升级完以后。按照如下步骤检查：

1. 运行健康检查（会自动修复可修复的问题）
   
   
   
   
   
   
2. 重启网关服务
   
   
   
   
   
   
3. 查看状态确认一切正常
   
   
   
   
   
   

控制台下配置到一半发现错了，赶紧按中止当前运行。

📌 常用配置项示例

ClawHub命令如下

💡 小贴士：安装 Skill 后，需要重启 OpenClaw 会话（如在 TUI 中输入 重进）才能生效。如果不放心，直接重启整个Gateway。