乐于分享
好东西不私藏

Openclaw-如何创建第二个Agent

Openclaw-如何创建第二个Agent

创建第二个 Agent 非常简单,核心就是两条命令 + 一个配置文件修改。整个过程大概需要 5 分钟,不需要写代码。

🚀 三步创建第二个 Agent

第一步:创建新 Agent 并分配独立 workspace

打开终端,执行以下命令:

bash

openclaw agents add<agent-id>--workspace<路径>
# 创建一个名为 creative 的 Agent,并指定独立工作区
openclaw agents add creative --workspace ~/.openclaw/workspace-creative

这条命令会做三件事:

  1. 在系统中注册一个 ID 为creative的新 Agent

  2. 在指定路径创建专属 workspace 目录

  3. 自动生成SOUL.mdUSER.mdTOOLS.md等核心配置文件

第二步:查看 Agent 列表确认创建成功

bash

# 列出所有 Agent
openclaw agents list

你应该能看到类似输出

  • main(默认 Agent)

  • creative(刚创建的新 Agent)

每个 Agent 都拥有独立的 workspace,这意味着它们的记忆、性格、工具权限完全隔离,互不干扰

第三步:配置路由规则(关键步骤)

要让别人知道哪个会话该找哪个 Agent,需要修改网关配置文件:

bash

# 编辑主配置文件
nano ~/.openclaw/openclaw.json

找到bindings节点,按以下格式添加路由规则

json

{"gateway":{"bindings":[// 默认 Agent 处理所有未匹配的请求{"agentId":"main","match":{"channel":"any"}},// 为 creative Agent 绑定特定渠道{"agentId":"creative","match":{"channel":"discord","peer":{"kind":"channel","id":"12312312312312312"// 替换为你的频道ID}}}]}}

路由规则配置要点

  • 单渠道单账户:一个 Bot 服务所有 Agent(最简单,适合个人)

    含义:你只创建了一个Bot 账号(比如一个企业微信机器人),但你有多个Agent(比如writercoderops)。通过路由规则,根据消息的发送者或所在群组,把这个单一 Bot 收到的消息分发给不同的 Agent。

    适用场景:个人使用,你一个人想在不同的场景下调用不同的 Agent。

    {

      "agents": {

        "list": [

          { "id": "work", "workspace": "~/.openclaw/workspace-work" },

          { "id": "personal", "workspace": "~/.openclaw/workspace-personal" }

        ]

      },

      "channels": {

        "wecom": {

          "accounts": {

            "default": { "botId": "单一机器人ID", "secret": "xxx" }

          }

        }

      },

      "bindings": [

        {

          "agentId": "work",

          "match": { "channel": "wecom", "peer": { "id": "工作群ID" } }

        },

        {

          "agentId": "personal",

          "match": { "channel": "wecom", "peer": { "id": "你的个人微信ID" } }

        }

      ]

    }

  • 单渠道多账户:多个 Bot 对应多个 Agent(角色清晰,适合小团队)

    含义:你创建了多个Bot 账号(比如两个企业微信机器人:助手A助手B),每个 Bot 账号绑定一个专属的 Agent。这样,用户主动选择找哪个 Bot,就相当于选择了哪个 Agent。

    适用场景:小团队或分工明确的场景,比如团队里有“项目经理Bot”和“开发Bot”,成员根据需求找对应的Bot。

    {

      "agents": {

        "list": [

          { "id": "pm", "workspace": "~/.openclaw/workspace-pm" },

          { "id": "dev", "workspace": "~/.openclaw/workspace-dev" }

        ]

      },

      "channels": {

        "wecom": {

          "accounts": {

            "pm_bot": { "botId": "项目经理Bot的ID", "secret": "xxx" },

            "dev_bot": { "botId": "开发Bot的ID", "secret": "xxx" }

          }

        }

      },

      "bindings": [

        {

          "agentId": "pm",

          "match": { "channel": "wecom", "accountId": "pm_bot" }

        },

        {

          "agentId": "dev",

          "match": { "channel": "wecom", "accountId": "dev_bot" }

        }

      ]

    }

  • 多渠道路由:不同平台对应不同 Agent(如飞书→main,Telegram→creative)

    含义:你在多个平台(如企业微信、飞书、Discord)上都接入了 OpenClaw,但希望不同平台的消息由不同的 Agent 处理。比如,工作相关的飞书消息交给workAgent,闲聊的微信消息交给personalAgent。

    适用场景:你同时在多个平台使用 AI 助手,希望每个平台有专属的角色定位。

    {

      "agents": {

        "list": [

          { "id": "work", "workspace": "~/.openclaw/workspace-work" },

          { "id": "personal", "workspace": "~/.openclaw/workspace-personal" }

        ]

      },

      "bindings": [

        {

          "agentId": "work",

          "match": { "channel": "feishu" }   // 飞书来的消息 → work Agent

        },

        {

          "agentId": "personal",

          "match": { "channel": "wechat" }   // 微信来的消息 → personal Agent

        }

      ]

    }

配置完成后,重启网关使配置生效:

bash

openclaw gateway restart

📁 新 Agent 的 workspace 长什么样?

创建成功后,进入~/.openclaw/workspace-creative/查看,你会看到这些核心文件

text

.├── AGENTS.md     # 多智能体路由表
├── BOOTSTRAP.md  # 初始化向导(⚠️不要手动创建或修改)
├── HEARTBEAT.md  # 主动任务清单
├── IDENTITY.md   # 身份面板
├── SOUL.md       # 性格定义文件
├── TOOLS.md      # 工具使用说明书
└── USER.md       # 你的偏好记录

每个文件的作用和默认 Agent 完全一样,你可以按需修改

  • SOUL.md:定义这个新 Agent 的性格(比如 "你是创意助手,擅长头脑风暴")

  • USER.md:记录用户偏好

  • TOOLS.md:配置可用的技能

🎯 接下来可以做什么?

创建好第二个 Agent 后,你可以:

  1. 在 Web 界面切换 Agent:打开控制台http://127.0.0.1:18789,在界面右上角选择 creative 进行对话

  2. 命令行直接调用openclaw tui --agent creative

  3. 配置不同模型:为 creative 绑定另一个大模型(比如创意类用更强的模型,简单任务用经济型模型)

⚠️ 避坑指南

  1. 不要手动创建 BOOTSTRAP.md:这个文件是 Agent 初始化时自动生成的,手动创建会导致 bootstrapping 状态卡住

  2. 不要复用 Agent 目录:不同 Agent 必须用不同的 workspace 路径,否则会导致认证失败

  3. 路由规则优先级:带具体频道 ID 的规则要放在通用规则前面,避免匹配错误

你现在可以根据需求修改 creative 的SOUL.mdTOOLS.md,让它变成你想要的那个“数字员工”