OpenClaw 接入飞书流程
# 前言
OpenClaw 内置飞书（Feishu/Lark）支持，可以通过飞书机器人接入 AI 助手。本文记录完整的配置流程，包括单个机器人配置和多机器人（多 Agent）配置。
# 前置条件
- 已安装并配置好 OpenClaw
- 有飞书账号，并能访问飞书开放平台
# 第一步：创建飞书应用
# 1. 访问飞书开放平台
访问 飞书开放平台 (opens new window)，使用飞书账号登录。
如果是 Lark 国际版，使用 https://open.larksuite.com/app
# 2. 创建企业自建应用
- 点击「创建企业自建应用」
- 填写应用名称（如「墨隐助手」）
- 选择应用图标
- 创建完成
# 3. 获取应用凭证
在「凭证与基础信息」页面，复制：
- App ID（格式：
cli_xxx） - App Secret
⚠️ 请妥善保管 App Secret，不要泄露。
# 4. 配置应用权限
在「权限管理」页面，点击「批量导入」，粘贴以下 JSON：
{
"scopes": {
"tenant": [
"im:chat",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"im:resource"
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
这是精简版权限，足够基本的聊天功能使用。
# 5. 启用机器人能力
在「应用能力」→「机器人」页面，开启机器人能力。
# 6. 配置事件订阅
在「事件订阅」页面：
- 选择「使用长连接接收事件」（WebSocket 模式，无需公网 IP）
- 添加事件：
im.message.receive_v1
⚠️ 注意：需要先启动 OpenClaw Gateway，否则长连接设置会失败。
# 7. 发布应用
在「版本管理与发布」页面：
- 创建版本
- 发布应用
- 等待审批（企业自建应用通常自动通过）
# 第二步：配置 OpenClaw
# 方式一：命令行向导
openclaw channels add
# 选择 Feishu，输入 App ID 和 App Secret
1
2
2
# 方式二：手动编辑配置文件
编辑 ~/.openclaw/openclaw.json，添加飞书渠道配置：
{
"channels": {
"feishu": {
"enabled": true,
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "your-app-secret"
}
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 添加路由绑定
{
"bindings": [
{
"agentId": "main",
"match": {
"channel": "feishu",
"accountId": "main"
}
}
]
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# 第三步：启动并配对
# 1. 重启 Gateway
openclaw gateway restart
1
# 2. 发送消息获取配对码
在飞书中给机器人发送消息，机器人会返回一个配对码。
# 3. 批准配对
openclaw pairing approve feishu <配对码>
1
批准后即可正常对话。
# 多机器人配置（多 Agent）
如果你有多个 Agent（如墨隐、墨汐），可以为每个 Agent 配置独立的飞书机器人。
# 1. 创建多个飞书应用
在飞书开放平台创建多个企业自建应用，分别获取 App ID 和 App Secret。
# 2. 配置多个账号
{
"channels": {
"feishu": {
"enabled": true,
"accounts": {
"main": {
"appId": "cli_moyin_xxx",
"appSecret": "moyin-secret"
},
"moxi_bot": {
"appId": "cli_moxi_xxx",
"appSecret": "moxi-secret"
},
"default": {
"dmPolicy": "pairing",
"groupPolicy": "open"
}
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 3. 配置路由绑定
{
"bindings": [
{
"agentId": "main",
"match": {
"channel": "feishu",
"accountId": "main"
}
},
{
"agentId": "moxi",
"match": {
"channel": "feishu",
"accountId": "moxi_bot"
}
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 4. 重启并配对
重启 Gateway 后，分别给两个机器人发消息，获取配对码并批准：
# 墨隐配对
openclaw pairing approve feishu CODE1
# 墨汐配对
openclaw pairing approve feishu CODE2
1
2
3
4
5
2
3
4
5
# 访问控制
# 私聊策略（dmPolicy）
| 值 | 说明 |
|---|---|
pairing | 默认。未知用户收到配对码，管理员批准后才能对话 |
allowlist | 仅 allowFrom 列表中的用户可对话 |
open | 允许所有人对话 |
disabled | 完全禁止私聊 |
# 群组策略（groupPolicy）
| 值 | 说明 |
|---|---|
open | 允许所有群组 |
allowlist | 仅 groupAllowFrom 中的群组 |
disabled | 禁用群组消息 |
# 白名单配置示例
{
"channels": {
"feishu": {
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "xxx",
"dmPolicy": "allowlist",
"allowFrom": ["ou_user1", "ou_user2"],
"groupPolicy": "allowlist",
"groupAllowFrom": ["oc_group1"],
"groups": {
"oc_group1": {
"requireMention": true,
"allowFrom": ["ou_user1", "ou_user2"]
}
}
}
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 常见问题
# 机器人不响应消息
- 检查 Gateway 是否运行：
openclaw gateway status - 检查事件订阅是否配置正确
- 检查应用是否已发布
- 查看日志：
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log
# 权限错误
如果看到 Access denied 错误，需要在飞书开放平台添加对应权限。
常见缺少的权限：
contact:contact.base:readonly- 获取用户信息
# 获取用户/群组 ID
# 查看日志中的 ID
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i "feishu"
1
2
2
用户 ID 格式：ou_xxx
群组 ID 格式：oc_xxx
# 总结
OpenClaw 接入飞书的流程：
- 创建飞书应用，获取凭证
- 配置权限和事件订阅
- 配置 OpenClaw 渠道和绑定
- 启动 Gateway 并配对
相比 Telegram，飞书的优势：
- 国内网络可直接访问
- WebSocket 长连接，无需公网 IP
- 支持富文本、卡片消息
- 与飞书生态集成（文档、日历等）
# 参考资源
上次更新: 2026/4/28 12:56:42