分步向导 · 先复制执行再下一步
点击「创建企业自建应用」,填写:
在「凭证与基础信息」页面复制:
App ID (cli_xxx)App Secret进入「权限管理」,点击「批量导入」,粘贴以下 JSON:
进入「应用能力」→「机器人」,开启机器人能力
勾选后才能进入下一步
点击下方按钮,复制提示词发给 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
```
勾选后才能进入下一步
在飞书开放平台,进入你的应用 → 「事件与回调」
选择「使用长连接接收事件」(WebSocket 模式)
💡 不需要公网 URL,OpenClaw 自动处理连接
点击「添加事件」,搜索并添加:
im.message.receive_v1
(接收消息 - 必须)
im.message.message_read_v1
(消息已读 - 可选)
完成事件配置后,还需要发布机器人才能使用:
点击「创建版本」
填写应用版本号(如 1.0.0)和更新说明
版本号格式:主版本.次版本.修订号(如 1.0.0)
勾选后才能进入下一步
在飞书中找到你的机器人,发送任意消息
例如:你好、你好啊、测试等
在飞书中找到机器人回复的消息,复制并粘贴到下方框中:
飞书机器人已成功接入 OpenClaw
现在可以在飞书中和 AI 助手对话了!
/reset 重置对话/status 查看状态/model 切换模型