背景说明在默认情况下,当你为飞书频道绑定一个机器人后,这个机器人对应的是一个独立的 Agent。无论你把这个机器人拉到多少个不同的群聊中,它在 OpenClaw 后端始终对应着同一个 Agent。但这种配置存在一个局限性:所有群聊共享同一个 Agent 的数据、上下文和模型配置。多bot多agents: 需要申请多个机器人,麻烦而且也没有必要。本教程将教你如何实现:一个飞书机器人对应多个不同的 Agent,每个 Agent 拥有独立的数据隔离、可以使用不同的模型,从而实现群聊级别的数据隔离和个性化配置。 典型应用场景技术群:使用编程能力强的模型(如 qwen-coder),Agent 身份为”架构师”产品群:使用理解能力强的模型(如 GLM-5),Agent 身份为”产品经理”管理群:使用综合能力强的模型(如 Kimi),Agent 身份为”总监”一、新增 Agents1.1 命令格式openclaw agents add --workspace 工作空间路径Agent名称1.2 参数详解参数说明示例--workspaceAgent 的独立工作空间路径,用于数据隔离Linux:/root/.openclaw/workspace/feishu/codebrWindows: openclaw agents add —workspace C:\Users\Administrator\.openclaw\workspace\feishu\codeAgent名称唯一标识符,即 AgentId,建议见名知意code-agent、product-agent--model(可选)指定自定义模型 ID,不添加则使用默认模型bailian/qwen3-coder-plus1.3 实际示例# 创建一个专门用于代码相关的 Agentopenclaw agents add --workspace openclaw agents add --workspace C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\code feishu-code提示:执行前请确保工作空间目录已存在,系统会自动创建必要的配置文件。二、验证 Agent 是否创建成功执行以下命令查看所有已创建的 Agent 列表:openclaw agents list你应该能看到刚创建的 Agent 出现在列表中。三、飞书群组绑定现在我们已经创建了多个 Agent,接下来需要将它们分别绑定到不同的飞书群聊中。3.1 查看当前绑定关系首先,让我们看看当前已经配置了哪些绑定:openclaw config get bindings3.2 获取飞书群 ID在绑定群聊之前,我们需要先获取目标群聊的 ID。操作步骤:打开飞书群聊点击右上角设置图标在群信息中找到会话 ID⚠️注意:复制群 ID 时,注意不要包含多余的空格或字符。3.3 查看飞书渠道配置在配置绑定前,先了解你的飞书渠道配置信息:openclaw config get channels.feishu你会看到类似这样的配置结构:{channels:{feishu:{accounts:{main:{//←这个是账号标识(accountId)appId:xxx,appSecret:xxx},default:{dmPolicy:pairing}},enabled:true,streaming:true,footer:{elapsed:true,status:true}}}}关键点:记住channels.feishu.accounts下的账号名称(示例中是main),后续配置绑定时会用到。3.4 配置群组绑定现在,我们使用以下命令将 Agent 绑定到具体的飞书群:openclaw config set--json bindings [ { agentId: feishu-code, // ← 你的 Agent ID match: { channel: feishu, // ← 固定值,表示飞书渠道 accountId: main, // ← 对应 channels.feishu.accounts 中的账号名 peer: { kind: group, // ← 固定值,表示群聊 id: oc_34fdfds3XXX // ← 你的飞书群 ID } } }]参数说明:参数说明示例agentId要绑定的 Agent IDfeishu-codeid飞书群 IDoc_34fdfds3XXXaccountId飞书渠道配置中的账号标识main3.5 配置安全策略(推荐)默认情况下,channels.feishu.groupPolicy是open模式,这意味着机器人会响应所有群组的消息。建议:将其设置为allowlist模式,只响应白名单中的群组消息,提高安全性。# 设置策略为白名单模式openclaw config set channels.feishu.groupPolicy allowlist# 添加允许访问的群组列表openclaw config set--json channels.feishu.groupAllowFrom [oc_34fdfxxx,oc_34fdfxxx]四、完整配置示例下面是一个完整的配置文件示例,展示了如何配置多个 Agent 和绑定关系:{//渠道配置channels:{feishu:{accounts:{main:{appId:cli_a917dxxx,appSecret:3PFfvN3xxxx},default:{dmPolicy:pairing}},enabled:true,streaming:true,footer:{elapsed:true,status:true}}},//Agent配置agents:{defaults:{model:{primary:bailian/glm-5},models:{zai/glm-4.7:{alias:GLM},zai/glm-4.7-flash:{alias:glm-4.7-flash},zai/glm-5:{alias:GLM},bailian/glm-5:{alias:GLM}},workspace:C:\\Users\\Administrator\\clawd,timeoutSeconds:86400},list:[//主Agent{id:main},//代码专家Agent{id:feishu-code,name:feishu-code,workspace:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\code,agentDir:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\code,model:{primary:bailian/qwen3-coder-plus,fallbacks:[bailian/qwen3.5-plus,zai/glm-5]},identity:{name:架构师,emoji:}},//产品经理Agent{id:feishu-product,name:feishu-product,workspace:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\product,agentDir:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\product,model:{primary:bailian/glm-5,fallbacks:[bailian/qwen3.5-plus,zai/glm-5]},identity:{name:产品经理,emoji:}},//总监Agent{id:feishu-director,name:feishu-director,workspace:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\director,agentDir:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\director,model:{primary:bailian/kimi-k2.5,fallbacks:[bailian/qwen3.5-plus,zai/glm-5]},identity:{name:总监,emoji:}}]},//绑定关系配置bindings:[{agentId:feishu-code,match:{channel:feishu,accountId:main,peer:{kind:group,id:oc_ebfxxx}}},{agentId:feishu-product,match:{channel:feishu,accountId:main,peer:{kind:group,id:oc_b99xxx}}}]}五、常见问题排查❓ 问题 1: 绑定后机器人没有响应可能原因:群 ID 配置错误Agent ID 不存在群组策略设置为allowlist但群 ID 未加入白名单解决方法:# 检查绑定是否正确openclaw config get bindings# 检查 Agent 是否存在openclaw agents list# 如果使用了 allowlist,检查白名单openclaw config get channels.feishu.groupAllowFrom❓ 问题 2: 如何修改已存在的绑定?方法一:使用命令重新设置(会覆盖整个 bindings)方法二:直接编辑配置文件(适用于多个绑定的场景)❓ 问题 3: 不同的 Agent 能否共享数据?默认情况下,不同 Agent 的工作空间是独立的,数据相互隔离。如果需要共享数据,可以考虑:使用统一的数据库后端在 Agent 之间通过飞书机器人互相转发六、最佳实践建议✅ 推荐做法命名规范: Agent ID 使用feishu-{功能}格式,如feishu-code、feishu-product工作空间分离: 每个 Agent 使用独立的 workspace 路径,便于数据管理模型选择: 根据群聊性质选择合适的模型技术群:coder 系列、deepseek-coder通用群:GLM-5、Qwen3.5-plus长文本:Kimi、Claude 系列安全策略:始终使用allowlist模式,只允许授权群组访问 进阶技巧为不同 Agent 设置不同的identity.name和identity.emoji,让群成员一眼就能识别当前对话的 Agent 角色配置fallbacks确保主模型不可用时能自动降级定期备份各 Agent 的工作空间数据 恭喜!你已经学会了如何配置一个飞书机器人对应多个 Agent。现在你可以根据不同的业务场景,为每个群聊配置专属的 Agent,实现真正的智能化群聊管理!
飞书单机器人配置多个 Agent 实践指南
发布时间：2026/5/16 17:34:54
背景说明在默认情况下,当你为飞书频道绑定一个机器人后,这个机器人对应的是一个独立的 Agent。无论你把这个机器人拉到多少个不同的群聊中,它在 OpenClaw 后端始终对应着同一个 Agent。但这种配置存在一个局限性:所有群聊共享同一个 Agent 的数据、上下文和模型配置。多bot多agents: 需要申请多个机器人,麻烦而且也没有必要。本教程将教你如何实现:一个飞书机器人对应多个不同的 Agent,每个 Agent 拥有独立的数据隔离、可以使用不同的模型,从而实现群聊级别的数据隔离和个性化配置。 典型应用场景技术群:使用编程能力强的模型(如 qwen-coder),Agent 身份为”架构师”产品群:使用理解能力强的模型(如 GLM-5),Agent 身份为”产品经理”管理群:使用综合能力强的模型(如 Kimi),Agent 身份为”总监”一、新增 Agents1.1 命令格式openclaw agents add --workspace 工作空间路径Agent名称1.2 参数详解参数说明示例--workspaceAgent 的独立工作空间路径,用于数据隔离Linux:/root/.openclaw/workspace/feishu/codebrWindows: openclaw agents add —workspace C:\Users\Administrator\.openclaw\workspace\feishu\codeAgent名称唯一标识符,即 AgentId,建议见名知意code-agent、product-agent--model(可选)指定自定义模型 ID,不添加则使用默认模型bailian/qwen3-coder-plus1.3 实际示例# 创建一个专门用于代码相关的 Agentopenclaw agents add --workspace openclaw agents add --workspace C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\code feishu-code提示:执行前请确保工作空间目录已存在,系统会自动创建必要的配置文件。二、验证 Agent 是否创建成功执行以下命令查看所有已创建的 Agent 列表:openclaw agents list你应该能看到刚创建的 Agent 出现在列表中。三、飞书群组绑定现在我们已经创建了多个 Agent,接下来需要将它们分别绑定到不同的飞书群聊中。3.1 查看当前绑定关系首先,让我们看看当前已经配置了哪些绑定:openclaw config get bindings3.2 获取飞书群 ID在绑定群聊之前,我们需要先获取目标群聊的 ID。操作步骤:打开飞书群聊点击右上角设置图标在群信息中找到会话 ID⚠️注意:复制群 ID 时,注意不要包含多余的空格或字符。3.3 查看飞书渠道配置在配置绑定前,先了解你的飞书渠道配置信息:openclaw config get channels.feishu你会看到类似这样的配置结构:{channels:{feishu:{accounts:{main:{//←这个是账号标识(accountId)appId:xxx,appSecret:xxx},default:{dmPolicy:pairing}},enabled:true,streaming:true,footer:{elapsed:true,status:true}}}}关键点:记住channels.feishu.accounts下的账号名称(示例中是main),后续配置绑定时会用到。3.4 配置群组绑定现在,我们使用以下命令将 Agent 绑定到具体的飞书群:openclaw config set--json bindings [ { agentId: feishu-code, // ← 你的 Agent ID match: { channel: feishu, // ← 固定值,表示飞书渠道 accountId: main, // ← 对应 channels.feishu.accounts 中的账号名 peer: { kind: group, // ← 固定值,表示群聊 id: oc_34fdfds3XXX // ← 你的飞书群 ID } } }]参数说明:参数说明示例agentId要绑定的 Agent IDfeishu-codeid飞书群 IDoc_34fdfds3XXXaccountId飞书渠道配置中的账号标识main3.5 配置安全策略(推荐)默认情况下,channels.feishu.groupPolicy是open模式,这意味着机器人会响应所有群组的消息。建议:将其设置为allowlist模式,只响应白名单中的群组消息,提高安全性。# 设置策略为白名单模式openclaw config set channels.feishu.groupPolicy allowlist# 添加允许访问的群组列表openclaw config set--json channels.feishu.groupAllowFrom [oc_34fdfxxx,oc_34fdfxxx]四、完整配置示例下面是一个完整的配置文件示例,展示了如何配置多个 Agent 和绑定关系:{//渠道配置channels:{feishu:{accounts:{main:{appId:cli_a917dxxx,appSecret:3PFfvN3xxxx},default:{dmPolicy:pairing}},enabled:true,streaming:true,footer:{elapsed:true,status:true}}},//Agent配置agents:{defaults:{model:{primary:bailian/glm-5},models:{zai/glm-4.7:{alias:GLM},zai/glm-4.7-flash:{alias:glm-4.7-flash},zai/glm-5:{alias:GLM},bailian/glm-5:{alias:GLM}},workspace:C:\\Users\\Administrator\\clawd,timeoutSeconds:86400},list:[//主Agent{id:main},//代码专家Agent{id:feishu-code,name:feishu-code,workspace:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\code,agentDir:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\code,model:{primary:bailian/qwen3-coder-plus,fallbacks:[bailian/qwen3.5-plus,zai/glm-5]},identity:{name:架构师,emoji:}},//产品经理Agent{id:feishu-product,name:feishu-product,workspace:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\product,agentDir:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\product,model:{primary:bailian/glm-5,fallbacks:[bailian/qwen3.5-plus,zai/glm-5]},identity:{name:产品经理,emoji:}},//总监Agent{id:feishu-director,name:feishu-director,workspace:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\director,agentDir:C:\\Users\\Administrator\\.openclaw\\workspace\\feishu\\director,model:{primary:bailian/kimi-k2.5,fallbacks:[bailian/qwen3.5-plus,zai/glm-5]},identity:{name:总监,emoji:}}]},//绑定关系配置bindings:[{agentId:feishu-code,match:{channel:feishu,accountId:main,peer:{kind:group,id:oc_ebfxxx}}},{agentId:feishu-product,match:{channel:feishu,accountId:main,peer:{kind:group,id:oc_b99xxx}}}]}五、常见问题排查❓ 问题 1: 绑定后机器人没有响应可能原因:群 ID 配置错误Agent ID 不存在群组策略设置为allowlist但群 ID 未加入白名单解决方法:# 检查绑定是否正确openclaw config get bindings# 检查 Agent 是否存在openclaw agents list# 如果使用了 allowlist,检查白名单openclaw config get channels.feishu.groupAllowFrom❓ 问题 2: 如何修改已存在的绑定?方法一:使用命令重新设置(会覆盖整个 bindings)方法二:直接编辑配置文件(适用于多个绑定的场景)❓ 问题 3: 不同的 Agent 能否共享数据?默认情况下,不同 Agent 的工作空间是独立的,数据相互隔离。如果需要共享数据,可以考虑:使用统一的数据库后端在 Agent 之间通过飞书机器人互相转发六、最佳实践建议✅ 推荐做法命名规范: Agent ID 使用feishu-{功能}格式,如feishu-code、feishu-product工作空间分离: 每个 Agent 使用独立的 workspace 路径,便于数据管理模型选择: 根据群聊性质选择合适的模型技术群:coder 系列、deepseek-coder通用群:GLM-5、Qwen3.5-plus长文本:Kimi、Claude 系列安全策略:始终使用allowlist模式,只允许授权群组访问 进阶技巧为不同 Agent 设置不同的identity.name和identity.emoji,让群成员一眼就能识别当前对话的 Agent 角色配置fallbacks确保主模型不可用时能自动降级定期备份各 Agent 的工作空间数据 恭喜!你已经学会了如何配置一个飞书机器人对应多个 Agent。现在你可以根据不同的业务场景,为每个群聊配置专属的 Agent,实现真正的智能化群聊管理!
