Cli 导读

用 openclaw channels 管理所有聊天账号:增删、状态、能力查询

先跑 `openclaw channels add --channel <名称> --token <令牌>` 接入新账号,非交互模式要填对 token 或私钥等参数。查账号是否在线用 `channels status --probe` 会执行真实探测,网关不可达时只显示配置摘要。`channels capabilities` 能查账号支持哪些目标(如频道、私信),但必须配合 `--channel` 和 `--target` 才有意义。

先讲这一页到底在解决什么

用 openclaw channels 管理所有聊天账号:增删、状态、能力查询

先跑 `openclaw channels add --channel <名称> --token <令牌>` 接入新账号,非交互模式要填对 token 或私钥等参数。查账号是否在线用 `channels status --probe` 会执行真实探测,网关不可达时只显示配置摘要。`channels capabilities` 能查账号支持哪些目标(如频道、私信),但必须配合 `--channel` 和 `--target` 才有意义。

原文共 9 节,先看 Start Here 路径:/cli/channels 查看官方原文

第一站

🧭 先把 5 个常见动作看成门卫桌上的 5 个按钮

官方一开头就给了 `list`、`status`、`capabilities`、`resolve`、`logs`。别被英文吓到,它们其实就是门卫每天会按的五个按钮。

📋

list

看看现在到底接了哪几扇门,门后各自挂着哪些账号。

💓

status

看看这些门今天有没有在线,有没有掉线,有没有哪把钥匙不灵了。

🧰

capabilities

像问这扇门到底会什么:能发群消息吗,能读目录吗,权限够不够。

🏷️

resolve

像把“#general”“@jane”这种昵称,翻成机器真正认得的门牌号。

第二站

🪄 这几个命令翻成现场动作,会更好懂

命令不是魔法咒语。你把它们想成门卫在值班室做动作,就不拗口了。

openclaw channels list

像把登记簿摊开,看看 Telegram、Slack、Discord 这些门现在都写没写进去。

openclaw channels status

像门卫挨扇门试一下门铃,看看哪扇门通,哪扇门只是账本里写着、其实已经没人应门了。

openclaw channels capabilities --channel discord --target channel:123

像拿着一张测试表去问 Discord 这扇门:“你这边到底允许我进多少房间、做多少动作?”

openclaw channels logs --channel all

像站到值班室后面的玻璃窗前,看所有门最近有没有报错、有没有人在疯狂敲门。

第三站

🔑 `add` 和 `remove` 在干嘛?就是发钥匙、收钥匙

官方的 `add/remove accounts` 这一段,本质上是在说:把新门接进来,或者把旧门撤掉。

openclaw channels add --channel telegram --token <bot-token>

像把 Telegram 机器人门卡交给门卫,说:“以后这扇门归你值班。”

openclaw channels add --channel nostr --private-key ...

换了门,钥匙样子也会变。Telegram 用 token,Nostr 用 private key,但动作还是“把门钥匙登记进来”。

openclaw channels remove --channel telegram --delete

像把这扇门从登记簿划掉,还顺手把门卡一起收回。

📌

一句话

add 是接门,remove 是撤门。

第四站

👥 交互向导里那句 “Bind now?”,像“这扇门现在归哪个小工位值班”

官方特别提了 interactive wizard 会问你要不要立刻绑定 agent。因为“门接进来”还不等于“已经分配给谁负责”。

先配账号

先把 Telegram、Slack 这些门配好,告诉系统钥匙在哪。

再问归谁管

向导接着会问:“这扇门要不要现在就交给某个 agent 值班?”

绑定像分工

像把前台电话交给客服组,把报警电话交给值班组,不同工位接不同门。

多账号升级

官方那段很长,其实就在说:如果原来一扇门只有一个账号,后来你又加了第二个,OpenClaw 会帮你把原来的默认账号搬进更整齐的多账号抽屉里。

第五站

🔍 `capabilities` 和 `resolve` 为什么重要?因为门开着,不代表你认路

很多人以为通道接上就完事了。其实后面最常卡住的是两件事:不知道这扇门能做什么,不知道目标名字该写成什么 ID。

🧪

capabilities

像拿权限清单照一照,看看这把钥匙能开哪些房间,哪些房间还是锁着的。

🗺️

resolve --channel slack "#general" "@jane"

像拿着花名册去问:“#general 这间房真正的内部编号是多少?@jane 这个人机器到底怎么认?”

🎯

昵称不是机器门牌

人看得懂名字,机器更爱精确 ID,所以常常要先翻译一次。

📌

一句话

capabilities 看“能做什么”,resolve 看“该往哪打”。

第六站

🩺 排障这段在说:先看总状态,再找医生,再翻监控

官方给的排障建议很实在。不是让你猜,而是给你一条顺序。

openclaw status --deep

像先做一次全屋巡检,别一上来就只盯一扇门。

openclaw doctor

像把总维修师叫来,让它按常见故障表帮你查。

config-only fallback

如果 Gateway 暂时够不着,status 也会先照账本告诉你“理论上配了哪些门”,不会一句话都不给。

SecretRef 提醒

有些钥匙藏在秘密抽屉里。要是这次命令路上没法打开那个抽屉,系统会说“我知道你配过,但我现在没拿到钥匙”,而不是瞎报没配置。

最后总结

🎈 把 openclaw channels 压成一句话

openclaw channels 就像门卫室控制台:负责把聊天通道接进来、给门发钥匙、看门有没有在线、查这扇门会什么、把昵称翻成门牌号,再顺手看看门口日志有没有报警。

如果你下一页只想继续看一页,我建议看 /cli/pairing/cli/message。前者是“有人在门口举手申请进来”,后者是“已经进门以后怎么送消息”。