OpenClaw channels 使用教程 渠道登录和状态检查指南

openclaw channels 是所有聊天渠道相关操作的统一入口。只要你的问题和这些事情有关：

• 机器人怎么连上 Telegram / WhatsApp / Discord / 飞书
• 渠道是不是还在线
• Gateway 到底有没有识别这个渠道

那你几乎都绕不开 channels 这组命令。

它主要负责什么#

在日常使用里，channels 最常承担三类任务：

• 登录或配对渠道
• 查看渠道当前状态
• 诊断渠道与 Gateway 的连接情况

这也是为什么它不是“某一个渠道的专用命令”，而是所有渠道的通用入口。

最常见的命令#

openclaw channels login
openclaw channels status --probe

这两条命令已经能覆盖大部分新手最常见的场景。

openclaw channels login：处理登录和配对#

它最适合：

• WhatsApp 这类需要扫码或登录的渠道
• 某些需要重新建立会话的接入流程

一个典型例子就是 WhatsApp：

1. 先完成渠道配置
2. 运行：

openclaw channels login

3. 按提示扫码或完成登录

所以如果你已经写了配置，但机器人还没真正连上，第一时间就该想到 login。

openclaw channels status --probe：判断渠道到底是不是真的在线#

这是我很推荐常用的一条：

openclaw channels status --probe

它特别适合回答：

• 渠道现在是否在线
• Gateway 是否真的识别到了它
• 当前问题是在登录层，还是在权限 / 路由层

比起只看 UI 或只看机器人是否在群里，这条命令通常更接近事实状态。

为什么“机器人加进去了”不等于“渠道可用”#

这是非常常见的误区。机器人出现在群里，只能说明它被加入了某个地方，不代表：

• 登录仍然有效
• Gateway 已经接到它
• 它有权限读取消息
• 它当前被允许回复

真正要判断可用性，还是要看 channels status --probe 和日志。

一个推荐的排障顺序#

如果某个渠道不回消息，我建议按这个顺序：

1. openclaw channels status --probe
2. openclaw logs --follow
3. 再去看提及规则、pairing、allowlist 或群组权限

这样可以把“渠道根本没连上”和“渠道已在线但被规则挡住”区分开。

它和单个渠道教程怎么配合#

你可以把每个渠道教程理解成“接入细节”，把 channels 理解成“通用管理入口”。

例如：

• Telegram 教程告诉你怎么拿 token、怎么建 bot
• WhatsApp 教程告诉你怎么登录和配对
• channels 命令则负责统一查看它们现在的真实状态

所以以后你接的渠道越多，channels 的价值就越明显。