feishu-multi-account
OpenClaw 多飞书账号配置 - 为子代理配置独立的飞书机器人账号。
触发场景
- 用户要配置多个飞书机器人
- 用户要给子代理配置独立的飞书账号
- 用户遇到飞书消息路由问题
前置条件
- 飞书应用：已在飞书开放平台创建好应用（获取 AppID 和 AppSecret）
- OpenClaw：已安装并正常运行
- 子代理：已在 OpenClaw 中创建
配置步骤
Step 1：配置飞书多账号
在 openclaw.json 的 channels.feishu.accounts 中添加：
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "xxx"
},
"sub1": {
"appId": "cli_yyy",
"appSecret": "yyy",
"botname": "Agent B"
},
"default": {
"groupPolicy": "allowlist",
"groupAllowFrom": ["ou_xxx"],
"dmPolicy": "pairing"
}
}Step 2：配置 Bindings（最重要！）
在 openclaw.json 顶层添加 bindings：
"bindings": [
{
"agentId": "main",
"match": {
"channel": "feishu",
"accountId": "main"
}
},
{
"agentId": "sub1",
"match": {
"channel": "feishu",
"accountId": "sub1"
}
}
],Step 3：配置 Agents
"agents": {
"list": [
{
"id": "main",
"default": true,
"name": "Agent A"
},
{
"id": "sub1",
"name": "Agent B",
"workspace": "/path/to/workspace-sub1"
}
]
}Step 4：重启 Gateway
openclaw gateway restart验证配置
查看 Agent 列表
openclaw agents list测试路由
用子代理的飞书账号发一条消息，看日志：
tail -f /tmp/openclaw/openclaw-日期.log | grep "dispatching"成功日志：
feishu[sub1]: dispatching to agent (session=agent:sub1:sub1)失败日志：
feishu[sub1]: dispatching to agent (session=agent:main:main)常见问题
Q1: 路由一直不生效？
- 检查
bindings是否放在顶层（不是 channels 下面） - 检查
agentId和accountId是否与配置一致 - 检查是否两个账号都写了 bindings
Q2: 消息发到主账号？
- 很可能是没写主账号的 bindings，默认路由到 main 了
关键要点
- agentId = agents.list 中的 id
- accountId = accounts 中的账号 ID
- 两个账号都要写 bindings，否则会被默认路由
- 用bindings（不是routing）
配置文件示例
{
"bindings": [
{ "agentId": "main", "match": { "channel": "feishu", "accountId": "main" } },
{ "agentId": "sub1", "match": { "channel": "feishu", "accountId": "sub1" } }
],
"agents": {
"list": [
{ "id": "main", "default": true, "name": "Agent A" },
{ "id": "sub1", "name": "Agent B", "workspace": "/path/to/workspace-sub1" }
]
},
"channels": {
"feishu": {
"enabled": true,
"domain": "feishu",
"accounts": {
"main": { "appId": "cli_xxx", "appSecret": "xxx" },
"sub1": { "appId": "cli_yyy", "appSecret": "yyy" }
}
}
}
}