1
{
2
  agents: {
3
    defaults: {
4
      workspace: "~/.openclaw/workspace",  // 默认工作区
5
    },
6
  },
7
}

1
{
2
  agents: {
3
    list: [
4
      {
5
        id: "home",
6
        name: "Home",
7
        workspace: "~/.openclaw/workspace-home",
8
        model: "anthropic/claude-sonnet-4-5",
9
        default: true,
10
      },
11
      {
12
        id: "work",
13
        workspace: "~/.openclaw/workspace-work",
14
        model: "anthropic/claude-opus-4-5",
15
      },
16
    ],
17
  },
18
}

1
~/.openclaw/workspace              # 默认
2
~/.openclaw/workspace-<agentId>    # 多 Agent 模式

1
~/.openclaw/workspace/
2
├── AGENTS.md         # 操作指南 + 记忆使用指南
3
├── SOUL.md           # 人设、语气、边界
4
├── USER.md           # 用户档案、称呼偏好
5
├── IDENTITY.md       # Agent 名称、风格、表情
6
├── TOOLS.md          # 本地工具和惯例说明
7
├── HEARTBEAT.md      # 心跳检查清单（可选）
8
├── BOOTSTRAP.md      # 首次运行仪式（完成后删除）
9
├── MEMORY.md         # 长期记忆精选（可选）
10
├── memory/
11
│   └── 2026-02-11.md # 每日记忆日志
12
├── skills/           # Agent 特定的 Skills
13
└── canvas/           # Canvas UI 文件

1
// 文件内容被添加到系统提示词中
2
const prompt = `
3
${readFile("AGENTS.md")}
4
${readFile("SOUL.md")}
5
${readFile("USER.md")}
6
...
7
`;

1
用户: 帮我研究一下 Python 和 JavaScript 的最新趋势
2

3
Agent: 我会启动两个并行研究任务...
4

5
[sessions_spawn x2]

1
{
2
  agents: {
3
    defaults: {
4
      subagents: {
5
        maxConcurrent: 8,                    // 最大并发数
6
        model: "openai/gpt-4o-mini",         // 使用更便宜的模型
7
      },
8
    },
9
  },
10
}

1
{
2
  channels: {
3
    whatsapp: {
4
      accounts: {
5
        personal: {
6
          // authDir: "~/.openclaw/credentials/whatsapp/personal"
7
        },
8
        biz: {
9
          // authDir: "~/.openclaw/credentials/whatsapp/biz"
10
        },
11
      },
12
    },
13
  },
14
}

1
入站消息
2
    │
3
    ▼
4
识别 Channel
5
    │
6
    ▼
7
识别 AccountId
8
    │
9
    ▼
10
检查 Bindings
11
    │
12
    ▼
13
匹配 Peer/Group?
14
    │
15
    ├─ 是 → 路由到指定 Agent
16
    │
17
    ├─ 否 → 匹配 AccountId?
18
    │         │
19
    │         ├─ 是 → 路由到指定 Agent
20
    │         │
21
    │         └─ 否 → 匹配 Channel?
22
    │                   │
23
    │                   ├─ 是 → 路由到指定 Agent
24
    │                   │
25
    │                   └─ 否 → 使用默认 Agent
26
    │
27
Agent 处理消息
28
    │
29
    ▼
30
需要后台任务?
31
    │
32
    ├─ 是 → 启动 Sub-Agent
33
    │         │
34
    │         └─ Sub-Agent 完成后通告
35
    │
36
    └─ 否 → 生成回复
37
              │
38
              ▼
39
        返回原 Channel

1
{
2
  // 1. 定义多个 Agent
3
  agents: {
4
    list: [
5
      {
6
        id: "chat",
7
        name: "日常助手",
8
        workspace: "~/.openclaw/workspace-chat",
9
        model: "anthropic/claude-sonnet-4-5",
10
        default: true,
11
        subagents: {
12
          model: "openai/gpt-4o-mini",  // 子任务用便宜模型
13
        },
14
      },
15
      {
16
        id: "work",
17
        name: "工作助手",
18
        workspace: "~/.openclaw/workspace-work",
19
        model: "anthropic/claude-opus-4-5",
20
        sandbox: { mode: "all" },  // 工作任务用沙箱
21
      },
22
    ],
23
  },
24

25
  // 2. 路由规则：消息如何分配给 Agent
26
  bindings: [
27
    // WhatsApp 私信 -> 日常助手
28
    { agentId: "chat", match: { channel: "whatsapp" } },
29

30
    // Telegram -> 工作助手
31
    { agentId: "work", match: { channel: "telegram" } },
32

33
    // 特定群组 -> 工作助手
34
    {
35
      agentId: "work",
36
      match: {
37
        channel: "whatsapp",
38
        peer: { kind: "group", id: "[email protected]" }
39
      }
40
    },
41
  ],
42

43
  // 3. 渠道配置
44
  channels: {
45
    whatsapp: {
46
      dmPolicy: "allowlist",
47
      allowFrom: ["+15551234567", "+15559876543"],
48
    },
49
    telegram: {
50
      botToken: "${TELEGRAM_BOT_TOKEN}",
51
    },
52
  },
53

54
  // 4. 子智能体配置
55
  tools: {
56
    subagents: {
57
      tools: {
58
        deny: ["sessions_spawn"],  // 子智能体不能再生子智能体
59
      },
60
    },
61
  },
62
}