1.1 什么是多 Agent 架构#

多 Agent 架构是指在一个 OpenClaw Gateway 进程中运行多个独立的 AI 助手。每个 Agent 有自己独立的：

• Workspace（工作目录）：存放记忆、配置文件
• 模型配置：可以使用不同的 AI 模型
• 工具权限：可以单独配置允许或禁止的工具
• 渠道绑定：可以绑定到不同的通讯渠道

1.2 适用场景#

• 生活和工作分离：家庭用一个 Agent，工作用一个 Agent
• 渠道分流：WhatsApp 日常聊天，Telegram 深度工作
• 权限分级：给不同群组或用户配置不同的 Agent
• 服务隔离：多个业务使用不同的 Agent，互不干扰

2.1 系统要求#

• 操作系统：Windows 10/11 或 Windows Server
• Node.js：Node 24（推荐）或 Node 22 LTS
• 内存：建议 8GB 以上
• 硬盘：至少 5GB 可用空间
• 网络：需要访问 API

2.2 安装 Node.js#

访问 Node.js 官网下载 LTS 版本，然后验证安装：

powershell node --version npm --version

2.3 安装 OpenClaw#

powershell npm install -g openclaw@latest openclaw --version

2.4 获取 API Key#

根据使用的模型提供商获取相应的 API Key。

3.1 基础初始化#

powershell openclaw onboard --install-daemon

3.2 配置环境变量#

powershell = your-api-key-here

4.1 配置文件位置#

配置文件位于：C:\Users<用户名>.openclaw\

4.2 完整配置示例#

json { agents: { list: [ { id: main, name: 主助手, default: true, workspace: C:\\Users\\Rookie\\.openclaw\\workspace-main, model: minimax-cn/MiniMax-M2.5 }, { id: assistant, name: 助理助手, workspace: C:\\Users\\Rookie\\.openclaw\\workspace-assistant, model: minimax-cn/MiniMax-M2.1, sandbox: { mode: all, scope: agent }, tools: { allow: [read, exec, sessions_list], deny: [write, edit] } } ] }, bindings: [ { agentId: main, match: { channel: qqbot, accountId: default } }, { agentId: assistant, match: { channel: telegram, accountId: assistant } } ], channels: { qqbot: { accounts: { default: {} } }, telegram: { accounts: { default: { botToken: YOUR_BOT_TOKEN } } } } }

场景一：QQ 私聊和群聊分离#

json { agents: { list: [ { id: private, name: 私聊助手, workspace: ~/.openclaw/workspace-private }, { id: group, name: 群聊助手, workspace: ~/.openclaw/workspace-group, groupChat: { mentionPatterns: [@小Q] } } ] }, bindings: [ { agentId: group, match: { channel: qqbot, peer: { kind: group } } }, { agentId: private, match: { channel: qqbot, peer: { kind: direct } } } ] }

场景二：日常助手和专业助手#

json { agents: { list: [ { id: chat, name: 日常助手, workspace: ~/.openclaw/workspace-chat, model: minimax-cn/MiniMax-M2.1 }, { id: work, name: 专业助手, workspace: ~/.openclaw/workspace-work, model: minimax-cn/MiniMax-M2.5 } ] }, bindings: [ { agentId: chat, match: { channel: qqbot, accountId: personal } }, { agentId: work, match: { channel: qqbot, accountId: biz } } ] }

场景三：家庭群专用 Agent（带权限限制）#

json { agents: { list: [ { id: family, name: 家庭助手, workspace: ~/.openclaw/workspace-family, identity: { name: 家庭小助手 }, groupChat: { mentionPatterns: [@家庭小助手, @小家] }, sandbox: { mode: all, scope: agent }, tools: { allow: [read, exec, sessions_list, sessions_history], deny: [write, edit, apply_patch, browser, nodes] } } ] }, bindings: [ { agentId: family, match: { channel: qqbot, peer: { kind: group, id: 123456789 } } } ] }

6.1 启动 Gateway#

`powershell

问题 1：配置文件格式错误#

症状：Error: Invalid JSON in config file

解决方案：检查 JSON 语法是否正确，Windows 路径需要使用双反斜杠。

问题 2：API Key 无效#

症状：Error: Invalid API key

解决方案：确认 API Key 正确且未过期，检查环境变量是否设置正确。

问题 3：端口被占用#

症状：Error: Port 18789 is already in use

解决方案：

`powershell netstat -ano | findstr :18789 taskkill /PID 进程ID /F

8.1 保护 API Key#

• 使用环境变量，不要硬编码在配置文件中
• 定期更换 API Key
• 使用最小权限原则

8.2 沙箱隔离#

对于不信任的 Agent，启用沙箱：

json { sandbox: { mode: all, scope: agent } }

8.3 工具权限控制#

根据 Agent 用途限制工具：

json { tools: { allow: [read, sessions_list], deny: [write, exec, browser] } }

9.1 Docker 沙箱#

在 Windows 上使用 Docker 沙箱需要安装 Docker Desktop for Windows。

9.2 定时任务#

配置定时执行任务：

json { cron: { jobs: [ { id: daily-report, name: 每日汇报, enabled: true, schedule: { kind: cron, expr: 0 8 * * *, tz: Asia/Shanghai }, payload: { kind: agentTurn, message: 请生成今日工作报告 } } ] } }

10.1 内存优化#

• 使用小模型：日常使用可用 MiniMax-M2.1
• 限制上下文：配置 maxTokens
• 定期清理：清理对话历史

10.2 响应速度#

• 本地部署：同等配置下响应更快
• 缓存：配置合适的缓存策略