OpenClaw 部署 + 飞书机器人对接教程（完整配置）

本文基于 OpenClaw 官方文档与实践示例整理，包含在 Windows WSL2 / Linux 环境下 使用 npm/pnpm 安装 OpenClaw，并完成飞书消息通道集成配置。

1️⃣ 环境准备

确保你的系统满足以下条件：

Ubuntu / WSL2（支持 Linux 命令）
Node.js ≥ 18
npm / pnpm 已安装
Git 可用
OpenClaw 安装账户

node -v
npm -v

2️⃣ 安装 OpenClaw

在终端执行：

pnpm install -g openclaw

或使用 npm：

npm install -g openclaw

进入工作目录或全局安装后：

openclaw --version

📌 若提示版本，则安装成功。

3️⃣ 飞书开发者平台准备

访问：open.feishu.cn/app（国内）
注册/登录企业帐号 (OpenClaw)

创建应用

创建企业级应用
填写应用名称 & 查看简介
在 凭证与基础信息 复制：
- App ID
- App Secret

保存下来，后续配置 OpenClaw 时会用到。 (OpenClaw)

4️⃣ 安装 Feishu 渠道插件

OpenClaw 通过插件支持飞书通道：

openclaw plugins install @openclaw/feishu

若通过本地源码管理：

openclaw plugins install ./extensions/feishu

检查插件：

openclaw plugins list

5️⃣ OpenClaw 配置飞书通道

方法 A — 使用 CLI 向导配置（推荐）

openclaw channels add

选择 Feishu / Lark，依次输入：

App ID
App Secret

系统会写入配置文件。 (OpenClaw)

方法 B — 手动编辑配置文件

编辑：

~/.openclaw/openclaw.json

加入：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "botName": "My OpenClaw Bot"
        }
      }
    }
  }
}

dmPolicy: "pairing" 表示初次对话需要配对批准。 (OpenClaw)

6️⃣ 启动 Gateway

OpenClaw 消息通道需要运行 Gateway：

openclaw gateway

查看状态：

openclaw gateway status

查看实时日志：

openclaw logs --follow

7️⃣ 飞书事件订阅 & 发布

在飞书开发者平台：

配置事件订阅

在应用设置中：

选择「事件订阅」
选择 “使用长连接 WebSocket”
添加事件：

im.message.receive_v1

📌 这是必须的事件，否则无法将消息推送到 OpenClaw。 (OpenClaw)

发布应用版本

在版本管理 & 发布：

创建版本
填写信息
发布 & 审核通过

8️⃣ 配对 & 测试

第一次对话时，OpenClaw 会提示：

OpenClaw: access not configured.
Your Feishu user id: ou_xxx
Pairing code: XXXXXXXX
Ask the bot owner to approve with:
openclaw pairing approve feishu XXXXXXXX

在控制台执行：

openclaw pairing approve feishu <PAIRING_CODE>

配对成功后，即可直接在飞书中发送消息让机器人回复。

9️⃣ 常见问题 & 排查

❗ 插件报错

遇到插件依赖错误，有时需要清理缓存：

npm cache clean --force
pnpm install

或检查插件目录手动 npm install 依赖。

✅ 实现效果

配置完成后，在飞书中对机器人发送消息，例如：

你好

机器人会返回由模型生成的回答。

📌 总结

本文整理了：

OpenClaw 环境准备与安装
飞书开发者平台应用创建
安装插件与通道配置
Gateway 启动与日志查看
飞书事件订阅、版本发布
初次配对与消息测试