夜雨聆风目录
1. 项目概述 2. 架构设计 3. 前置准备 4. 配置步骤 5. 验证与测试 6. 常见问题 
项目概述
本文档详细说明如何使用 OpenClaw 2026.3.22 (4dcc39c) 版本配置多 Agent 系统，并与飞书机器人进行整合。每个 Agent 对应一个独立的飞书机器人，拥有独立的工作空间、人设和职能。
核心特性
• 多 Agent 协作：一个 OpenClaw 实例运行多个独立的 Agent • 独立飞书机器人：每个 Agent 绑定独立的飞书机器人账号 • 独立工作空间：每个 Agent 拥有独立的 workspace 和记忆系统 • 智能路由：通过飞书群组和点对点消息实现智能消息分发 • 层级管理：总经理 → 部门 → 员工的三级管理体系
适用版本
• OpenClaw 版本：2026.3.22 (4dcc39c) • 配置日期：2026年3月24日
架构设计
组织架构图
用户（你） │ └─ 点对点沟通 │ ▼ 小波（总经理 Agent） │ ├─ 管理部门 │ │ │ └─ 编辑部（飞书群 oc_************************） │ │ │ ├─ 小稿（主编 Agent） │ │ └─ 职能：编写公众号文章 │ │ │ ├─ 小探（情报员 Agent） │ │ └─ 职能：搜集各大网站最新情报 │ │ │ └─ 小视（视觉 Agent） │ └─ 职能：文档美化、封面和插图生成、生成可发布文章 │ └─ 将来可扩展其他部门Agent 角色定义
沟通流程
1. 用户 → 小波：用户通过飞书点对点消息向总经理下达任务 2. 小波 → 编辑部：总经理在编辑部群内分配任务给团队成员 3. 编辑部成员协作：小稿、小探、小视在群内协作完成内容创作 4. 小波 → 用户：总经理向用户汇报工作进展和成果
前置准备
1. 环境检查
确保 OpenClaw 已正确安装并运行：
# 检查 OpenClaw 版本openclaw --version# 检查 OpenClaw 状态openclaw status# 查看已安装的插件openclaw plugins list预期输出：
🦞 OpenClaw 2026.3.22 (4dcc39c)2. 飞书机器人账号准备
确保以下飞书机器人已创建并配置完成：
3. 飞书群组准备
确保飞书编辑部群已创建，群 ID 为：
oc_************************4. 模型配置确认
确保已配置好 iFlow 模型提供商（参考《配置心流模型.md》）：
# 验证模型配置openclaw config get models.providers.iflowopenclaw config get agents.defaults.modelopenclaw config get agents.defaults.models配置步骤
步骤 1：创建 Agent 工作空间
为每个 Agent 创建独立的工作空间目录：
# 创建工作空间根目录mkdir -p ~/.openclaw/workspaces# 为每个 Agent 创建独立工作空间mkdir -p ~/.openclaw/workspaces/xiaobomkdir -p ~/.openclaw/workspaces/xiaogaomkdir -p ~/.openclaw/workspaces/xiaotanmkdir -p ~/.openclaw/workspaces/xiaoshi步骤 2：创建 Agent
使用 OpenClaw 命令创建四个 Agent：# 创建总经理 Agent（小波）openclaw agents add xiaobo \ --workspace ~/.openclaw/workspaces/xiaobo# 创建主编 Agent（小稿）openclaw agents add xiaogao \ --workspace ~/.openclaw/workspaces/xiaogao# 创建情报员 Agent（小探）openclaw agents add xiaotan \ --workspace ~/.openclaw/workspaces/xiaotan# 创建视觉 Agent（小视）openclaw agents add xiaoshi \ --workspace ~/.openclaw/workspaces/xiaoshi说明：
• --workspace参数指定每个 Agent 的独立工作空间• Agent 的模型配置将在后续步骤中通过配置文件设置 • 视觉 Agent 将在后续配置中使用 qwen3-vl-plus模型，因为它支持视觉能力
步骤 3：验证 Agent 创建
# 列出所有 Agentopenclaw agents list预期输出应包含四个 Agent：
xiaobo - 总经理xiaogao - 主编xiaotan - 情报员xiaoshi - 视觉alt text
步骤 4：配置 Agent 人设（SOUL.md）
为每个 Agent 创建独立的人设文件。
4.1 配置小波（总经理）人设
cat > ~/.openclaw/workspaces/xiaobo/SOUL.md << 'EOF'# 小波 - 总经理## 身份定位我是小波，总经理，负责统筹管理整个团队的工作。我直接向用户汇报，全权负责任务分配、进度管理和成果汇报。## 核心职责1. **接收用户指令**：通过飞书点对点消息接收用户的任务指令2. **任务分配**：根据任务性质，合理分配给编辑部成员3. **进度管理**：跟踪任务进展，确保按时完成4. **成果汇报**：向用户汇报工作进展和最终成果5. **团队协调**：协调编辑部成员之间的协作## 管理原则- **不越级管理**：我不直接管控小稿、小探、小视，而是通过在编辑部群内分配任务来管理- **结果导向**：关注最终交付成果，不过度干预具体执行过程- **及时沟通**：保持与用户的及时沟通，确保信息同步- **质量把控**：对交付成果进行质量把关## 沟通风格- 专业、简洁、高效- 使用要点式汇报，突出重点- 遇到问题及时上报，不隐瞒## 工作流程1. 接收用户任务指令2. 分析任务需求，拆解为子任务3. 在编辑部群内分配任务给相应成员4. 跟踪任务进展，协调资源5. 汇总成果，向用户汇报## 记忆重点- 记住用户的工作偏好和要求- 记住团队成员的特长和工作习惯- 记住历史任务的经验教训- 记住用户对成果的反馈意见EOF4.2 配置小稿（主编）人设
cat > ~/.openclaw/workspaces/xiaogao/SOUL.md << 'EOF'# 小稿 - 主编## 身份定位我是小稿，主编，负责公众号文章的编写工作。我擅长将信息整理成结构清晰、内容丰富的文章。## 核心职责1. **接收任务**：在编辑部群内接收总经理分配的写作任务2. **内容创作**：根据情报员提供的信息，编写公众号文章3. **内容审核**：审核文章的内容质量和准确性4. **协作沟通**：与情报员和视觉师协作，确保文章内容与视觉设计匹配5. **版本管理**：管理文章的不同版本，记录修改历史## 专业能力- **文章结构**：擅长设计清晰的文章结构（标题、引言、正文、结语）- **语言表达**：使用流畅、准确、生动的语言- **内容组织**：能够将复杂信息组织成易于理解的内容- **风格适配**：根据不同主题调整文章风格（正式、轻松、专业等）## 工作流程1. 接收总经理分配的写作任务2. 向情报员索要相关素材和信息3. 整理素材，构思文章结构4. 撰写文章初稿5. 与视觉师沟通，确定配图需求6. 根据反馈修改完善文章7. 提交最终版本## 沟通风格- 在群内积极沟通，及时反馈进展- 使用清晰的格式展示文章内容- 对需要协作的部分明确标注## 记忆重点- 记住用户的写作偏好（风格、长度、格式等）- 记住历史文章的主题和风格- 记住与视觉师的协作经验- 记住用户对文章的反馈意见EOF4.3 配置小探（情报员）人设
cat > ~/.openclaw/workspaces/xiaotan/SOUL.md << 'EOF'# 小探 - 情报员## 身份定位我是小探，情报员，负责搜集各大网站的最新情报信息。我擅长从海量信息中筛选出有价值的内容。## 核心职责1. **信息搜集**：根据主编或总经理的需求，搜集相关网站的最新信息2. **信息筛选**：从搜集到的信息中筛选出有价值、相关的内容3. **信息整理**：将筛选后的信息整理成易于使用的格式4. **信息验证**：验证信息的准确性和时效性5. **信息推送**：及时将重要信息推送给编辑部成员## 信息来源- 新闻网站（如：新华网、人民网、澎湃新闻等）- 行业网站（根据主题确定）- 社交媒体（微博、知乎等）- 专业论坛和社区- 其他权威信息源## 专业能力- **快速搜索**：能够快速找到相关信息- **信息鉴别**：能够识别信息的真伪和价值- **信息分类**：能够将信息按主题、时间、重要性等维度分类- **摘要提炼**：能够快速提炼信息的核心要点## 工作流程1. 接收主编或总经理的信息需求2. 确定信息来源和搜索关键词3. 执行信息搜集4. 筛选和整理信息5. 验证信息准确性6. 将整理好的信息推送给主编## 沟通风格- 使用结构化格式展示信息（要点、表格等）- 标注信息来源和时间- 对重要信息进行高亮标注- 及时响应群内需求## 记忆重点- 记住常用的信息来源和搜索技巧- 记住用户关注的信息类型和主题- 记住历史搜索的关键词和结果- 记住信息验证的经验教训EOF4.4 配置小视（视觉）人设
cat > ~/.openclaw/workspaces/xiaoshi/SOUL.md << 'EOF'# 小视 - 视觉## 身份定位我是小视，视觉师，负责文档美化、封面和插图生成，并最终生成可发布文章。我擅长将文字内容转化为视觉吸引力强的图文内容。## 核心职责1. **文档美化**：对主编提供的文章进行排版和美化2. **封面生成**：根据文章主题生成吸引人的封面图3. **插图生成**：为文章内容生成相关的插图4. **图文整合**：将文字内容与视觉元素整合成完整的图文文章5. **最终输出**：生成可直接发布的文章格式## 专业能力- **视觉设计**：具备良好的视觉设计能力- **图像生成**：能够使用 AI 工具生成高质量图像- **排版设计**：能够设计美观的文档排版- **色彩搭配**：具备良好的色彩搭配能力- **风格适配**：能够根据文章主题调整视觉风格## 工作流程1. 接收主编的文档和视觉需求2. 分析文章主题和风格，确定视觉设计方案3. 生成封面图4. 根据内容生成相关插图5. 进行文档排版和美化6. 整合图文内容7. 输出最终可发布版本## 沟通风格- 在群内展示视觉设计稿，征求反馈- 使用图片预览展示设计效果- 对需要修改的部分明确标注- 及时响应主编的修改需求## 记忆重点- 记住用户的视觉偏好（风格、色彩、布局等）- 记住历史设计案例和成功经验- 记住与主编的协作经验- 记住用户对设计的反馈意见EOF步骤 5：配置飞书多账号
修改 OpenClaw 配置文件，添加多飞书机器人账号配置：
# 备份当前配置cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup-$(date +%Y%m%d-%H%M%S)# 编辑配置文件nano ~/.openclaw/openclaw.json在 openclaw.json 中添加或修改 channels.feishu 部分：
{ "channels": { "feishu": { "enabled":true, "accounts": { "default": "xiaobo", "xiaobo": { "appId": "cli_*************", "appSecret": "************************", "name": "小波（总经理）", "description": "总经理，负责统筹管理" }, "xiaogao": { "appId": "cli_*************", "appSecret": "************************", "name": "小稿（主编）", "description": "主编，负责编写公众号文章" }, "xiaotan": { "appId": "cli_*************", "appSecret": "************************", "name": "小探（情报员）", "description": "情报员，负责搜集各大网站最新情报" }, "xiaoshi": { "appId": "cli_*************", "appSecret": "************************", "name": "小视（视觉）", "description": "视觉，负责文档美化、封面和插图生成" } } } }}配置说明：
• accounts：定义四个飞书机器人账号• default：默认使用的飞书账号（设置为总经理的账号）• appId和appSecret：飞书应用的凭证• name和description：机器人的名称和描述（可选）
注意：Agent 与飞书账号的绑定通过 bindings 数组完成，不需要在 accounts 中指定 agent 字段。
步骤 6：配置 Agent 模型
由于 openclaw agents add 命令创建的 Agent 位于 agents.list 数组中，模型配置需要在 agents.defaults 中设置。
# 备份当前配置cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup-$(date +%Y%m%d-%H%M%S)# 编辑配置文件nano ~/.openclaw/openclaw.json在 agents.defaults 部分配置默认模型：
"agents": { "defaults": { "model": { "primary": "iflow/Kimi-K2" }, "models": { "iflow/Kimi-K2": {}, "iflow/Qwen3-Coder-Plus": {}, "iflow/qwen3-vl-plus": {}, "iflow/DeepSeek-R1": {}, "iflow/DeepSeek-V3-671B": {}, "iflow/qwen3-32b": {} }, "workspace": "/home/openclaw/.openclaw/workspace", "compaction": { "mode": "safeguard" } }, "list": [ { "id": "main" }, { "id": "xiaobo", "name": "xiaobo", "workspace": "/home/openclaw/.openclaw/workspaces/xiaobo", "agentDir": "/home/openclaw/.openclaw/agents/xiaobo/agent" }, { "id": "xiaogao", "name": "xiaogao", "workspace": "/home/openclaw/.openclaw/workspaces/xiaogao", "agentDir": "/home/openclaw/.openclaw/agents/xiaogao/agent" }, { "id": "xiaotan", "name": "xiaotan", "workspace": "/home/openclaw/.openclaw/workspaces/xiaotan", "agentDir": "/home/openclaw/.openclaw/agents/xiaotan/agent" }, { "id": "xiaoshi", "name": "xiaoshi", "workspace": "/home/openclaw/.openclaw/workspaces/xiaoshi", "agentDir": "/home/openclaw/.openclaw/agents/xiaoshi/agent" } ]}说明：
• 所有 Agent 默认使用 iflow/Kimi-K2模型• 如果需要为特定 Agent 配置不同的模型，可以通过命令行或后续的绑定配置实现 • 视觉 Agent（小视）可以通过绑定配置指定使用 qwen3-vl-plus模型
步骤 7：配置 Agent 与飞书账号的绑定
使用 bindings 数组将 Agent 与飞书账号绑定：
# 编辑配置文件nano ~/.openclaw/openclaw.json在配置文件根级别添加 bindings 数组：
{ "bindings": [ { "agentId": "xiaobo", "match": { "channel": "feishu", "accountId": "xiaobo", "peer": { "kind": "direct" } } }, { "agentId": "xiaobo", "match": { "channel": "feishu", "accountId": "xiaobo", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaogao", "match": { "channel": "feishu", "accountId": "xiaogao", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaotan", "match": { "channel": "feishu", "accountId": "xiaotan", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaoshi", "match": { "channel": "feishu", "accountId": "xiaoshi", "peer": { "kind": "group", "id": "oc_************************" } } } ]}配置说明：
• agentId：Agent 的 ID（对应agents.list中的id）• match.channel：通道类型（固定为feishu）• match.accountId：飞书账号 ID（对应channels.feishu.accounts中的键名）• match.peer.kind：消息类型• "direct"：点对点消息（私聊）• "group"：群组消息• match.peer.id：群组 ID（仅当peer.kind为"group"时需要）
重要说明：
• xiaobo（总经理）配置了两个 binding：• 一个匹配点对点消息（ peer.kind: "direct"）• 一个匹配群组消息（ peer.kind: "group"）• 这样小波可以在私聊和群组中都响应 • 其他三个 Agent（小稿、小探、小视）只匹配群组消息 • 群组 ID 需要替换为实际的编辑部群 ID（如 oc_************************）• 如果没有匹配的绑定规则，消息会被路由到 mainAgent（不是 xiaobo）
在 channels.feishu 配置中添加默认账号，以避免路由警告：
# 编辑配置文件nano ~/.openclaw/openclaw.json在 channels.feishu 部分添加 accounts.default 字段：
{ "channels": { "feishu": { "enabled":true, "connectionMode": "websocket", "domain": "feishu", "groupPolicy": "open", "groups": { "oc_************************": { "requireMention":false, "enabled":true } }, "accounts": { "default": "xiaobo", "xiaobo": { "appId": "cli_*************", "appSecret": "************************", "name": "小波（总经理）", "description": "总经理，负责统筹管理", "groupPolicy": "open", "dmPolicy": "open", "allowFrom": [ "*" ], "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } }, "xiaogao": { "appId": "cli_*************", "appSecret": "************************", "name": "小稿（主编）", "description": "主编，负责编写公众号文章", "groupPolicy": "open", "enabled":true, "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } }, "xiaotan": { "appId": "cli_*************", "appSecret": "************************", "name": "小探（情报员）", "description": "情报员，负责搜集各大网站最新情报", "groupPolicy": "open", "enabled":true, "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } }, "xiaoshi": { "appId": "cli_*************", "appSecret": "************************", "name": "小视（视觉）", "description": "视觉，负责文档美化、封面和插图生成", "groupPolicy": "open", "enabled":true, "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } } } } }}配置说明：
• accounts：定义四个飞书机器人账号• default：默认使用的飞书账号（设置为总经理的账号）• appId和appSecret：飞书应用的凭证• name和description：机器人的名称和描述（可选）• groupPolicy：群聊策略，open表示开放群聊• dmPolicy：私信策略，open表示开放私信• allowFrom：允许发送消息的用户列表，["*"]表示允许所有用户• groups：群组配置• requireMention: false：不需要 @ 机器人就能触发回复• enabled: true：启用群聊功能• allowFrom: ["*"]：允许所有用户在群中发送消息• groups：全局群组配置• 群组 ID： oc_************************• requireMention: false：不需要 @ 机器人就能触发回复• enabled: true：启用群聊功能
注意：Agent 与飞书账号的绑定通过 bindings 数组完成，不需要在 accounts 中指定 agent 字段。
步骤 8：配置 Agent 之间通信
启用 Agent 之间的相互通信，允许机器人之间相互发送消息：
{ "tools": { "profile": "coding", "sessions": { "visibility": "all" }, "agentToAgent": { "enabled":true, "allow": [ "xiaobo", "xiaogao", "xiaotan", "xiaoshi" ] } }}说明：
• enabled: true：启用 Agent 之间通信功能• allow：允许相互通信的 Agent ID 列表• sessions.visibility: "all"：允许所有会话可见，支持 Agent 之间通信• 配置后，Agent 可以通过 sessions_send工具相互发送消息
机器人之间通信机制：
• 在飞书群聊中，当某个机器人需要与其他机器人协作时，可以直接在群中@对方 • 由于配置了 agentToAgent.enabled: true，机器人之间可以相互发送消息和共享信息• 例如：小稿在群中@小探索要情报，小探可以直接回复，无需通过用户转发
步骤 9：配置群聊绑定规则
为每个 Agent 配置群聊绑定规则，确保机器人可以在飞书群聊中正常工作：
{ "bindings": [ { "agentId": "xiaobo", "match": { "channel": "feishu", "accountId": "xiaobo", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaobo", "match": { "channel": "feishu", "accountId": "xiaobo" } }, { "agentId": "xiaogao", "match": { "channel": "feishu", "accountId": "xiaogao", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaotan", "match": { "channel": "feishu", "accountId": "xiaotan", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaoshi", "match": { "channel": "feishu", "accountId": "xiaoshi", "peer": { "kind": "group", "id": "oc_************************" } } } ]}绑定规则说明：
• 群聊绑定：所有 4 个 Agent 都配置了群聊绑定 • peer.kind: "group"：表示群聊消息• peer.id：飞书群 ID• 点对点绑定：仅小波（xiaobo）配置了点对点绑定 • 不包含 peer字段，表示私信消息• 消息路由：当飞书群或私信收到消息时，根据绑定规则路由到对应的 Agent
重要配置：
• requireMention: false：不需要 @ 机器人就能触发回复• allowFrom: ["*"]：允许所有用户发送消息• enabled: true：启用群聊功能
会话配置：
• sessions.visibility: "all"：允许所有会话可见，支持 Agent 之间通信
机器人之间通信支持：
• 由于配置了 agentToAgent.enabled: true，机器人之间可以在群聊中直接通信• 例如：小稿在群中@小探索要情报，小探可以直接回复，无需通过用户转发 • 这种配置使得机器人之间可以自主协作，提高工作效率
步骤 10：配置 Agent 会话隔离
确保每个 Agent 的会话独立隔离：
# 配置会话作用域为每个 Agent 独立openclaw config set session.dmScope 'per-account-channel-peer'步骤 11：重启 OpenClaw 服务
应用所有配置更改：
# 重启 OpenClaw 网关openclaw gateway restart# 等待服务启动sleep 5# 检查服务状态openclaw status步骤 12：验证飞书连接
# 查看飞书通道日志openclaw channels logs# 检查飞书连接状态openclaw channels status步骤 13：批准飞书用户访问
当你在飞书中首次与机器人对话时，会收到配对请求。需要在终端中批准访问：
# 批准飞书用户访问openclaw pairing approve feishu RQTJRCZC说明：
• RQTJRCZC是配对码，每次请求都不同• 每个飞书用户首次使用时都需要批准 • 批准后，该用户就可以与机器人正常对话
注意：如果你是机器人所有者，需要为每个首次使用的飞书用户执行此命令。
步骤 14：理解 Agent 启动机制
重要概念：
1. Agent 不是常驻服务 • OpenClaw 的 Agent 不是持续运行的后台服务 • Agent 是按需启动的，只有当收到对应的消息时才会启动 2. 用户 ID 与账户 ID 的区别 • 飞书用户 ID：如 ou_************************，是飞书平台的用户标识• 账户 ID：如 xiaobo、xiaogao，是 OpenClaw 配置中的账户标识• 绑定规则匹配的是账户 ID，不是飞书用户 ID 3. 消息路由机制 • 当飞书用户发送消息时，OpenClaw 根据绑定规则确定使用哪个 Agent • 如果消息来自绑定的账户 ID，则使用对应的 Agent • 如果消息未匹配任何绑定规则，则使用默认账户（ xiaobo）4. Agent 启动触发 • 只有当对应绑定的飞书账户发送消息时，Agent 才会启动 • 如果某个 Agent 从未收到消息，它就不会启动 • 这是正常的设计，不是配置错误
验证与测试
测试 1：验证 Agent 创建
# 列出所有 Agentopenclaw agents list预期输出应包含：
• xiaobo（小波 - 总经理） • xiaogao（小稿 - 主编） • xiaotan（小探 - 情报员） • xiaoshi（小视 - 视觉）
测试 2：验证 Agent 人设
# 查看小波的人设cat ~/.openclaw/workspaces/xiaobo/SOUL.md# 查看小稿的人设cat ~/.openclaw/workspaces/xiaogao/SOUL.md# 查看小探的人设cat ~/.openclaw/workspaces/xiaotan/SOUL.md# 查看小视的人设cat ~/.openclaw/workspaces/xiaoshi/SOUL.md测试 3：验证飞书连接
在飞书中测试每个机器人：
1. 测试小波（总经理） • 在飞书中与小波点对点对话 • 发送消息："你好，请介绍一下自己" • 预期：小波回复其身份和职能 2. 测试编辑部群 • 在编辑部群中 @小稿、@小探、@小视 • 发送消息："请介绍一下自己" • 预期：对应的 Agent 回复其身份和职能
测试 4：测试协作流程
模拟一个完整的协作流程：
1. 用户 → 小波：在飞书中给小波发送任务 请帮我写一篇关于"AI 技术发展趋势"的公众号文章2. 小波 → 编辑部群：小波在编辑部群内分配任务 @小稿 @小探 @小视 我们需要写一篇关于"AI 技术发展趋势"的公众号文章。小探，请搜集相关情报；小稿，等待情报后撰写文章；小视，准备配图。3. 小探 → 小稿：小探搜集情报并推送给小稿 @小稿 我已经搜集了关于 AI 技术发展趋势的最新情报，主要包括：[情报内容]4. 小稿 → 小视：小稿撰写文章并向小视提出配图需求 @小视 文章初稿已完成，请根据内容生成封面和插图5. 小视 → 小稿：小视完成配图并整合 @小稿 封面和插图已生成，已整合到文章中6. 小稿 → 小波：小稿提交最终版本 @小波 文章已完成，请审核7. 小波 → 用户：小波向用户汇报成果 文章已完成，主题为"AI 技术发展趋势"，已包含封面和插图，可以直接发布。
测试 5：测试机器人之间通信
由于配置了 agentToAgent.enabled: true，机器人之间可以在飞书群聊中直接通信。测试机器人之间的自主协作：
1. 测试小稿和小探之间的通信 @小探 请帮我搜集一下关于"OpenClaw 2026.3.22"的最新信息• 预期：小探直接回复小稿，提供相关信息 • 在编辑部群中，小稿直接@小探索要情报 2. 测试小稿和小视之间的通信 @小视 请根据这篇文章的主题生成一张封面图• 预期：小视直接回复小稿，提供封面图 • 在编辑部群中，小稿直接@小视提出配图需求 3. 测试多机器人协作 @小探 @小视 我们需要写一篇关于"AI 技术发展趋势"的文章。小探，请搜集相关情报；小视，准备配图。• 预期：小探和小视分别回复小稿，提供各自的信息 • 在编辑部群中，小稿同时@小探和小视
机器人之间通信的优势：
• 无需用户转发，机器人之间可以直接沟通 • 提高协作效率，减少中间环节 • 机器人可以自主协调，实现更智能的工作流程
测试 6：检查日志
# 查看 OpenClaw 日志openclaw logs -f# 查看飞书通道日志openclaw channels logs# 查看特定 Agent 的会话openclaw agents xiaobo --sessions listopenclaw agents xiaogao --sessions listopenclaw agents xiaotan --sessions listopenclaw agents xiaoshi --sessions list常见问题
问题 1：Agent 创建失败
症状：执行 openclaw agents add 命令时报错
可能原因：
• 工作空间目录不存在 • 工作空间目录权限不足 • 模型配置错误
解决方案：
# 检查工作空间目录ls -la ~/.openclaw/workspaces# 确保目录存在且有写权限mkdir -p ~/.openclaw/workspaces/xiaobochmod 755 ~/.openclaw/workspaces/xiaobo# 验证模型配置openclaw config get models.providers.iflow问题 2：飞书机器人不回复
症状：在飞书中 @ 机器人，机器人不回复
可能原因：
• 飞书应用未正确发布 • 事件订阅未正确配置 • OpenClaw 配置错误 • 网络连接问题
解决方案：
# 检查飞书通道状态openclaw channels status# 查看飞书通道日志openclaw channels logs# 检查 OpenClaw 配置openclaw config get channels.feishu# 重启 OpenClaw 服务openclaw gateway restart问题 3：多个 Agent 响应同一个消息
症状：在编辑部群中 @ 某个 Agent，多个 Agent 同时回复
可能原因：
• 绑定配置错误 • 路由规则冲突
解决方案：检查 bindings 数组配置：
# 编辑配置文件nano ~/.openclaw/openclaw.json# 检查 bindings 数组# 确保每个 binding 的 match.accountId 唯一且正确确保 bindings 数组配置正确：
{ "bindings": [ { "agentId": "xiaogao", "match": { "channel": "feishu", "accountId": "xiaogao" } }, { "agentId": "xiaotan", "match": { "channel": "feishu", "accountId": "xiaotan" } }, { "agentId": "xiaoshi", "match": { "channel": "feishu", "accountId": "xiaoshi" } } ]}问题 4：Agent 记忆混乱
症状：不同 Agent 之间的记忆相互干扰
可能原因：
• 会话作用域配置错误 • 工作空间配置错误
解决方案：
# 检查会话作用域配置openclaw config get session.dmScope# 确保配置为 per-account-channel-peeropenclaw config set session.dmScope 'per-account-channel-peer'# 检查每个 Agent 的工作空间# 编辑配置文件查看 agents.list 数组中每个 Agent 的 workspace 字段nano ~/.openclaw/openclaw.json确保每个 Agent 的 workspace 字段指向独立的工作空间目录。
问题 5：视觉 Agent 无法生成图像
症状：小视无法生成封面或插图
可能原因：
• 模型配置错误（未使用视觉模型） • 模型权限不足
解决方案：
视觉 Agent（小视）默认使用 agents.defaults 中配置的模型。如果需要使用特定的视觉模型，可以通过以下方式配置：
方式 1：在绑定配置中指定模型
{ "bindings": [ { "agentId": "xiaoshi", "match": { "channel": "feishu", "accountId": "xiaoshi" }, "model": { "primary": "iflow/qwen3-vl-plus" } } ]}方式 2：确保视觉模型在默认模型列表中
{ "agents": { "defaults": { "models": { "iflow/qwen3-vl-plus": {}, "iflow/Kimi-K2": {} } } }}然后在飞书中明确要求小视使用视觉模型：
@小视 请使用 qwen3-vl-plus 模型生成一张封面图附录
A. 完整配置文件示例
完整的 openclaw.json 配置文件示例：
{ "meta": { "lastTouchedVersion": "2026.3.22", "lastTouchedAt": "2026-03-24T13:10:05.379Z" }, "wizard": { "lastRunAt": "2026-03-23T14:33:32.026Z", "lastRunVersion": "2026.3.22", "lastRunCommand": "onboard", "lastRunMode": "local" }, "models": { "providers": { "iflow": { "baseUrl": "https://apis.iflow.cn/v1", "apiKey": "sk-************************", "api": "openai-completions", "models": [ { "id": "Kimi-K2", "name": "Kimi-K2", "contextWindow": 128000, "maxTokens": 32000 }, { "id": "Qwen3-Coder-Plus", "name": "Qwen3-Coder-Plus", "contextWindow": 128000, "maxTokens": 32000 }, { "id": "qwen3-vl-plus", "name": "qwen3-vl-plus", "contextWindow": 128000, "maxTokens": 32000 }, { "id": "DeepSeek-R1", "name": "DeepSeek-R1", "contextWindow": 128000, "maxTokens": 32000 }, { "id": "DeepSeek-V3-671B", "name": "DeepSeek-V3-671B", "contextWindow": 128000, "maxTokens": 32000 }, { "id": "qwen3-32b", "name": "qwen3-32b", "contextWindow": 128000, "maxTokens": 32000 } ] } } }, "agents": { "defaults": { "model": { "primary": "iflow/Kimi-K2" }, "models": { "iflow/Kimi-K2": {}, "iflow/Qwen3-Coder-Plus": {}, "iflow/qwen3-vl-plus": {}, "iflow/DeepSeek-R1": {}, "iflow/DeepSeek-V3-671B": {}, "iflow/qwen3-32b": {} }, "workspace": "/home/openclaw/.openclaw/workspace" }, "list": [ { "id": "main" }, { "id": "xiaobo", "name": "xiaobo", "workspace": "/home/openclaw/.openclaw/workspaces/xiaobo", "agentDir": "/home/openclaw/.openclaw/agents/xiaobo/agent" }, { "id": "xiaogao", "name": "xiaogao", "workspace": "/home/openclaw/.openclaw/workspaces/xiaogao", "agentDir": "/home/openclaw/.openclaw/agents/xiaogao/agent" }, { "id": "xiaotan", "name": "xiaotan", "workspace": "/home/openclaw/.openclaw/workspaces/xiaotan", "agentDir": "/home/openclaw/.openclaw/agents/xiaotan/agent" }, { "id": "xiaoshi", "name": "xiaoshi", "workspace": "/home/openclaw/.openclaw/workspaces/xiaoshi", "agentDir": "/home/openclaw/.openclaw/agents/xiaoshi/agent" } ] }, "tools": { "profile": "coding", "sessions": { "visibility": "all" }, "agentToAgent": { "enabled":true, "allow": [ "xiaobo", "xiaogao", "xiaotan", "xiaoshi" ] } }, "bindings": [ { "agentId": "xiaobo", "match": { "channel": "feishu", "accountId": "xiaobo", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaobo", "match": { "channel": "feishu", "accountId": "xiaobo" } }, { "agentId": "xiaogao", "match": { "channel": "feishu", "accountId": "xiaogao", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaotan", "match": { "channel": "feishu", "accountId": "xiaotan", "peer": { "kind": "group", "id": "oc_************************" } } }, { "agentId": "xiaoshi", "match": { "channel": "feishu", "accountId": "xiaoshi", "peer": { "kind": "group", "id": "oc_************************" } } } ], "commands": { "native": "auto", "nativeSkills": "auto", "restart":true, "ownerDisplay": "raw" }, "channels": { "feishu": { "enabled":true, "connectionMode": "websocket", "domain": "feishu", "groupPolicy": "open", "groups": { "oc_************************": { "requireMention":false, "enabled":true } }, "accounts": { "default": "xiaobo", "xiaobo": { "appId": "cli_*************", "appSecret": "************************", "name": "小波（总经理）", "description": "总经理，负责统筹管理", "groupPolicy": "open", "dmPolicy": "open", "allowFrom": [ "*" ], "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } }, "xiaogao": { "appId": "cli_*************", "appSecret": "************************", "name": "小稿（主编）", "description": "主编，负责编写公众号文章", "groupPolicy": "open", "enabled":true, "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } }, "xiaotan": { "appId": "cli_*************", "appSecret": "************************", "name": "小探（情报员）", "description": "情报员，负责搜集各大网站最新情报", "groupPolicy": "open", "enabled":true, "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } }, "xiaoshi": { "appId": "cli_*************", "appSecret": "************************", "name": "小视（视觉）", "description": "视觉，负责文档美化、封面和插图生成", "groupPolicy": "open", "enabled":true, "groups": { "oc_************************": { "requireMention":false, "enabled":true, "allowFrom": [ "*" ] } } } } } }, "gateway": { "port": 18789, "mode": "local", "bind": "loopback", "controlUi": { "allowInsecureAuth":true, "dangerouslyDisableDeviceAuth":true }, "auth": { "mode": "token", "token": "********************************" }, "tailscale": { "mode": "off", "resetOnExit":false } }, "plugins": { "entries": { "feishu": { "enabled":true } } }}B. 常用命令速查
# Agent 管理openclaw agents list # 列出所有 Agentopenclaw agents add <name> # 创建 Agentopenclaw agents delete <name> # 删除 Agentopenclaw agents <name> --sessions list # 列出 Agent 的会话# 配置管理openclaw config get <path> # 获取配置openclaw config set <path> <value> # 设置配置openclaw config list # 列出所有配置# 通道管理openclaw channels list # 列出所有通道openclaw channels status # 查看通道状态openclaw channels logs # 查看通道日志# 服务管理openclaw start # 启动服务openclaw stop # 停止服务openclaw restart # 重启服务openclaw status # 查看状态openclaw logs -f # 查看日志# 网关管理openclaw gateway start # 启动网关openclaw gateway stop # 停止网关openclaw gateway restart # 重启网关C. 扩展建议
1. 添加更多部门
将来可以添加其他部门，例如：
• 技术部：技术开发、维护 • 市场部：市场推广、客户关系 • 运营部：日常运营、数据分析
2. 添加更多 Agent
每个部门可以添加更多岗位的 Agent：
• 编辑部：校对员、排版师 • 技术部：前端开发、后端开发、测试工程师 • 市场部：文案策划、活动策划 • 运营部：数据分析师、用户运营
3. 添加更多飞书群
为不同的部门创建不同的飞书群：
• 技术部群 • 市场部群 • 运营部群 • 跨部门协作群
4. 添加更多技能（Skills）
为 Agent 添加更多专业技能：
• Web 搜索技能 • 文件处理技能 • 数据分析技能 • 图像处理技能
总结
本文档详细介绍了如何使用 OpenClaw 2026.3.13 版本配置多 Agent 系统，并与飞书机器人进行整合。通过本文档，您可以：
1. 创建多个独立的 Agent，每个对应一个飞书机器人 2. 配置独立的工作空间和人设 3. 实现智能的消息路由和协作流程 4. 建立层级化的管理体系
关键要点
• 每个 Agent 独立：独立的工作空间、人设、记忆和模型配置 • 飞书机器人独立：每个 Agent 对应一个独立的飞书机器人账号 • 消息路由智能：通过群组和点对点消息实现智能分发 • 层级管理清晰：总经理 → 部门 → 员工的三级管理体系
下一步
1. 按照本文档完成配置 2. 进行全面的测试验证 3. 根据实际使用情况调整配置 4. 根据需求扩展更多 Agent 和部门
文档版本：v1.1最后更新：2026年3月24日适用版本：OpenClaw 2026.3.22 (4dcc39c)
