OpenClaw 多Agent协作指南

多Agent概述

OpenClaw 支持创建和管理多个 Agent，每个 Agent 可以有独立的配置、技能和记忆。

为什么需要多Agent？

场景分离：

工作 Agent：处理工作相关任务
个人 Agent：处理个人事务
开发 Agent：专注编程和技术问题
学习 Agent：辅助学习和研究

能力专业化：

不同 Agent 使用不同的 AI 模型
不同 Agent 启用不同的技能
不同 Agent 有独立的记忆和上下文

安全隔离：

工作和个人数据分离
不同权限级别
独立的认证和配置

Agent架构

Agent组成

每个 Agent 包含：

~/.openclaw/agents/
├── work/                    # 工作 Agent
│   ├── config.json         # Agent 配置
│   ├── MEMORY.md           # 长期记忆
│   └── memory/             # 每日日志
├── personal/               # 个人 Agent
│   ├── config.json
│   ├── MEMORY.md
│   └── memory/
└── dev/                    # 开发 Agent
    ├── config.json
    ├── MEMORY.md
    └── memory/

Agent配置

每个 Agent 的 config.json：

{
  "name": "work",
  "displayName": "工作助手",
  "description": "处理工作相关任务",
  "model": "anthropic:claude-opus-4.6",
  "skills": ["github", "slack", "notion"],
  "channels": ["telegram", "slack"],
  "memory": {
    "enabled": true,
    "path": "~/.openclaw/agents/work"
  },
  "permissions": {
    "fileAccess": "workspace",
    "networkAccess": true,
    "shellAccess": false
  }
}

创建Agent

使用CLI创建

# 创建新 Agent
openclaw agent create work \
  --display-name "工作助手" \
  --model "anthropic:claude-opus-4.6" \
  --skills "github,slack,notion"

# 查看 Agent 列表
openclaw agent list

# 查看 Agent 详情
openclaw agent info work

手动创建

# 创建 Agent 目录
mkdir -p ~/.openclaw/agents/work

# 创建配置文件
cat > ~/.openclaw/agents/work/config.json << 'EOF'
{
  "name": "work",
  "displayName": "工作助手",
  "model": "anthropic:claude-opus-4.6",
  "skills": ["github", "slack", "notion"]
}
EOF

# 初始化记忆
touch ~/.openclaw/agents/work/MEMORY.md
mkdir -p ~/.openclaw/agents/work/memory

配置Agent

基本配置

# 设置 Agent 模型
openclaw agent config work --model "anthropic:claude-opus-4.6"

# 启用技能
openclaw agent config work --skills "github,slack,notion"

# 配置消息平台
openclaw agent config work --channels "telegram,slack"

高级配置

# 配置权限
openclaw agent config work --permissions '{
  "fileAccess": "workspace",
  "networkAccess": true,
  "shellAccess": false
}'

# 配置记忆
openclaw agent config work --memory '{
  "enabled": true,
  "retention": 30
}'

# 配置工作空间
openclaw agent config work --workspace "~/work"

Agent路由

基于平台的路由

为不同消息平台配置不同的 Agent：

# Telegram 使用个人 Agent
openclaw config set routing.channels.telegram.agent "personal"

# Slack 使用工作 Agent
openclaw config set routing.channels.slack.agent "work"

# Discord 使用开发 Agent
openclaw config set routing.channels.discord.agent "dev"

基于用户的路由

为不同用户配置不同的 Agent：

# 用户 A 使用工作 Agent
openclaw config set routing.users.userA.agent "work"

# 用户 B 使用个人 Agent
openclaw config set routing.users.userB.agent "personal"

基于关键词的路由

根据消息内容路由到不同 Agent：

# 包含"代码"关键词的消息路由到开发 Agent
openclaw config set routing.keywords.code.agent "dev"

# 包含"会议"关键词的消息路由到工作 Agent
openclaw config set routing.keywords.meeting.agent "work"

默认Agent

# 设置默认 Agent
openclaw config set routing.default "personal"

Agent切换

手动切换

# 切换到工作 Agent
openclaw agent switch work

# 切换到个人 Agent
openclaw agent switch personal

# 查看当前 Agent
openclaw agent current

在对话中切换

在消息平台中使用命令切换：

/agent work      # 切换到工作 Agent
/agent personal  # 切换到个人 Agent
/agent list      # 查看可用 Agent

Agent示例配置

工作Agent

专注于工作任务和团队协作。

{
  "name": "work",
  "displayName": "工作助手",
  "description": "处理工作相关任务",
  "model": "anthropic:claude-opus-4.6",
  "skills": [
    "github",
    "slack",
    "notion",
    "google-workspace",
    "trello"
  ],
  "channels": ["slack", "teams"],
  "workingHours": {
    "start": "09:00",
    "end": "18:00",
    "timezone": "Asia/Shanghai"
  },
  "permissions": {
    "fileAccess": "~/work",
    "networkAccess": true,
    "shellAccess": true
  }
}

MEMORY.md 示例：

# 工作信息

## 团队
- 团队名称：开发团队
- 成员：Alice, Bob, Charlie
- 项目管理：Notion
- 代码仓库：GitHub

## 项目
- 主要项目：LearnAISimply
- 技术栈：Next.js + FastAPI
- 部署：Vercel + AWS

## 工作流程
- 每日站会：10:00
- 代码审查：下午
- 部署时间：周五下午

## 常用命令
- 启动开发：npm run dev
- 运行测试：npm test
- 部署：npm run deploy

个人Agent

处理个人事务和日常任务。

{
  "name": "personal",
  "displayName": "个人助手",
  "description": "处理个人事务",
  "model": "anthropic:claude-sonnet-4.6",
  "skills": [
    "weather",
    "apple-reminders",
    "apple-notes",
    "spotify-player"
  ],
  "channels": ["telegram", "whatsapp"],
  "permissions": {
    "fileAccess": "~/personal",
    "networkAccess": true,
    "shellAccess": false
  }
}

MEMORY.md 示例：

# 个人信息

## 基本信息
- 姓名：张三
- 生日：1990-01-01
- 城市：北京

## 日常习惯
- 起床时间：7:00
- 工作时间：9:00-18:00
- 运动时间：19:00

## 兴趣爱好
- 阅读、编程、音乐
- 喜欢的音乐：古典、爵士

## 重要日期
- 家人生日
- 纪念日

开发Agent

专注于编程和技术问题。

{
  "name": "dev",
  "displayName": "开发助手",
  "description": "编程和技术支持",
  "model": "openai:gpt-4",
  "skills": [
    "coding-agent",
    "github",
    "gh-issues",
    "tmux"
  ],
  "channels": ["discord", "webchat"],
  "permissions": {
    "fileAccess": "~/projects",
    "networkAccess": true,
    "shellAccess": true
  }
}

MEMORY.md 示例：

# 开发环境

## 技术栈
- 语言：TypeScript, Python
- 框架：Next.js, FastAPI
- 数据库：PostgreSQL, Redis
- 工具：VS Code, Git, Docker

## 编码规范
- 使用 2 空格缩进
- 使用 Conventional Commits
- 代码审查必须通过

## 常用仓库
- github.com/username/project1
- github.com/username/project2

## 开发流程
1. 创建功能分支
2. 编写代码和测试
3. 提交 PR
4. 代码审查
5. 合并到主分支

学习Agent

辅助学习和研究。

{
  "name": "learning",
  "displayName": "学习助手",
  "description": "学习和研究支持",
  "model": "google:gemini-pro",
  "skills": [
    "summarize",
    "obsidian",
    "notion"
  ],
  "channels": ["webchat"],
  "permissions": {
    "fileAccess": "~/learning",
    "networkAccess": true,
    "shellAccess": false
  }
}

Agent协作

Agent间通信

Agent 可以相互通信和协作：

# 配置 Agent 间通信
openclaw config set agents.communication.enabled true

# Agent A 请求 Agent B 帮助
# 在对话中：
你：@work 帮我查一下项目进度
工作Agent：让我问一下开发助手...
工作Agent：@dev 项目进度如何？
开发Agent：当前进度 80%，预计本周完成

任务委派

将任务委派给其他 Agent：

# 配置任务委派
openclaw config set agents.delegation.enabled true

# 示例：
个人Agent：这是一个技术问题，让我转给开发助手
个人Agent：[委派给 dev Agent]
开发Agent：我来处理这个技术问题...

共享记忆

Agent 间共享特定记忆：

# 配置共享记忆
openclaw config set agents.sharedMemory.enabled true
openclaw config set agents.sharedMemory.path "~/.openclaw/shared"

# 创建共享记忆文件
mkdir -p ~/.openclaw/shared
touch ~/.openclaw/shared/SHARED_MEMORY.md

Agent管理

启动和停止

# 启动特定 Agent
openclaw agent start work

# 停止 Agent
openclaw agent stop work

# 重启 Agent
openclaw agent restart work

# 启动所有 Agent
openclaw agent start --all

监控Agent

# 查看 Agent 状态
openclaw agent status

# 查看 Agent 日志
openclaw agent logs work

# 查看 Agent 统计
openclaw agent stats work

备份和恢复

# 备份 Agent
openclaw agent backup work --output work-backup.zip

# 恢复 Agent
openclaw agent restore --input work-backup.zip

# 克隆 Agent
openclaw agent clone work work-copy

删除Agent

# 删除 Agent（保留数据）
openclaw agent delete work --keep-data

# 完全删除 Agent
openclaw agent delete work --purge

最佳实践

1. 明确职责

每个 Agent 应该有明确的职责范围：

避免职责重叠
清晰的边界
专业化配置

2. 合理分配资源

根据使用频率分配资源：

常用 Agent 使用更强的模型
低频 Agent 使用经济模型
合理配置技能

3. 统一命名规范

使用清晰的命名：

work - 工作相关
personal - 个人事务
dev - 开发任务
learning - 学习研究

4. 定期维护

定期检查和维护 Agent：

清理过期记忆
更新配置
检查性能

5. 安全配置

为每个 Agent 配置适当的权限：

最小权限原则
敏感 Agent 加强保护
定期审查权限

6. 文档记录

为每个 Agent 编写文档：

用途说明
配置说明
使用指南

常见问题

Agent切换失败

原因：

Agent 未启动
配置错误
权限不足

解决：

# 检查 Agent 状态
openclaw agent status

# 启动 Agent
openclaw agent start work

# 验证配置
openclaw agent validate work

Agent响应慢

原因：

模型选择不当
技能过多
记忆文件过大

解决：

# 使用更快的模型
openclaw agent config work --model "anthropic:claude-haiku-4.0"

# 减少技能
openclaw agent config work --skills "github,slack"

# 清理记忆
openclaw agent memory cleanup work --days 30

Agent记忆混乱

原因：

多 Agent 共享记忆
记忆文件冲突

解决：

# 确保独立记忆
openclaw agent config work --memory-path "~/.openclaw/agents/work"

# 重置记忆
openclaw agent memory reset work

高级场景

分层Agent架构

创建主Agent和子Agent：

主Agent（协调者）
├── 工作Agent
│   ├── 项目管理子Agent
│   └── 代码审查子Agent
├── 个人Agent
│   ├── 日程管理子Agent
│   └── 健康追踪子Agent
└── 学习Agent
    ├── 阅读笔记子Agent
    └── 知识整理子Agent

动态Agent创建

根据需求动态创建临时 Agent：

# 创建临时 Agent
openclaw agent create temp-project \
  --temporary \
  --lifetime 7d \
  --model "anthropic:claude-sonnet-4.6"

# 临时 Agent 会在 7 天后自动删除

Agent模板

创建 Agent 模板快速部署：

# 创建模板
openclaw agent template create work-template \
  --from work

# 从模板创建 Agent
openclaw agent create new-work \
  --from-template work-template

性能优化

懒加载Agent

只在需要时加载 Agent：

openclaw config set agents.lazyLoad true

Agent缓存

启用 Agent 响应缓存：

openclaw config set agents.cache.enabled true
openclaw config set agents.cache.ttl 3600

并发限制

限制同时运行的 Agent 数量：

openclaw config set agents.concurrency.max 3

最佳实践总结

明确职责：每个 Agent 有清晰的职责范围
合理分配：根据使用频率分配资源
统一命名：使用清晰的命名规范
定期维护：定期检查和更新配置
安全第一：配置适当的权限
文档完善：为每个 Agent 编写文档
监控性能：定期检查 Agent 性能
备份数据：定期备份 Agent 配置和记忆

下一步

掌握多Agent配置后，你可以：

部署到生产：阅读 Docker 部署指南
加固安全：阅读安全配置指南
性能优化：优化 Agent 性能
故障排除：阅读常见问题FAQ

参考资源

多Agent文档：https://docs.openclaw.ai/multi-agent
Agent API参考：https://docs.openclaw.ai/api/agent
最佳实践：https://docs.openclaw.ai/best-practices
社区讨论：https://discord.gg/clawd

OpenClaw 多Agent协作指南：构建专业化AI助手团队

分享这篇文章