OpenClaw多Agent配置实战(多BOT版)

懒人方案:如果不想手动折腾配置文件,可以直接进入 ~/.openclaw 文件夹,启用 OpenCode,把这篇文章扔给它,让 OpenCode 参照着搞定。你只需要安装OpenCode就行(让OpenClaw帮你安装)。两个工具互相帮忙!


为什么要多Agent?

最近有一些任务,OpenClaw 处理起来不是很得力,容易出错,不太爽。

有什么办法能够让我在不同的时候使用不同的模型,既把事办了,也把钱省了呢?

经过一番研究发现,OpenClaw的多Agent架构完美解决了这个问题:每个Agent可以绑定不同的模型,通过路由规则自动分配任务。


最终效果

配置完成后,我的系统是这样的:

Agent 模型 用途 成本
main MiniMax M2.7 日常对话、简单编码
code-reviewer GPT 5.4 Pro 代码审查、安全分析

用户通过不同的飞书机器人发起请求,OpenClaw自动路由到对应的Agent。


原理图

┌─────────────────────────────────────────────────────────────┐
│                      用户消息                                │
└─────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────┐
│                    OpenClaw Gateway                          │
│                  (根据Bindings路由)                           │
└─────────────────────────────────────────────────────────────┘
                     │                    │
                     ▼                    ▼
     ┌───────────────────────┐  ┌───────────────────────┐
     │   飞书机器人1(default)  │  │ 飞书机器人2(code-reviewer)│
     └───────────────────────┘  └───────────────────────┘
                     │                    │
                     ▼                    ▼
     ┌───────────────────────┐  ┌───────────────────────┐
     │     main Agent        │  │  code-reviewer Agent  │
     │   模型: MiniMax       │  │   模型: GPT 5.4 Pro   │
     │   成本: 低            │  │   成本: 高            │
     └───────────────────────┘  └───────────────────────┘

环境准备

1. 确认OpenClaw版本

openclaw --version

确保版本 >= 2026.3.x

2. 获取OpenCode Zen API密钥

访问 https://opencode.ai/auth,注册并获取API密钥。

GPT 5.4系列模型通过OpenCode Zen提供。

3. 确认飞书扩展

本文使用OpenClaw内置的飞书扩展 feishu(路径:openclaw/extensions/feishu),安装方便。

# 查看已启用的插件
openclaw plugins list

期望输出中应包含:

feishu: enabled

4. 准备飞书应用

需要两个飞书应用: - 应用1:已有的飞书机器人(用于main Agent) - 应用2:新建的代码审查机器人(用于code-reviewer Agent)

飞书开放平台 创建新应用,获取 App IDApp Secret

飞书应用需要开启以下权限:im:messageim:message:send_as_bot 等。最好是把能开的权限都开上。


实战步骤

Step 1:查看当前配置

先了解一下现有的配置结构:

# 查看当前Agent列表
openclaw agents list

输出:

Agents:
- main (default)
  Model: minimax/MiniMax-M2.7
  Routing: default

查看配置文件:

# 配置文件位置
cat ~/.openclaw/openclaw.json

当前只有 main 一个Agent,使用MiniMax模型。


Step 2:添加OpenCode Zen模型提供商

这一步可以通过openclaw configure命令完成,模型配置步骤有OpenCode选项,更不容易出错。

编辑 ~/.openclaw/openclaw.json,在 models.providers 中添加GPT 5.4系列模型:

{
  "models": {
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.7",
            "name": "MiniMax M2.7"
          }
        ]
      },
      "opencode-zen": {
        "baseUrl": "https://opencode.ai/zen/v1",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT 5.4",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-5.4-pro",
            "name": "GPT 5.4 Pro",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

agents.defaults.models 中添加模型别名:

{
  "agents": {
    "defaults": {
      "models": {
        "minimax/MiniMax-M2.7": {
          "alias": "MiniMax"
        },
        "opencode-zen/gpt-5.4-pro": {
          "alias": "GPT 5.4 Pro (Code Review)"
        }
      }
    }
  }
}

Step 3:添加OpenCode Zen API密钥

编辑 ~/.openclaw/agents/main/agent/auth-profiles.json

{
  "version": 1,
  "profiles": {
    "minimax:cn": {
      "type": "api_key",
      "provider": "minimax",
      "key": "your-minimax-api-key"
    },
    "opencode-zen:default": {
      "type": "api_key",
      "provider": "opencode-zen",
      "key": "your-opencode-zen-api-key"
    }
  }
}

Step 4:创建code-reviewer Agent

使用CLI命令一键创建:

openclaw agents add code-reviewer \
  --workspace ~/.openclaw/workspace-code-reviewer \
  --model opencode-zen/gpt-5.4-pro \
  --non-interactive

这条命令会自动创建: - 独立的工作空间目录:~/.openclaw/workspace-code-reviewer - 独立的Agent配置目录:~/.openclaw/agents/code-reviewer/agent - 独立的会话存储:~/.openclaw/agents/code-reviewer/sessions/


Step 5:定义Agent人格

每个Agent都可以有独立的人格配置。

AGENTS.md (~/.openclaw/workspace-code-reviewer/AGENTS.md):

# Code Review Agent

你是一个专门的代码审查助手,使用GPT 5.4 Pro进行深度代码分析。

## 职责
- 代码质量审查
- 潜在Bug识别
- 性能优化建议
- 安全性检查
- 最佳实践建议

## 审查标准
1. 代码可读性
2. 错误处理
3. 性能考虑
4. 安全性
5. 测试覆盖

## 输出格式
- 总体评分(A-F)
- 问题列表(文件:行号)
- 严重程度(高/中/低)
- 建议修复方案

SOUL.md (~/.openclaw/workspace-code-reviewer/SOUL.md):

# Code Review Agent Soul

你是一个经验丰富、耐心细致的代码审查专家。

## 性格
- 严谨但友好
- 注重细节
- 建设性而非批评性

## 语气
- 专业但亲切
- 清晰简洁
- 避免技术术语滥用

Step 6:配置飞书机器人

openclaw.jsonchannels 部分配置飞书多账户:

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "default": {
          "appId": "cli_已有应用ID",
          "appSecret": "已有应用Secret"
        },
        "code-review": {
          "appId": "cli_新应用ID",
          "appSecret": "新应用Secret"
        }
      },
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open"
    }
  }
}

说明accounts 是多账户配置的关键字段,每个账户对应一个飞书应用。default 账户用于main Agent,code-review 账户用于code-reviewer Agent。


Step 7:配置路由绑定

openclaw.json 中添加Bindings:

{
  "bindings": [
    {
      "agentId": "code-reviewer",
      "match": {
        "channel": "feishu",
        "accountId": "code-review"
      }
    }
  ]
}

路由规则解读: - 当消息来自 feishu 渠道 - 且账户为 code-review(即新创建的飞书机器人) - 则路由到 code-reviewer Agent


Step 8:重启网关使配置生效

openclaw gateway restart

Step 9:验证配置

openclaw agents list --bindings

期望输出:

Agents:
- main (default)
  Model: minimax/MiniMax-M2.7
  Routing: default

- code-reviewer
  Model: opencode-zen/gpt-5.4-pro
  Routing rules:
    - feishu accountId=code-review

检查频道状态:

openclaw channels status

期望看到两个飞书账户都在运行:

- Feishu default: enabled, configured, running
- Feishu code-review: enabled, configured, running

测试效果

测试1:日常编码(走main Agent,MiniMax模型)

通过第一个飞书机器人发送:

帮我写一个Python函数,计算斐波那契数列

MiniMax快速响应,成本低。

测试2:代码审查(走code-reviewer Agent,GPT 5.4 Pro)

(简单例子示意,非大模型真实输出)

通过第二个飞书机器人发送:

def process_user_input(user_input):
    query = "SELECT * FROM users WHERE id = " + user_input
    result = db.execute(query)
    return result

GPT 5.4 Pro 深度分析,输出:

🚨 严重问题:SQL注入漏洞

文件位置: 代码片段:2
问题: 用户输入直接拼接SQL查询
严重程度: 高
建议修复: 使用参数化查询

修复代码:
```python
def process_user_input(user_input):
    query = "SELECT * FROM users WHERE id = %s"
    result = db.execute(query, (user_input,))
    return result

总结

多Agent架构的核心价值:

  1. 成本优化:简单任务用便宜模型,复杂任务用强模型
  2. 专业化:每个Agent可以定制专属的人格和规则

好钢用在刀刃上,让每个模型做最擅长的事。