openclaw agents 多代理管理教程

命令概述

openclaw agents 命令用于管理多个 AI 代理（Agent）。每个代理可以有不同的人设、模型、技能和行为配置，适合需要多角色 AI 的场景。

查看代理列表

openclaw agents list

输出：

Agents:
  default        gpt-4o-mini    Active    General assistant
  code-helper    gpt-4o         Active    Programming assistant
  translator     gpt-4o-mini    Active    Translation specialist
  customer-svc   claude-sonnet  Inactive  Customer service bot

创建新代理

openclaw agents create assistant-cn

交互式创建：

Creating new agent: assistant-cn

Display name: 中文助手
Description: 专注中文对话的 AI 助手
Model [gpt-4o-mini]: qwen-72b
System prompt: 你是一个专业的中文 AI 助手，擅长中文写作、翻译和知识问答。请始终使用中文回复。

Agent 'assistant-cn' created successfully.

非交互式创建：

openclaw agents create code-expert \
  --display-name "代码专家" \
  --model gpt-4o \
  --system "你是一个资深全栈工程师，擅长代码审查、架构设计和技术方案编写。" \
  --tools code_exec,web_search \
  --temperature 0.3

代理配置详情

openclaw agents show code-expert

输出：

Agent: code-expert
  Display Name: 代码专家
  Model: gpt-4o
  Temperature: 0.3
  Max Tokens: 4096
  System Prompt: 你是一个资深全栈工程师...
  Tools: code_exec, web_search
  Channels: discord-dev
  Status: Active
  Created: 2026-03-14
  Messages: 1,520

修改代理配置

# 修改模型
openclaw agents update code-expert --model gpt-4o-mini

# 修改系统提示词
openclaw agents update code-expert --system "新的系统提示词"

# 修改温度
openclaw agents update code-expert --temperature 0.5

# 添加工具
openclaw agents update code-expert --add-tool image_gen

将代理分配给频道

# 将代理分配到频道
openclaw agents assign code-expert --channel discord-dev
openclaw agents assign assistant-cn --channel wechat-main

# 查看代理的频道分配
openclaw agents channels code-expert

一个频道只能绑定一个代理，但一个代理可以服务多个频道。

代理间路由

配置消息路由规则，根据内容自动分发到不同代理：

{
  "routing": {
    "enabled": true,
    "rules": [
      {
        "match": "代码|编程|bug|函数",
        "agent": "code-expert"
      },
      {
        "match": "翻译|translate",
        "agent": "translator"
      },
      {
        "match": ".*",
        "agent": "default"
      }
    ]
  }
}

启用/禁用代理

# 禁用代理（不再处理消息）
openclaw agents disable customer-svc

# 启用代理
openclaw agents enable customer-svc

删除代理

openclaw agents delete old-agent

注意：删除代理不会删除其历史对话记录。

代理统计

openclaw agents stats code-expert

Agent Stats: code-expert (last 7 days)
  Messages processed: 342
  Avg response time: 2.1s
  Token usage: 125,000
  Estimated cost: $1.25
  Active sessions: 5
  Error rate: 0.3%

批量管理

# 导出所有代理配置
openclaw agents export agents-backup.json

# 导入代理配置
openclaw agents import agents-backup.json

# 批量更新模型
openclaw agents update-all --model gpt-4o-mini

配置文件中定义代理

{
  "agents": {
    "code-expert": {
      "displayName": "代码专家",
      "model": "gpt-4o",
      "systemPrompt": "你是一个资深工程师...",
      "temperature": 0.3,
      "tools": ["code_exec", "web_search"],
      "maxTokens": 4096
    },
    "translator": {
      "displayName": "翻译官",
      "model": "gpt-4o-mini",
      "systemPrompt": "你是一个专业翻译...",
      "temperature": 0.3,
      "maxTokens": 2048
    }
  }
}

总结

openclaw agents 让你可以在同一个 OpenClaw 实例中运行多个具有不同能力和人设的 AI 代理。通过合理的代理分工和路由配置，可以为不同用户群体提供定制化的 AI 服务。