最近跟风，研究了一下OpenClaw的安装与使用。花费了几天时间折腾，终于搭建将这个AI助理搭起来了。
现在已经可以通过飞信发送消息给电脑上的Openclaw，让其干活了。这边应该有一截图

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

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

操作系统：Windows 10、PowerShell
安装组件：Node.js(22及以后版本)、OpenClaw、飞书插件。
平台服务：飞书开放平台、DeepSeek大模型API开放平台。
官方文档：OpenClaw官方中文文档

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

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

第一步：安装Node.js

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

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

如何打开PowerShell(命令行提示符CMD亦可)：

1. 右键点击任务栏上的“开始”按钮(或按 Win + X)
2. 选择 “Windows PowerShell(管理员)”。
   • 这里并不需要管理员权限，但后面的很多操作需要。

第二步：安装OpenClaw(使用npm)

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

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

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

第三步：申请DeepSeek大模型的Key

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

步骤：

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

第四步：配置OpenClaw(使用大模型)

1. 运行配置向导

在管理员权限下PowerShell中执行以下命令，进入交互式配置界面：

2. openclaw onboard 配置步骤一览

经过如上操作，如果一切顺利，你就已经在OpenClaw配置好DeepSeek大模型。这时候可能会打开一个OpenClaw的Web页面(地址通常是http://127.0.0.1:18789/#token=23ada5d0a9f0dffe865e986a9fc66c79b74ff494a)，或者直接打开一个命令行终端。在这个页面或终端窗口你就可以和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位大写字母+数字的配对码，例如：

第二步：在 OpenClaw 中批准配对

在终端输入

(请将 X379S5M8 替换为你实际收到的配对码)

第三步：确认批准成功

第四步：验证

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

总的来说还是要多看出错提示。

如何升级？

管理员权限运行命令或,升级完以后。执行如下命令：

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

OpenClaw命令众多，先记常用的吧。如下命令并未一一验证。

💡 最常用的命令

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

📦 安装与基础管理

🚀 网关服务管理

⚙️ 配置管理

📌 常用配置项示例

🔌 插件管理

🔐 用户与授权管理

🎛️ 客户端界面

🛠️ 技能与工具管理

📁 数据与存储