✓ 已复制!
山姆哥
👋 我是山姆哥
交给 OpenClaw 吧!提示词完成一切!小白上手不涉及命令和程序玩转 OpenClaw,安全更省心!

🚀 飞书接入 OpenClaw

分步向导 · 先复制执行再下一步

1
2
3
4
创建应用 配置凭证 事件与回调 配对授权

📋 步骤1:创建飞书应用

🔗 打开飞书开放平台

访问 open.feishu.cn/app,使用飞书账号登录

登录后,点击右上方「开发者后台」

📝 创建企业自建应用

点击「创建企业自建应用」,填写:

  • 应用名称
  • 应用描述
  • 应用图标(可选)

🔑 获取凭证

在「凭证与基础信息」页面复制:

App ID (cli_xxx)
App Secret
⚠️ 重要:妥善保管 App Secret,不要分享给他人!

🔓 开启权限

进入「权限管理」,点击「批量导入」,粘贴以下 JSON:

{"scopes":{"tenant":["im:message","im:message:send_as_bot","im:message:readonly","im:message.p2p_msg:readonly","im:message.group_at_msg:readonly","im:message.group_msg","im:chat","im:chat.members:bot_access","im:resource","contact:user.employee_id:readonly"],"user":["im:chat.access_event.bot_p2p_chat:read"]}}

🤖 启用机器人能力

进入「应用能力」→「机器人」,开启机器人能力

勾选后才能进入下一步

⚙️ 步骤2:配置 OpenClaw 飞书凭证 & 绑定智能体

🔑 填入你的飞书凭证

⚠️ 账号 ID 勿填大写,系统无法识别。

🔍 不知道自己有哪些智能体?

点击下方按钮,复制提示词发给 OpenClaw,获取你的智能体列表:

点击解析按钮,从列表中选择一个

🤖 填入智能体信息

📋 生成的配置提示词

包含凭证配置 + 智能体绑定,点击复制发给 OpenClaw 执行:

# 任务:帮我配置飞书渠道 + 绑定智能体

## 我已有的信息
- 飞书 App ID: cli_xxx
- 飞书 App Secret: xxx
- 飞书机器人账号 ID: feishu-robot
- 智能体 ID: my-agent
- 智能体名称: 我的AI助手
- Workspace: /Users/用户名/.openclaw/workspace-myagent

## 关键
- 先检查是否已安装飞书最新插件:
```
npx -y @larksuite/openclaw-lark@2026.3.29 install --tools-version 1.0.33
```
- 若执行命令行出错,可在命令前增加 `sudo` 后重新执行。
- 飞书渠道的 dmPolicy 必须设为 `pairing`,否则用户发消息时,机器人不会返回 8 位 pairing 码。
- dmPolicy 有三种模式:
  - `allowlist`:只允许白名单用户,需要配对码授权。
  - `pairing`:未授权用户发消息时,机器人回复 pairing 码,批准后放行。
  - `open`:允许任何人直接发消息,无需配对,仅建议测试时使用。
- 设置完 dmPolicy 后,必须重启 gateway,配置才会生效。

## 请执行以下命令

### 第一步:配置飞书渠道
在终端运行以下命令配置飞书渠道:
```
openclaw channels add
```

选择 Feishu,然后输入:
- App ID: cli_xxx
- App Secret: xxx
- dmPolicy: pairing

### 第二步:绑定智能体
在 openclaw.json 中添加以下配置:

#### 1. 在 agents.list 中添加智能体(如不存在):
```json
{
  "id": "my-agent",
  "name": "我的AI助手",
  "workspace": "/Users/用户名/.openclaw/workspace-myagent"
}
```

#### 2. 在 bindings 中添加绑定:
```json
{
  "bindings": [
    {
      "agentId": "my-agent",
      "match": {
        "channel": "feishu",
        "accountId": "feishu-robot"
      }
    }
  ]
}
```

### 第三步:重启网关
```
openclaw gateway restart
```
⚠️ 关键:必须先完成此步骤(凭证配置 + 智能体绑定 + restart),才能进入步骤3配置事件与回调!

勾选后才能进入下一步

📡 步骤3:配置飞书事件与回调 & 发布机器人

⚠️ 前置条件:必须先完成步骤2(配置凭证、绑定智能体并重启网关),才能配置事件与回调!

🌐 进入事件与回调页面

在飞书开放平台,进入你的应用 → 「事件与回调」

🔗 选择长连接模式

选择「使用长连接接收事件」(WebSocket 模式)

💡 不需要公网 URL,OpenClaw 自动处理连接

➕ 添加事件

点击「添加事件」,搜索并添加:

im.message.receive_v1 (接收消息 - 必须)
im.message.message_read_v1 (消息已读 - 可选)

🚀 发布机器人

完成事件配置后,还需要发布机器人才能使用:

1

点击「创建版本」

2

填写应用版本号(如 1.0.0)和更新说明

版本号格式:主版本.次版本.修订号(如 1.0.0)

勾选后才能进入下一步

🔐 步骤4:配对授权

💬 发送消息给机器人

在飞书中找到你的机器人,发送任意消息

例如:你好、你好啊、测试等

🔑 提取配对码

在飞书中找到机器人回复的消息,复制并粘贴到下方框中:

📋 粘贴机器人回复

自动识别配对码格式
🎉

配置完成!

飞书机器人已成功接入 OpenClaw
现在可以在飞书中和 AI 助手对话了!

📌 后续提示

  • 发送 /reset 重置对话
  • 发送 /status 查看状态
  • 发送 /model 切换模型