全网最通俗的 OpenClaw 多智能体 (SubAgent) 部署与终极避坑指南

🚀 肝了半宿！全网最通俗的 OpenClaw 多智能体 (SubAgent) 部署与终极避坑指南

如果你正在折腾目前爆火的开源 AI 系统 OpenClaw，试图打造一支属于自己的“一人公司 AI 团队”（Multi-Agent），那你大概率经历过这种绝望：

给机器人在 Telegram 设了管理权限、拉进了群，但在群里怎么艾特它，它都像个植物人一样死活不理你！

网上的教程要么过时，要么各种报错（比如 unknown option '--task'）。今天，我们不讲虚的，直接从底层逻辑出发，带你 5 分钟拉起一个满血的子智能体（SubAgent），并附上我们生生蹚出来的终极排雷手册！

📌 核心逻辑：不要把 AI 想得太复杂

在 OpenClaw 的最新版架构里，拉起一个小弟只需要四步，这就像给新员工办理入职：

去外网领一套工作服（在 Telegram 申请账号和 Token）。
在内网建个工位并注入灵魂（创建 Agent 文件夹并写好它的人设简历）。
给网关发放通行证（把 Token 填进系统，让内网能连上外网）。
插上专线网线（把内网工位和外网账号精准绑定）。

下面，我们一步步来，哪怕你是纯小白也能直接复制粘贴！

🛠️ 第一步：去 Telegram 申请“工作服”

这步完全在 Telegram 软件里操作，目的是拿到机器人的身份证（Bot Token）。

找到机器人之父：在 Telegram 搜索框搜 @BotFather（认准带蓝勾的官方号）。
创建新机器人：

发送指令：/newbot
起个显示名：比如“QA测试工程师”。
起个系统账号名：必须以 bot或 _bot结尾，比如 my_qa_bot。

🔑 拿走核心钥匙（Token）：

BotFather 会回复一段话，里面有一串红色的乱码（如 1234567890:ABCdef...）。复制保存好，千万别泄露！

💣 终极避坑（小白必死坑）：关闭群组隐私

如果不关，机器人加到群里就是个聋子！
发送指令：/setprivacy-> 选择你的机器人 -> 点击 Disable。看到 DISABLED才算成功。

🛠️ 第二步：在服务器给它“建工位”（上户口）

切回服务器的黑框终端，给系统打声招呼：“我要招个叫 qa 的新员工了”。

一键创建底层目录：

# 举例：我们要建一个内部代号叫 qa 的小弟openclaw agents add qa --workspace ~/.openclaw/agents/qa/workspace --agent-dir ~/.openclaw/agents/qa/agent --non-interactive

🛠️ 第三步：给小弟“注入灵魂”（配置 .md 文件）

没有配置文件，小弟就是个空壳。进入刚才建好的 workspace目录，新建以下几个核心 Markdown 文件：

IDENTITY.md（人设，决定它怎么说话）：

- **Name:** QA测试工程师- **Role:** qa- **Vibe:** 挑剔、严谨、自带找茬属性，说话一针见血。

USER.md（老板是谁）：

- **Name:** 老板- **Notes:** 沟通要求：直接给方案，拒绝瞎猜。

必须补充的空文件（维持系统运转）：AGENTS.md、MEMORY.md、HEARTBEAT.md。

🛠️ 第四步：给网关发放“通行证”（配置 Token）

网关需要知道去哪接发消息。打开 OpenClaw 的全局配置文件（通常为 ~/.openclaw/config.json）。

找到 channels配置段，把第一步拿到的 Token 加进去。注意这里的 id 必须和第二步的内部代号一致（如 qa）：

JSON

"channels": {  "telegram": {    "qa": {      "token": "你的专属Token填在这里"    }  }}

🛠️ 第五步：插上网线，完美闭环（路由绑定）

这是最关键的一步，也是全网踩坑重灾区！我们要告诉系统：“把代号 qa 的网线，插到代号 qa 的工位上”。

执行终极绑定指令：

# 💣 史诗级避坑：后面的 telegram:qa，千万不要带 @机器人的全名！必须用内部代号！否则触发冲突报错！openclaw agents bind --agent qa --bind telegram:qa

重启网关让一切生效：

systemctl restart openclaw-gateway.service

搞定！把机器人拉进你的 Telegram 群组，直接在群里 @你的机器人，它绝对秒回你！

🚨 附赠：老中医“把脉”与排雷手册

如果在群里喊不答应，绝不要瞎猜，依次敲下面这两条命令查监控日志：

❌ 症状 1：路由对不齐（Token 冲突报错）

诊断命令：openclaw channels status --probe
病症日志：看到 error:Duplicate Telegram bot token。
病因：第五步绑定时，你写成了 telegram:@全名_bot，导致系统强行拉起新通道，与原 Token 抢占冲突。
解药：解绑错误路由，重新绑定正确代号。

openclaw agents unbind --agent qa --bind telegram:@错误名字_botopenclaw agents bind --agent qa --bind telegram:qasystemctl restart openclaw-gateway.service

❌ 症状 2：网关没连上外网

诊断命令：openclaw channels status --probe
病因：找不到 qa通道或显示 not configured。说明第四步的 config.json里的 Token 填错了或漏了。

❌ 症状 3：机器人提示 Wallet empty

病因：网络全通，但你绑定的底层 API（如 BlockRun）钱包余额耗尽。
解药：这是 OpenClaw 的高级降级保护机制，它已自动切到免费模型维持运行。去对应的 API 平台充值即可瞬间恢复满血智商。

❌ 症状 4：执行命令报错 unknown option '--task'

病因：你看的是过时的旧版教程。当前最新版已完全弃用 sessions spawn唤醒指令。直接采用本文的绑定（Bind）架构即可。