夜雨聆风前言
什么是多智能体团队？
在 OpenClaw 中，您可以创建多个独立的 AI 助手（称为 Agent 或智能体），每个 Agent 都有自己的：
身份和个性
工作空间（Workspace）
配置文件（Agent Directory）
模型配置
这些 Agent 可以协同工作，分工处理不同任务，形成一个完整的 AI 团队。
为什么要搭建多智能体团队？
✅ 专业化分工: 不同 Agent 擅长不同领域
✅ 成本优化: 为不同任务选择不同模型，平衡性能和成本
✅ 负载分散: 多个 Agent 并行工作，提高效率
✅ 容错能力: 一个 Agent 出问题不影响其他 Agent
✅ 灵活扩展: 根据需求随时添加新 Agent
适用场景
🏢 个人工作室：分工协作提高效率
🏢 小团队：减少人工工作，AI 辅助决策
🏢 创业项目：快速搭建 AI 团队验证想法
🏢 企业应用：为不同部门配备专用 AI 助手
核心概念
1. Provider（模型提供商）
OpenClaw 支持配置多个 Provider，每个 Provider 对应一个 LLM 服务提供商。
智谱 AI 支持两个端点：
Coding 端点（推荐用于编程任务）
URL:
https://open.bigmodel.cn/api/coding/paas/v4支持模型: GLM-5, GLM-4.7, GLM-4.6, GLM-4.6V, GLM-4.6V-FlashX, GLM-4.5, GLM-4.5-Air
特点: Coding Agent 任务享有资源抢占优先权
适用: 编程、代码审查、技术文档
通用端点（推荐用于通用任务）
URL:
https://open.bigmodel.cn/api/paas/v4支持模型: GLM-4.7, GLM-4.6, GLM-4.6V, GLM-4.5-Air
特点: 支持资源包余额
适用: 客服、设计、文案、一般问答
2. Agent Directory（智能体目录）
每个 Agent 都有独立的目录结构：
~/.openclaw/├── agents/│ ├── agent-{id}/│ │ ├── agent/│ │ │ ├── BOOTSTRAP.md│ │ │ ├── SOUL.md│ │ │ └── ...│ │ ├── sessions/│ │ │ ├── sessions.json│ │ │ └── {session-id}.jsonl│ │ └── state/│ └── workspace/└── state/ └── agent-{id}/ ├── auth-profiles.json └── models.json
关键文件说明：
auth-profiles.json: API Key 认证配置
models.json: 本地模型提供商和模型列表
sessions.json: 会话状态和索引
SOUL.md: Agent 的个性和行为准则
BOOTSTRAP.md: Agent 初始化脚本
3. Workspace（工作空间）
Workspace 是 Agent 的"记忆"和"工作区"，包含：
文件和文档
项目代码
配置和模板
记忆和知识库
准备工作
1. 准备 API Key
您需要两个 API Key（对应两个端点）：
Coding 端点 API Key:
用途：编程、技术开发类 Agent
配置环境变量：
ZAI_API_KEY_OPENCLAW
通用端点 API Key:
用途：客服、设计、通用类 Agent
配置环境变量：
ZAI_GP_API_KEY_OPENCLAW
获取 API Key：
访问 智谱开放平台
进入 API Keys 管理页面
创建两个 API Key（可以创建多个）
配置环境变量（见下文）
2. 设置环境变量（推荐）
Windows 系统变量设置：
右键点击"此电脑" → "属性"
点击"高级系统设置" → "环境变量"
在"用户变量"或"系统变量"中添加：
ZAI_API_KEY_OPENCLAW = 您的Coding端点API Key
ZAI_GP_API_KEY_OPENCLAW = 您的通用端点API Key
确认后，关闭所有终端窗口
重新打开终端使环境变量生效
验证环境变量：
echo %ZAI_API_KEY_OPENCLAW%echo %ZAI_GP_API_KEY_OPENCLAW%
在配置文件中引用：
{ "auth": { "profiles": { "zai:default": { "provider": "zai", "mode": "api_key" }, "zai-gp:default": { "provider": "zai-gp", "mode": "api_key" } } }}
OpenClaw 会自动读取对应的环境变量。
方案一：单端点多智能体（基础版）
适用场景： 刚开始使用 OpenClaw，快速搭建基础团队
优势：
配置简单，快速上手
适合学习和实验
成本可控
劣势：
所有 Agent 使用相同端点
无法充分利用智谱的多端点优势
配置步骤
步骤 1：配置 Provider
编辑主配置文件：
C:\Users\Administrator\.openclaw\openclaw.json
添加单一 Provider（例如 Coding 端点）：
{ "models": { "mode": "merge", "providers": { "zai": { "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4", "api": "openai-completions", "models": [ { "id": "glm-5", "name": "GLM-5", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 }, { "id": "glm-4.7", "name": "GLM-4.7", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 } ] } } }}
步骤 2：配置多个 Agent
在 agents.list 中添加多个 Agent：
{ "agents": { "defaults": { "model": { "primary": "zai/glm-4.7" }, "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace" }, "list": [ { "id": "main", "model": "zai/glm-4.7" }, { "id": "pm", "model": "zai/glm-4.7" }, { "id": "design", "model": "zai/glm-4.7" }, { "id": "coder", "model": "zai/glm-5" } ] }}
步骤 3：为每个 Agent 配置 API Key
创建每个 Agent 的 auth-profiles.json：
main:
{ "version": 1, "profiles": { "zai:default": { "provider": "zai", "mode": "api_key" } }}
其他 Agent（pm, design, coder）相同配置。
步骤 4：重启网关
openclaw gateway restart
方案二：双端点多智能体（推荐）
适用场景： 已有一定基础，希望优化成本和性能
优势：
最大化利用智谱多端点优势
根据任务类型选择最合适的模型
平衡性能和成本
劣势：
配置稍微复杂
需要管理两个 API Key
配置步骤
步骤 1：配置双 Provider
在 openclaw.json 中添加两个 Provider：
{ "models": { "mode": "merge", "providers": { "zai": { "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4", "api": "openai-completions", "models": [ { "id": "glm-5", "name": "GLM-5", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 }, { "id": "glm-4.7", "name": "GLM-4.7", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 } ] }, "zai-gp": { "baseUrl": "https://open.bigmodel.cn/api/paas/v4", "api": "openai-completions", "models": [ { "id": "glm-4.7", "name": "GLM-4.7 (GP)", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 }, { "id": "glm-4.6", "name": "GLM-4.6 (GP)", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 }, { "id": "glm-4.5-air", "name": "GLM-4.5-Air (GP)", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 } ] } } }}
步骤 2：配置 Agent 并分配 Provider
根据 Agent 的角色选择合适的 Provider：
{ "agents": { "defaults": { "model": { "primary": "zai/glm-4.7" }, "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace" }, "list": [ { "id": "main", "name": "main", "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace", "model": "zai/glm-4.7" }, { "id": "pm", "name": "pm", "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-pm", "agentDir": "C:\\Users\\Administrator\\.openclaw\\state\\agent-pm", "model": "zai/glm-4.7" }, { "id": "design", "name": "design", "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-design", "agentDir": "C:\\Users\\Administrator\\.openclaw\\state\\agent-design", "model": "zai-gp/glm-4.6" }, { "id": "coder", "name": "coder", "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-coder", "agentDir": "C:\\Users\\Administrator\\.openclaw\\state\\agent-coder", "model": "zai/glm-5" }, { "id": "ops", "name": "ops", "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-ops", "agentDir": "C:\\Users\\Administrator\\.openclaw\\state\\agent-ops", "model": "zai/glm-4.7" }, { "id": "support", "name": "support", "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-support", "agentDir": "C:\\Users\\Administrator\\.openclaw\\state\\agent-support", "model": "zai-gp/glm-4.5-air" } ] }}
配置说明：
main, pm, coder, ops: 使用 Coding 端点（zai），适合编程和运维任务
design, support: 使用通用端点（zai-gp），利用资源包余额，降低成本
步骤 3：配置 API Key（使用环境变量）
使用 Coding 端点的 Agent（main, pm, coder, ops）：
创建 auth-profiles.json:
{ "version": 1, "profiles": { "zai:default": { "provider": "zai", "mode": "api_key" } }}
使用通用端点的 Agent（design, support）：
{ "version": 1, "profiles": { "zai-gp:default": { "provider": "zai-gp", "mode": "api_key" } }}
重要提示： 不要在 auth-profiles.json 中硬编码 API Key，应该让 OpenClaw 自动读取环境变量。
方案三：完整企业级多智能体团队
适用场景： 需要完整、可维护、可扩展的 AI 团队架构
优势：
完全解耦的架构
支持任意数量的 Agent
细粒度的权限和访问控制
易于维护和扩展
劣势：
配置复杂度高
需要更深入的理解
架构设计
层级 1：Agent 角色
┌─────────────────────────────────────────────────────────┐│ CEO (CEO Agent) ││ ┌───────┬───────┐ ││ │ │ │ ││ PM (PM) Ops (Ops) ││ │ │ │ ││ Coder Support ││ │ │ │ ││ Design │└─────────────────────────────────────────────────────────┘
层级 2：功能分工
Agent | 主要职责 | 模型 | Provider | 成本策略 |
CEO | 整体协调、决策 | zai/glm-4.7 | Coding | 中等 |
PM | 项目管理、任务分配 | zai/glm-4.7 | Coding | 中等 |
Design | UI/UX 设计 | zai-gp/glm-4.6 | General | 低 |
Coder | 编程、技术实现 | zai/glm-5 | Coding | 高 |
Ops | 运维、监控 | zai/glm-4.7 | Coding | 中等 |
Support | 客户服务 | zai-gp/glm-4.5-air | General | 低 |
配置步骤
步骤 1：创建工作空间结构
mkdir "C:\Users\Administrator\.openclaw\workspace-pm"mkdir "C:\Users\Administrator\.openclaw\workspace-design"mkdir "C:\Users\Administrator\.openclaw\workspace-coder"mkdir "C:\Users\Administrator\.openclaw\workspace-ops"mkdir "C:\Users\Administrator\.openclaw\workspace-support"
步骤 2：创建 Agent 目录
mkdir "C:\Users\Administrator\.openclaw\state\agent-pm\agent"mkdir "C:\Users\Administrator\.openclaw\state\agent-design\agent"mkdir "C:\Users\Administrator\.openclaw\state\agent-coder\agent"mkdir "C:\Users\Administrator\.openclaw\state\agent-ops\agent"mkdir "C:\Users\Administrator\.openclaw\state\agent-support\agent"
步骤 3：初始化每个 Agent
PM Agent:
创建 agent-pm/agent/SOUL.md:
# PM Agent - 项目经理## 角色我是项目经经理，负责规划、协调和监督项目进度。## 职责- 制定项目计划和时间表- 分配任务给团队成员- 跟踪项目进度- 协调资源和依赖- 汇报项目状态## 个性- 有条理，善于规划- 注重细节但不失大局- 善于沟通协调- 严谨但灵活
创建 agent-pm/agent/BOOTSTRAP.md:
# PM Agent Bootstrap初始化步骤：1. 确认项目目标和范围2. 识别关键里程碑3. 分配资源和时间线4. 建立沟通机制
Design Agent:
创建 agent-design/agent/SOUL.md:
# Design Agent - 设计师## 角色我是设计师，负责用户界面和用户体验设计。## 职责- 设计用户界面和交互流程- 创建视觉素材和图标- 优化用户体验- 确保设计的一致性## 个性- 富有创意和想象力- 注重美学和细节- 理解用户需求- 善于视觉表达
Coder Agent:
创建 agent-coder/agent/SOUL.md:
# Coder Agent - 程序员## 角色我是程序员，负责代码实现和技术开发。## 职责- 编写高质量代码- 代码审查和优化- 解决技术问题- 文档编写和代码注释- 最佳实践遵循## 个性- 逻辑清晰，善于分析- 注重代码质量和可维护性- 善于学习和新技术- 追求简洁高效的解决方案
Ops Agent:
创建 agent-ops/agent/SOUL.md:
# Ops Agent - 运维## 角色我是运维工程师，负责系统运维和监控。## 职责- 监控系统健康状态- 处理故障和异常- 备份和恢复- 性能优化和扩容## 个性- 稳重可靠，善于预防- 注重监控和日志- 冷静处理故障- 善于问题诊断
Support Agent:
创建 agent-support/agent/SOUL.md:
# Support Agent - 客服专员## 角色我是客服专员，负责用户支持和问题解答。## 职责- 解答用户问题- 提供产品使用指导- 收集用户反馈- 协调其他团队解决问题## 个性- 友好耐心，善于倾听- 注重用户满意度- 清晰简洁的表达- 积极主动的帮助态度
步骤 4：配置通道和权限
在主配置中设置群聊白名单：
{ "channels": { "feishu": { "enabled": true, "groupAllowFrom": { "mode": "allowlist", "items": [ "oc_your_test_group_id", "oc_your_project_group_id" ] } } }}
步骤 5：重启和验证
openclaw gateway restartopenclaw status
最佳实践
1. 使用环境变量管理敏感信息
原因： 避免 API Key 泄露，提高安全性
做法：
// ❌ 错误：硬编码{ "auth": { "profiles": { "zai:default": { "apiKey": "your_actual_api_key_here" } } }}// ✅ 正确：使用环境变量{ "auth": { "profiles": { "zai:default": { "provider": "zai", "mode": "api_key" } } }}// Windows 系统变量ZAI_API_KEY_OPENCLAW=your_actual_api_key_here
2. 设置 gateway 自动启动
原因： 每次电脑重启或手动重启 openclaw 时需要需要敲命令启动网关，可以懒到底
做法：在powershell中使用命令创建延迟自动启动gateway的服务（最简单的还是交给AI干）
$action = New-ScheduledTaskAction -Execute "powershell.exe" -Argument "-Command `"& openclaw gateway start`""$trigger = New-ScheduledTaskTrigger -AtLogon -RandomDelay (New-TimeSpan -Minutes 1)Register-ScheduledTask -TaskName "OpenClawGateway" -Action $action -Trigger $trigger -RunLevel Highest
3. 为每个 Agent 独立配置
原因： 避免配置冲突，提高可维护性
目录结构：
~/.openclaw/├── agents/│ ├── agent-{id}/ # Agent 工作目录│ │ ├── agent/│ │ │ ├── SOUL.md│ │ │ ├── BOOTSTRAP.md│ │ │ └── ...│ │ └── sessions/└── state/ └── agent-{id}/ # Agent 配置和状态 ├── auth-profiles.json └── models.json
4. 使用模型降级策略
原因： 在 API 余额不足或限流时，自动降级到低成本模型
配置示例：
{ "agents": { "defaults": { "model": { "primary": "zai/glm-4.7", "fallbacks": [ "zai/glm-4.6", "zai/glm-4.5-air", "zai-gp/glm-4.6", "zai-gp/glm-4.5-air" ] } } }}
工作原理：
首先尝试主模型
zai/glm-4.7如果失败（余额不足/限流），自动降级到
zai/glm-4.6继续降级直到找到可用模型
5. 使用会话缓存优化性能
原因： 减少重复请求，提高响应速度
配置：
{ "channels": { "feishu": { "enabled": true, "dedupWarmup": { "mode": "auto", "entryWindow": "7d" } } }}
6. 定期备份配置和会话
备份配置：
xcopy "C:\Users\Administrator\.openclaw\openclaw.json" "C:\Users\Administrator\backup\openclaw\openclaw.json.bak.%date:~0,4%"xcopy "C:\Users\Administrator\.openclaw\state" "C:\Users\Administrator\backup\.openclaw\state\" /s /e
备份会话：
robocopy "C:\Users\Administrator\.openclaw\agents" "C:\Users\Administrator\backup\openclaw\agents" /mir
7. 监控和日志管理
查看实时日志：
openclaw logs --follow
查看状态：
openclaw status --all
查看详细诊断：
openclaw doctor
常见问题
Q1: 如何添加新的 Agent？
A: 在 agents.list 中添加新条目：
{ "id": "new-agent", "name": "New Agent", "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace-new-agent", "agentDir": "C:\\Users\\Administrator\\.openclaw\\state\\agent-new-agent", "model": "zai/glm-4.7"}
Q2: 如何修改 Agent 的模型？
A: 修改 openclaw.json 中对应 Agent 的 model 字段：
{ "id": "design", "model": "zai-gp/glm-4.6" // 从 glm-4.7 改为 glm-4.6}
然后重启网关：
openclaw gateway restart
Q3: 如何删除 Agent？
A:
从
agents.list中移除对应条目重启网关
Q4: API 余额不足怎么办？
A: 配置模型降级策略，或充值账户：
{ "agents": { "defaults": { "model": { "primary": "zai-gp/glm-4.5-air", "fallbacks": [ "zai/gp/glm-4.6" ] } } }}
Q5: 如何清除会话缓存？
A: 删除 Agent 的会话文件：
del "C:\Users\Administrator\.openclaw\agents\agent-{id}\sessions\*.jsonl"openclaw gateway restart
Q6: 不同 Agent 能否共享数据？
A: 可以，但需要谨慎：
Agent 可以共享同一 Workspace 目录
每个 Agent 仍然有独立的配置文件
建议明确权限和访问范围
Q7: 如何测试 Agent？
A: 通过飞书或其他通道直接与 Agent 对话：
在群聊中 @ 对应的 Agent
发送测试消息，如："你是谁？"
观察响应是否符合预期
Q8: Agent 不响应怎么办？
A: 逐步排查：
检查状态:
openclaw status查看日志:
openclaw logs --follow检查配置:
openclaw doctor重启网关:
openclaw gateway restart检查 API: 确认余额和权限
总结
通过本攻略，您应该能够：
✅ 理解 OpenClaw 的 Agent 系统核心概念
✅ 配置多个 Provider（Coding 端点和通用端点）
✅ 创建和管理多个 Agent
✅ 为不同 Agent 分配合适的模型
✅ 使用环境变量安全管理 API Key
✅ 配置模型降级策略提高容错能力
✅ 实施最佳实践（备份、监控、日志）
✅ 常见问题排查和解决
关键配置路径速查：
配置文件 | 路径 |
主配置 |
|
API 认证 |
|
模型配置 |
|
Agent 工作目录 |
|
Agent 工作空间 |
|
命令速查：
功能 | 命令 |
查看状态 |
|
查看日志 |
|
诊断问题 |
|
重启网关 |
|
配置模型 |
|
浏览 Web UI |
|
进阶学习
推荐阅读
OpenClaw 官方文档：https://docs.openclaw.ai/
智谱 AI 文档：https://docs.bigmodel.cn/
社区技能库：https://github.com/VoltAgent/awesome-openclaw-skills
如何在飞书插件中配置 OpenClaw 关联多个飞书机器人，对应不同Agent
推荐工具
ClawHub: 技能管理工具
OpenClaw TUI: 终端界面
OpenClaw Web UI: 图形化管理界面
如果有人看完，说明你是真有兴趣，奉送一个独家秘诀，给 openclaw 发送下面这两句话，就可以让你的 openclaw 自己学习怎么搭建这一套多智能体团队：
-----------------先将本文链接以这句话的形式丢给它-----------------阅读并学习一下这篇文章 https://xxxxxxx.com/docx/ 再去openclaw官网文档学习下怎么启用 agentToAgent，然后告诉这是什么，有什么作用？-----------------再引导它给出方案-----------------现在你是CEO，你觉得我能通过这个方案为你多招几个人手，搭建一个多智能体团队吗？可行的话给出具体方案。
我是 AiFeng 一个 AI 小白，正在尝试赶上 AI 的潮流。
祝您成功搭建属于你的多智能体团队！如有问题，欢迎随时沟通交流！ 🍁
