OpenClaw 多 Agent 飞书 Bot 完整配置指南(OpenClaw-3.2版本已过时)
输入“/”快速插入内容
OpenClaw 多 Agent 飞书 Bot 完整配置指南(OpenClaw-3.2版本已过时)
OpenClaw 多 Agent 飞书 Bot 完整配置指南(OpenClaw-3.2版本已过时)
用户4040用户40403月16日修改
⚠️ 文档已过时 - 请查看新配置指南
重要提示: 本文档基于 OpenClaw 旧版本编写，已不适用于 OpenClaw 3.13+
新文档提供：
OpenClaw 多 Agent 飞书 Bot 完整配置指南
📋 适配多独立 Agent 部署、跨 Agent 协作场景，基于飞书渠道开发
⚠️ 文档版本: v2.1 (已优化) | 最后更新: 2026-03-08
📌 快速导航
章节 | 内容 | 预计时间 |
一 | 核心概念 | 2 分钟 |
二 | 目录结构与路径 | 2 分钟 |
三 | 配置文件完整模板 | 5 分钟 |
四 | [Agent 人设文件模板](#四 agent 人设文件模板) | 3 分钟 |
五 | 飞书应用配置步骤 | 2 分钟 |
六 | 启动与校验 | 1 分钟 |
七 | 问题排查清单 | 1 分钟 |
八 | 高级配置 | 2 分钟 |
一、核心概念
1.1 什么是"一个 Agent"
Agent = 独立的大脑，每个 Agent 拥有：
组件 | 说明 | 路径 |
Workspace | 工作区文件（SOUL.md、AGENTS.md、USER.md 等） | ~/.openclaw/workspace-<agentId>/ |
AgentDir | 状态目录（认证、模型注册、配置） | ~/.openclaw/agents/<agentId>/agent/ |
Sessions | 会话存储（聊天记录 + 路由状态） | ~/.openclaw/agents/<agentId>/sessions/ |
Auth Profiles | 认证配置（每个 Agent 独立） | ~/.openclaw/agents/<agentId>/agent/auth-profiles.json |
1.2 关键术语
术语 | 说明 | 示例 |
agentId | 一个"大脑"（独立工作区 + 独立认证 + 独立会话） | main, dev, content |
accountId | 一个渠道账号实例（如飞书应用 A/B/C） | main, dev, content |
binding | 路由规则：将入站消息路由到 agentId | {agentId: "main", match: {...}} |
peer | 具体的聊天对象（私聊用户 ID 或群聊 ID） | ou_xxx（私聊）, oc_xxx（群聊） |
1.3 多 Agent 应用场景
场景 | 配置方式 | 说明 |
多角色协作 | 6 个 Agent（main/dev/content/ops/law/finance） | 每个 Agent 专注一个领域 |
多渠道分离 | WhatsApp → chat Agent, Telegram → opus Agent | 不同渠道用不同模型 |
多账号管理 | 个人飞书 → home Agent, 工作飞书 → work Agent | 多个飞书应用账号 |
特定人员路由 | 老板消息 → opus Agent, 其他人 → chat Agent | 基于 peer.id 路由 |