目录

前言

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

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

安装前应掌握的基本概念

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

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

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

组件 核心作用 官方网站
Node.js JavaScript 运行时环境，为 OpenClaw 提供运行基础 https://nodejs.org/
OpenClaw 开源 AI 网关，负责接收和转发消息、调用大模型、管理插件 https://openclaw.ai/
DeepSeek 大语言模型服务，OpenClaw 通过 API 调用它来生成回答内容 https://platform.deepseek.com/
飞书开放平台 提供飞书应用创建、权限配置、事件订阅等能力，是机器人接入的入口 https://open.feishu.cn/
飞书插件 OpenClaw 的扩展(extension)，负责与飞书开放平台通信，完成消息格式转换和收发 同上

组件与服务之间的关系：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)，输入命令node --version，确认版本号是否大于等于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安装命令：npm install -g openclaw。注意：一定要以管理员权限启动PowerShell运行。
安装后验证命令：openclaw --version

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

此步是为了让你的OpenClaw可以使用DeepSeek作为其后台大模型。
此步需要获得几个关键信息：

  1. DeepSeek的API Key：形如sk-xxx格式的密钥。
  2. base_url:https://api.deepseek.com
  3. 模型名称或id：deepseek-chat或deepseek-reasoner。前者为非思考模式、后者为思考模式。

步骤：

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

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

  1. 运行配置向导

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

  1. openclaw onboard 配置步骤一览
步骤 提示内容 简要说明与配置建议
1. 风险确认(Security warning) 确认你了解运行 AI 助手的潜在风险。 选择 Yes 以继续 。
2. 配置模式(Onboarding mode) 选择 QuickStart (快速开始) 或 Advanced (高级/手动)。 新手或一般使用选 QuickStart 即可 。高级模式可让你对端口、认证等有更多控制权。
3. 模型/认证提供商(Model/auth provider) 选择你想使用的大模型提供商(如DeepSeek)。 此处可以选择 Skip for now 跳过，或者如果有 Custom Provider 选项则选中它(我们这里选择这个) 。
4. 配置模型(model) 在上一步选择了Custom Provider，就可以进行配置。 依次提供：API Base URL：https://api.deepseek.com， Paste API key now：粘贴你刚才的申请的SK开头的API Key，Endpoint compatibility ：OpenAI-compatible，Model ID:填入deepseek-chat。如果提供的信息无误，会返回验证成功信息。
5. 选择消息通道 选择你想要连接的聊天平台，如 Telegram、WhatsApp 等。 因为我们计划安装飞书插件，这里可以选择 Skip for now，稍后再配置 。也可以在这里选择飞书(feishu)，其会自动下载安装飞书插件。注意：如果权限不够，是无法安装成功的。你可以先下载，后面再进行配置。
6. 配置技能(Configure skills now?) 询问是否要启用一些本地实用技能(如文件操作等)。 暂时选择 No
7. 启用钩子(Enable hooks) 允许你在特定系统事件发生时自动执行预先定义的脚本或操作 选择session-memory,当执行 /new 时自动保存会话记忆，简单的说就是希望 AI 在开始新对话时，还能“记得”之前聊过的一些关键信息。注意，请先按空格勾选，再按回车确认选择。
8. 网关服务(Gateway service) 询问是否将 OpenClaw 网关安装为系统服务(支持后台运行和开机自启)。 推荐选择 Install 或 Reinstall 。
9. 孵化机器人(How do you want to hatch your bot?) 询问如何启动你的机器人，通常提供 TUI(终端界面)或 Dashboard(网页界面)选项。 选择 Hatch in TUI 可以在控制台获得更互动的体验，或者之后直接用 openclaw dashboard 命令打开网页控制台 。对于喜欢使用网页形式的交互的选择Open the Web UI

经过如上操作，如果一切顺利，你就已经在OpenClaw配置好DeepSeek大模型。这时候可能会打开一个OpenClaw的Web页面(地址通常是http://127.0.0.1:18789/#token=23ada5d0a9f0dffe865e986a9fc66c79b74ff494a1567079)，或者直接打开一个命令行终端。在这个页面或终端窗口你就可以和OpenClaw Bot聊天了。

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

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

到这里，如果都配置正确，你的OpenClaw Bot(机器人)就已经能调用DeepSeek大模型啦！
你可以用自然语言，对他进行设置、让他操作电脑，甚至可以让他帮你安装飞书插件。

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

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

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

第五步：配置飞书

1. 在飞书开放平台创建飞书应用
打开[飞书开放平台](https://open.feishu.cn/)，登录后，点击**发开着后台**，点击**创建企业自建应用** → 点击**添加应用能力**，选择添加**机器人**。点击网页左侧**凭证与基础信息**，获得 `App ID` 和 `App Secret`。最后点击“创建版本”进行发布上线。
**关键：** 必须发布上线(不能是草稿)
2. 安装飞书插件并进行配置

  1. 如果前面你没安装飞书插件，可以使用如下命令安装：openclaw plugins install @openclaw/feishu。

  2. 将飞书配置到OpenClaw：
    openclaw config set channels.feishu.appId "你的App ID"
    openclaw config set channels.feishu.appSecret "你的App Secret"

  3. 安装、配置后为了让其生效，需重新启动网关：openclaw gateway restart

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

  1. 配置事件订阅(最关键的一步)：

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

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

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

  2. 设置飞书机器人权限

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

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

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

4. 在OpenClaw中进行配对

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

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

配对步骤：

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

  1. 打开飞书电脑端(手机端也行，但建议电脑端方便复制)
  2. 找到你刚才创建并发布的机器人，给它发一条消息(比如“你好”或任意内容)
  3. 机器人会自动回复一条消息，其中包含一个 8位大写字母+数字的配对码，例如：
你的身份验证码是：X379S5M8
请在命令行执行：openclaw pairing approve feishu X379S5M8

第二步：在 OpenClaw 中批准配对

在终端输入openclaw pairing approve feishu X379S5M8

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

第三步：确认批准成功

命令执行成功后，会看到类似以下提示：
`Pairing approved for user ou_xxxxxxxxxxxxxxxxxxxxx`
此时，你的飞书用户 ID 已被添加到允许列表中

第四步：验证

再次在飞书里给机器人发消息，应该能正常收到 AI 回复，不再需要配对码。

安装与配置失败怎么办？如何升级？

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

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

如何升级？

管理员权限运行命令openclaw update或npm install -g openclaw@latest,升级完以后。执行如下命令：

  1. 运行健康检查(会自动修复可修复的问题)openclaw doctor

  2. 重启网关服务openclaw gateway restart

  3. 查看状态确认一切正常openclaw status

🦞 OpenClaw 常用命令速查表

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

💡 最常用的命令

场景 对应命令
刚开始 npm install -g openclaw → openclaw onboard
配飞书 openclaw plugins install @overlink/openclaw-feishu → 配置 App ID/Secret → openclaw gateway restart
改配置 openclaw config
日常用 openclaw gateway start(启动服务) + openclaw onboard(网页控制台) 或openclaw tui(命令行控制台)+ openclaw gateway stop (停止服务)
出问题 openclaw doctor + openclaw logs

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

📦 安装与基础管理

命令 作用 使用场景
npm install -g openclaw 使用 npm 全局安装 OpenClaw 首次安装
openclaw --version 查看 OpenClaw 版本 验证安装是否成功
openclaw update 更新 OpenClaw 到最新版本 需要新功能或修复时
openclaw doctor 运行诊断检查 排查配置问题、验证连通性

🚀 网关服务管理

命令 作用 使用场景
openclaw gateway start 启动网关服务(前台运行) 调试或临时使用
openclaw gateway stop 停止网关服务 需要关闭服务时
openclaw gateway restart 重启网关服务 修改配置后使其生效
openclaw gateway status 查看网关运行状态 检查服务是否正常运行
openclaw gateway install 安装为系统服务(后台运行) 需要开机自启或长期运行
openclaw status 查看整体运行状态(插件、通道等) 快速概览系统状态

⚙️ 配置管理

命令 作用 使用场景
openclaw onboard 运行交互式配置向导 首次配置或重新设置
openclaw config list 列出所有当前配置 查看已设置的配置项
openclaw config get <key> 获取指定配置项的值 如 openclaw config get model.provider
openclaw config set <key> <value> 设置指定配置项的值 手动配置 API Key、App ID 等
openclaw config edit 用编辑器打开配置文件 直接修改配置文件
📌 常用配置项示例
配置项 示例值 作用
model.provider deepseek 设置大模型提供商
model.apiKey sk-xxx 设置 API Key
model.name deepseek-chat 设置默认模型
channels.feishu.appId cli_xxxxx 设置飞书 App ID
channels.feishu.appSecret your-secret 设置飞书 App Secret
channels.feishu.enabled true 启用飞书通道

🔌 插件管理

命令 作用 使用场景
openclaw plugins list 列出所有已安装插件 查看已安装的插件
openclaw plugins install <插件名> 安装插件 如 openclaw plugins install @overlink/openclaw-feishu
openclaw plugins uninstall <插件名> 卸载插件 移除不需要的插件
openclaw plugins update <插件名> 更新指定插件 获取插件新版本

🔐 用户与授权管理

命令 作用 使用场景
openclaw pairing list 查看待处理的配对请求 查看有哪些用户正在申请使用
openclaw pairing approve <渠道> <配对码> 批准用户使用机器人 如 openclaw pairing approve feishu X379S5M8
openclaw pairing revoke <渠道> <用户ID> 撤销已批准的用户权限 禁止某个用户继续使用
openclaw pairing pending 查看待批准的配对请求 同 pairing list

🎛️ 客户端界面

命令 作用 使用场景
openclaw tui 打开终端文本界面(命令行聊天) 习惯命令行、SSH远程连接时
openclaw dashboard 打开网页控制台 需要图形界面管理、查看用量统计

🛠️ 技能与工具管理

命令 作用 使用场景
openclaw skills list 列出所有可用技能 查看已安装的技能
openclaw skills install <技能名> 安装技能 扩展 AI 能力
openclaw tools list 列出所有可用工具 查看 AI 能调用哪些工具

📁 数据与存储

命令 作用 使用场景
openclaw workspace 打开工作区目录 查看日志、记忆文件等
openclaw logs 查看运行日志 排查问题
openclaw reset 重置所有数据(谨慎使用) 完全重新开始
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

ClawBridge 网关日志审计：如何避免 Slack 事件重复处理与权限疲劳

avatar 龙虾开发者社区
cover

从零构建本地AI Agent网关：ClawBridge在沙箱与工具调用中的实战踩坑

avatar 龙虾开发者社区
cover

密钥管理实战：如何避免多模型路由场景下的 API Key 泄露风险

avatar 龙虾开发者社区