跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

OpenClaw 多 Agent 与多飞书机器人配置指南

OpenClaw 框架允许为不同 Agent 独立配置飞书机器人。核心步骤包括创建新 Agent、设置 App ID 和 Secret、绑定 Channel 关系以及重启网关。常见故障如无法回复消息通常源于长连接未开启或 Token 配置错误。每个飞书应用建议仅绑定单一 Agent 以避免冲突。

猫巷少女发布于 2026/4/5更新于 2026/10/25106 浏览

OpenClaw 多 Agent 与多飞书机器人配置指南

在 OpenClaw 架构中，虽然建议一个 Agent 对应一个飞书机器人以保持逻辑清晰，但系统支持为不同 Agent 绑定独立的飞书应用。以下是在同一实例中配置多个 Agent 及对应飞书渠道的完整流程。

1. 创建新 Agent

首先通过命令行创建新的 Agent 实例。注意命名规范，避免拼写错误。

# 创建新 Agent，命名为 new-agent
openclaw agents add new-agent

# 查看创建结果，确认 ID 和状态
openclaw agents list

2. 配置飞书渠道

每个 Agent 需要独立配置其对应的飞书 App ID 和 Secret。这一步主要在配置文件或环境变量中完成。

在命令行执行以下命令（请替换实际值）：

# 配置 new-agent 的飞书通道信息
openclaw config set agents.new-agent.channels.feishu.appId "你的 new-agent 飞书 App ID"
openclaw config set agents.new-agent.channels.feishu.appSecret "你的 new-agent 飞书 App Secret"

# 重启网关服务使配置生效
openclaw gateway restart

配置完成后，openclaw.json 中的 channels 部分应包含如下结构。重点关注 accounts 下的独立配置项：

"channels": {
  "feishu": {
    "enabled": true,
    "domain": "feishu",
    "groupPolicy": "allowlist",
    "accounts": {
      "main": {
        "appId"
:
"cli_1"
,
"appSecret"
:
"appSecret1"
,
"botName"
:
"主助手"
,
"groupAllowFrom"
:
[
"ou_id1"
]
}
,
"new-agent"
:
{
"appId"
:
"cli_2"
,
"appSecret"
:
"appSecret2"
,
"botName"
:
"工作助手"
,
"groupAllowFrom"
:
[
"ou_id2"
]
}
}
,
"dmPolicy"
:
"pairing"
}
}

如果自动生成的文件不完整，建议手动检查并修正 accounts 字段，确保每个 Agent 都有对应的账户信息。

3. 绑定 Agent 与 Channel 关系

创建好配置后，需要将具体的 Agent ID 与飞书账号进行绑定。这决定了哪个机器人响应哪个 Agent 的逻辑。

# 将 main Agent 绑定到 main 飞书账号
openclaw agents bind --agent main --bind feishu:main

# 将 new-agent 绑定到 new-agent 飞书账号
openclaw agents bind --agent new-agent --bind feishu:new-agent

绑定成功后，JSON 配置文件中的 bindings 字段应显示如下映射关系：

"bindings": [
  {
    "agentId": "main",
    "match": {
      "channel": "feishu",
      "accountId": "main"
    }
  },
  {
    "agentId": "new-agent",
    "match": {
      "channel": "feishu",
      "accountId": "new-agent"
    }
  }
]

4. 常见问题排查

在实际部署过程中，可能会遇到以下问题，建议按顺序检查：

  • 发送消息无法回复：通常是因为长连接未正确建立，检查网络策略或服务状态。
  • 飞书配置报错：确认 APP ID 和密钥是否填写正确，且未被修改。
  • 401 Token 错误：检查 Token 配置是否过期或权限不足。
  • 应用复用冲突：务必使用新的飞书应用，不要尝试将一个飞书应用绑定给多个 Agent，这会导致消息路由混乱。

完成上述步骤后，再次执行 openclaw gateway restart 确保所有变更生效。

目录

  1. OpenClaw 多 Agent 与多飞书机器人配置指南
  2. 1. 创建新 Agent
  3. 创建新 Agent，命名为 new-agent
  4. 查看创建结果，确认 ID 和状态
  5. 2. 配置飞书渠道
  6. 配置 new-agent 的飞书通道信息
  7. 重启网关服务使配置生效
  8. 3. 绑定 Agent 与 Channel 关系
  9. 将 main Agent 绑定到 main 飞书账号
  10. 将 new-agent 绑定到 new-agent 飞书账号
  11. 4. 常见问题排查

更多推荐文章

查看全部
  • C 语言冒泡排序算法原理与实现
  • 用 C++ 搭一个 JSON/HTTP Web 服务器
  • 手写 C++ TCP 服务器：自定义协议与粘包处理实战
  • 大模型时代 AI 产品经理的未来之路
  • 大模型微调技术对比：PEFT 原生实现与 LLaMA-Factory 框架
  • Java 代码块详解：实例、静态与同步
  • MySQL 迁移至人大金仓的私有化工具与增量同步方案
  • MyEMS 开源能源管理系统技术架构与应用
  • Spring Boot 安全认证与授权核心解析
  • Flutter 三方库 wallet_connect 的鸿蒙适配指南：Web3 钱包连接与 DApp 授权
  • WebGoat JWT 漏洞实战：第六关与第十一关逻辑越权解析
  • 基于 LLaMA-Factory 和 LoRA 微调 GPT-OSS-20B 模型教程
  • 前端地图开发：标记点（Marker）的添加、删除、拖拽及事件绑定
  • Godot Copilot AI 代码生成插件安装与使用指南
  • 宇树 G1 人形机器人强化学习训练配置与奖励函数解析
  • GLM-4.6V-Flash-WEB vs InternVL：视觉模型部署效率对比
  • ChatGPT Prompt Hacker 技巧：优化简历通过 AI 筛选
  • Pyarmor 跨版本兼容指南：Python 2.7 至 3.15 支持方案
  • GitHub Copilot 编程助手完整使用教程
  • 预训练语言模型与 BERT 实战应用

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online