Home
avatar

.Sam

OpenClaw多Agent协作完整使用教程

2336字 8.3分钟 openclaw

本文基于OpenClaw v2026.3.13最新官方版本编写，所有信息均来自官方开源仓库：openclaw/openclaw

🦞 一、OpenClaw 概述

OpenClaw是一款可以运行在任意设备、任意平台的个人AI助手，2025年11月开源至今已获得31.1万+Star，5.9万+Fork，是目前全球最受欢迎的开源个人AI Agent运行平台之一。

核心定位

  • 全平台覆盖：支持WhatsApp、Telegram、Slack、飞书、微信等超过30种主流IM平台，同时支持macOS、iOS、Android原生应用
  • 本地优先：数据完全由用户掌控，支持完全本地运行，无需依赖第三方云服务
  • 多Agent原生支持：内置多会话路由能力，可轻松实现多个独立Agent并行工作
  • 高度可扩展：支持自定义技能、自定义工具、自定义角色，适配各种个人/企业场景

🏗️ 二、多Agent协作核心能力

OpenClaw采用网关+多会话的架构设计，天然支持多Agent协作场景：

flowchart TD
    A[用户多渠道请求] --> B[OpenClaw 网关]
    B --> C[会话路由层]
    C --> D[工作Agent 1: 私人助理]
    C --> E[工作Agent 2: 学习助手]
    C --> F[工作Agent 3: 生产力工具]
    C --> G[自定义Agent N: 任意角色]
    D & E & F & G --> H[统一输出到用户请求渠道]

多Agent核心特性

  1. 会话级隔离：每个Agent拥有独立的会话上下文、模型配置、权限范围，互相完全隔离
  2. 智能路由：可基于请求渠道、发件人、关键词等规则，自动将请求分配给对应Agent
  3. Agent间通信：内置sessions_*工具集，支持Agent之间互相发送消息、调取历史记录、协同完成复杂任务
  4. 资源隔离：支持为不同Agent配置不同的模型、工具权限、沙箱环境，保障数据安全

✨ v2026.3.13版本新增多Agent专属特性

  1. 共享Canvas可视化协作：所有Agent可访问同一个共享画布空间，支持在画布上共同编辑文档、绘制流程图、处理图像，协作过程全程可追溯
  2. 移动端细粒度权限分配：原生支持iOS/Android端传感器权限按Agent分配，可实现私人助理可调用手机定位/相机/健康数据，工作Agent完全无权限访问个人隐私数据
  3. 技能自动适配：Agent可根据自身角色定位，自动从ClawHub技能库安装匹配的技能，无需手动配置

🚀 三、快速搭建多Agent系统

环境要求

  • Node.js ≥ 22
  • 支持macOS、Linux、Windows（WSL2）

安装步骤

# 1. 全局安装OpenClaw
npm install -g openclaw@latest
# 或使用pnpm
pnpm add -g openclaw@latest

# 2. 运行引导向导，自动安装守护进程、配置基础环境
openclaw onboard --install-daemon

# 3. 启动网关服务
openclaw gateway --port 18789 --verbose

启动成功后即可访问：

🎬 四、多Agent配置实践

场景：个人+工作双Agent分离配置

步骤1：创建两个独立会话

# 创建个人助理Agent会话
openclaw sessions create --name "私人助理" --description "处理个人生活相关请求" --model "anthropic/claude-opus-4-6"

# 创建工作助理Agent会话
openclaw sessions create --name "工作助理" --description "处理工作相关请求" --model "gpt-4o" --tools "calendar,email,slack"

步骤2：配置路由规则

编辑配置文件~/.openclaw/openclaw.json，添加路由规则：

{
  "routing": {
    "rules": [
      // 工作相关的消息路由到工作助理
      {
        "match": {
          "channel": ["slack", "work-email"],
          "keywords": ["工作", "项目", "会议", "周报"]
        },
        "targetSession": "工作助理"
      },
      // 个人消息路由到私人助理
      {
        "match": {
          "channel": ["whatsapp", "imessage", "personal-email"]
        },
        "targetSession": "私人助理"
      }
    ]
  }
}

步骤3：配置Agent间协作

如需Agent之间协同工作，可在技能配置中启用sessions_*工具：

{
  "agents": {
    "工作助理": {
      "allowedTools": ["sessions_list", "sessions_send", "sessions_history"]
    }
  }
}

配置完成后，工作助理即可主动调取私人助理的日程信息，协调安排工作会议时间等复杂任务。

4.4 多Agent协作实际操作演示

示例1：Agent间消息发送命令使用

工作助理调用sessions_send工具给私人助理发送消息，查询空闲时间：

# 工作助理调用命令示例
openclaw sessions send --to "私人助理" --content "请查询我未来3天的私人日程，找出下午2-4点的空闲时间段，回复给我用于安排客户会议"

私人助理收到消息后自动处理，返回结果给工作助理，工作助理结合工作日历自动生成会议邀请发送给客户，全程无需人工干预。

示例2：多Agent协同完成旅行规划完整流程
  1. 用户发送请求：“帮我规划下周五到周日去杭州的行程”
  2. 路由层自动分配给生活规划Agent处理
  3. 生活规划Agent调用sessions_send给交通Agent：“查询下周五上海到杭州的高铁票，周日返回的票，找时间合适的班次”
  4. 交通Agent查询12306返回班次信息给生活规划Agent
  5. 生活规划Agent调用sessions_send给酒店预订Agent：“根据行程时间，预订西湖附近评分4.8以上、价格500-1000元/晚的酒店”
  6. 酒店预订Agent返回符合条件的酒店选项，生活规划Agent整合所有信息生成完整行程，返回给用户
  7. 用户确认后，所有Agent自动完成购票、预订、行程同步到日历的全流程操作

4.5 v2026.3.13新特性配置方法

开启共享Canvas协作能力

编辑配置文件启用全局共享画布：

{
  "features": {
    "shared_canvas": true,
    "canvas_permissions": {
      "工作助理": ["read", "write"],
      "私人助理": ["read", "write"],
      "客户服务Agent": ["read"]
    }
  }
}

配置完成后，多个Agent可在同一个画布上共同编辑项目方案、旅行行程等内容，所有修改历史可追溯。

移动端权限细粒度分配

在iOS/Android端OpenClaw应用的权限管理页面，可单独为每个Agent配置传感器权限：

{
  "mobile_permissions": {
    "私人助理": ["location", "camera", "health"],
    "工作助理": ["calendar", "work-email"],
    "学习助手": ["photos", "files"]
  }
}

完全避免工作Agent访问个人隐私数据，实现工作生活彻底隔离。

🛠️ 五、自定义Agent开发指南

开发一个自定义Agent仅需3步：

  1. 定义Agent角色配置： 创建文件~/.openclaw/workspace/agents/客户服务Agent.md：
# 角色：客户服务Agent
## 职责
- 友好接待用户咨询，解答产品相关问题
- 对于无法解答的问题，自动转交给技术支持Agent
- 记录所有客户咨询内容，形成工单记录
## 权限
- 允许访问产品知识库
- 允许调用sessions_send工具发送消息给技术支持Agent
- 禁止访问内部业务数据

  1. 配置技能和工具： 在管理后台为该Agent绑定知识库检索、工单生成、消息发送等工具。

  2. 添加路由规则： 将客服渠道的请求自动路由到该Agent，配置完成后即可投入使用。

5.4 ClawHub技能库与多Agent集成使用

ClawHub是OpenClaw官方维护的开源技能市场，目前已有超过1200+官方和社区贡献的技能，可直接安装到对应Agent使用，无需自行开发：

  1. 开启技能自动适配功能：
openclaw config set auto_install_skills true

开启后，每个Agent会根据自身角色自动从ClawHub安装匹配的技能：

  • 私人助理自动安装外卖点单、机票预订、日程管理等生活类技能
  • 工作助理自动安装邮件处理、PPT生成、会议纪要等办公类技能
  • 客户服务Agent自动安装知识库检索、工单生成、用户满意度调查等客服类技能
  1. 手动为指定Agent安装技能：
# 为工作助理安装飞书文档同步技能
openclaw skills install feishu-doc-sync --session "工作助理"

# 为私人助理安装健康数据统计技能
openclaw skills install health-analytics --session "私人助理"
  1. 自定义技能发布到ClawHub： 开发完成的自定义技能可通过命令一键提交到ClawHub，供所有社区用户使用：
openclaw skills publish ./my-custom-skill --public

你也可以创建私有技能仓库，供企业内部所有Agent使用。

❓ 六、常见问题排查

问题现象解决方案
Agent会话之间上下文串了检查会话配置，确认isolation参数设置为full
路由规则不生效运行openclaw doctor检查配置文件语法，确认规则顺序正确
Agent间通信失败检查对应Agent的allowedTools配置，确认已启用sessions_*相关工具
多Agent运行卡顿升级硬件配置，或配置模型负载均衡规则，不同Agent使用不同的模型服务

📈 七、生产环境最佳实践

  1. 权限最小化：为每个Agent分配最小必要的工具和数据权限，避免越权访问
  2. 分级模型配置：简单任务的Agent使用低成本模型，复杂任务的Agent使用高性能模型，平衡成本和效果
  3. 监控告警：开启网关监控，实时监控每个Agent的调用次数、响应时间、错误率等指标
  4. 定期备份：定期备份会话数据和配置，防止数据丢失

更多详细文档可参考官方文档：https://docs.openclaw.ai

AI 多Agent openclaw