夜雨聆风如果你正在折腾目前爆火的开源 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）架构即可。