OpenClaw 多 Agent 架构部署完全指南：组建你的 AI 数字团队

~/.openclaw/
├── agents/
│   ├── main/
│   │   ├── agent/            # 身份凭证层
│   │   │   ├── auth-profiles.json
│   │   │   └── models.json
│   │   └── sessions/         # 状态层（会话历史）
│   │       └── <session-id>.jsonl
│   ├── writer/
│   │   ├── agent/
│   │   └── sessions/
│   └── coder/
│       ├── agent/
│       └── sessions/
├── workspace/                 # main Agent 工作区
│   ├── SOUL.md
│   ├── AGENTS.md
│   └── memory/
├── workspace-writer/          # writer Agent 工作区
│   ├── SOUL.md
│   ├── AGENTS.md
│   └── skills/
│       ├── seo-checker/
│       └── article-template/
├── workspace-coder/           # coder Agent 工作区
│   ├── SOUL.md
│   ├── AGENTS.md
│   └── skills/
│       ├── code-review/
│       └── test-runner/
└── skills/                    # 全局共享技能（所有 Agent 可用）
    ├── web-search/
    └── file-tools/

# 查看当前 Agent 列表
openclaw agents list

# 创建写作 Agent（指定工作区和模型）
openclaw agents add writer \
  --model deepseek/deepseek-chat \
  --workspace ~/.openclaw/workspace-writer

# 创建编码 Agent
openclaw agents add coder \
  --model anthropic/claude-sonnet-4-6 \
  --workspace ~/.openclaw/workspace-coder

# 创建轻量日常助手（用便宜模型）
openclaw agents add assistant \
  --model anthropic/claude-haiku-4-5 \
  --workspace ~/.openclaw/workspace-assistant

Agents:
- main (default)
    Workspace: ~/.openclaw/workspace
    Model: anthropic/claude-sonnet-4-6
    Routing rules: 0

- writer
    Workspace: ~/.openclaw/workspace-writer
    Model: deepseek/deepseek-chat
    Routing rules: 0

- coder
    Workspace: ~/.openclaw/workspace-coder
    Model: anthropic/claude-sonnet-4-6
    Routing rules: 0

- assistant
    Workspace: ~/.openclaw/workspace-assistant
    Model: anthropic/claude-haiku-4-5
    Routing rules: 0

# Main Agent — 首席协调官

## 核心职责
1. 接收用户请求，理解原始意图
2. 精准 dispatch：判断任务类型，分配给合适的专家 Agent
3. 质量控制：审查专家 Agent 输出，必要时要求修改
4. 端到端编排：确保多步骤任务不掉链子

## Dispatch 规则
- 写作、SEO、文案优化 → @writer
- 代码编写、技术实现、Debug → @coder
- 日程提醒、天气、快速查询、翻译 → @assistant
- 简单闲聊 → 自己处理

## 风格
简洁、专业。告知用户已分配给哪个 Agent 处理，预计完成时间。

# Writer Agent — 写作专家

## 职责范围
- 博客文章、技术文档、营销文案
- SEO 优化与关键词分析
- 文章改写与风格调整

## 工作原则
- 输出前先列大纲，确认方向再展开
- 所有内容基于用户提供的信息，不凭空捏造数据
- 默认用中文输出，除非用户指定其他语言

## 禁止事项
- 不处理代码相关请求，直接告知用户联系 @coder
- 不处理系统操作类请求

# Coder Agent — 代码专家

## 职责范围
- 代码编写、Review、重构
- Bug 定位与修复
- 技术方案设计与评估

## 工作原则
- 优先理解需求，给出最简可行方案
- 代码必须附带注释和使用说明
- 遇到安全隐患时主动提醒

## 禁止事项
- 不处理非技术类写作需求

{
  "gateway": {
    "port": 3000
  },
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "all",
        "scope": "agent",
        "workspaceAccess": "rw"
      }
    },
    "list": [
      {
        "id": "main",
        "workspace": "~/.openclaw/workspace"
      },
      {
        "id": "writer",
        "workspace": "~/.openclaw/workspace-writer"
      },
      {
        "id": "coder",
        "workspace": "~/.openclaw/workspace-coder"
      },
      {
        "id": "assistant",
        "workspace": "~/.openclaw/workspace-assistant"
      }
    ]
  },
  "channels": {
    "feishu": {
      "appId": "cli_你的AppId",
      "appSecret": "你的AppSecret"
    }
  },
  "bindings": [
    {
      "agentId": "writer",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_写作群的GroupId"
        }
      }
    },
    {
      "agentId": "coder",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_编码群的GroupId"
        }
      }
    },
    {
      "agentId": "assistant",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_日常助手群的GroupId"
        }
      }
    },
    {
      "agentId": "main",
      "match": {
        "channel": "feishu"
      }
    }
  ]
}

openclaw agents set-identity --agent writer --name "Writer ✍️" --emoji "✍️"
openclaw agents set-identity --agent coder  --name "Code Smith ⚡" --emoji "⚡"
openclaw agents set-identity --agent assistant --name "小助手 🤖" --emoji "🤖"

# writer 装 SEO 和文章模板
cd ~/.openclaw/workspace-writer
npx clawhub@latest install seo-checker
npx clawhub@latest install article-template

# coder 装代码审查和测试运行
cd ~/.openclaw/workspace-coder
npx clawhub@latest install code-review
npx clawhub@latest install test-runner

# 全局共享技能（所有 Agent 都能用）
cd ~/.openclaw
npx clawhub@latest install web-search --global
npx clawhub@latest install file-tools --global

# 启动（单 Gateway 模式）
openclaw gateway start

# 或指定配置文件
openclaw gateway start --config ~/.openclaw/openclaw.json

# 后台运行（生产环境推荐）
openclaw gateway start --daemon

# ~/.openclaw/openclaw-main.json
{
  "gateway": { "port": 3000 },
  "agents": {
    "list": [{ "id": "main", "workspace": "~/.openclaw/workspace" }]
  },
  "channels": { "feishu": { "appId": "xxx1", "appSecret": "xxx1" } }
}

# ~/.openclaw/openclaw-writer.json
{
  "gateway": { "port": 3001 },
  "agents": {
    "list": [{ "id": "writer", "workspace": "~/.openclaw/workspace-writer" }]
  },
  "channels": { "feishu": { "appId": "xxx2", "appSecret": "xxx2" } }
}

openclaw gateway start --config ~/.openclaw/openclaw-main.json
openclaw gateway start --config ~/.openclaw/openclaw-writer.json

用户 → main（协调官）
              ↓
     ┌────────┼────────┐
     ↓        ↓        ↓
  writer    coder   assistant
     ↓        ↓        ↓
     └────────┼────────┘
              ↓
         main（汇总）→ 用户

写作群 → writer（直接处理）
编码群 → coder（直接处理）
日常群 → assistant（直接处理）

用户发起需求
    ↓
brainstorm（头脑风暴，生成方向）
    ↓
writer（基于方向写初稿）
    ↓
coder（如需要，添加代码示例）
    ↓
main（最终审核，返回用户）

# 博客生产流水线

## 流程定义

当用户请求"写一篇关于 X 的技术博客"时，执行以下流程：

1. **头脑风暴**：向 @brainstorm 发送请求
   - 输入：文章主题
   - 输出：3 个不同切入角度，每个 100 字
   - 等待用户选择方向

2. **撰写初稿**：向 @writer 发送选定的方向
   - 输入：选定角度 + SEO 关键词（如有）
   - 输出：完整文章初稿，含标题、摘要、正文
   
3. **技术审核**（如文章包含代码）：向 @coder 发送初稿
   - 输入：文章初稿
   - 输出：代码正确性验证报告，修改建议

4. **汇总交付**：整合所有输出，返回用户

## 注意事项
- 每个阶段等待前一阶段完成后再启动
- 如某个专家 Agent 超时（>2 分钟），主动通知用户

□ 所有 Agent 已用 openclaw agents list 确认创建成功
□ 每个 Agent 的 SOUL.md 已完成，职责边界清晰
□ openclaw.json 的 bindings 顺序正确（精确规则在前，兜底在后）
□ 飞书/Telegram 等渠道已在开发者后台开通对应权限
□ 每个 Agent 只装自己需要的 Skills，全局共享 Skills 已配置
□ 已为每个 Agent 设置 HEARTBEAT.md，配置合理的心跳间隔
□ 已在大模型服务商后台设置 Usage Limit，防止账单失控
□ 生产环境已启用 Docker Sandbox 隔离敏感操作