Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw channels
管理 Gateway 网关上的聊天渠道账户及其运行时状态。
相关文档：
常用命令
channels list 只显示聊天渠道：默认显示已配置的账户，并按账户显示 installed、configured 和 enabled 状态标签。传入 --all 还会显示尚未配置账户的内置渠道，以及尚未落盘的可安装目录渠道。这里不再打印认证提供商（OAuth + API key）和模型提供商用量/配额快照；使用 openclaw models auth list 查看提供商认证配置文件，使用 openclaw status 或 openclaw models list 查看用量。
状态 / 能力 / 解析 / 日志
channels status：--channel <name>、--probe、--timeout <ms>、--jsonchannels capabilities：--channel <name>、--account <id>（仅与--channel搭配使用）、--target <dest>、--timeout <ms>、--jsonchannels resolve：<entries...>、--channel <name>、--account <id>、--kind <auto|user|group>、--jsonchannels logs：--channel <name|all>、--lines <n>、--json
channels status --probe 是实时路径：在可访问的 Gateway 网关上，它会按账户运行
probeAccount 和可选的 auditAccount 检查，因此输出可以包含传输
状态，以及 works、probe failed、audit ok 或 audit failed 等探测结果。
如果 Gateway 网关无法访问，channels status 会回退为仅基于配置的摘要，
而不是实时探测输出。
不要将 openclaw sessions、Gateway 网关 sessions.list 或智能体
sessions_list 工具用作渠道套接字健康信号。这些界面报告的是
已存储的对话行，而不是提供商运行时状态。Discord 提供商
重启后，已连接但安静的账户可能是健康的，但在下一次入站或出站对话事件之前，
不会出现 Discord 会话行。
添加 / 移除账户
channels remove 只作用于已安装/已配置的渠道插件。对于可安装目录渠道，请先使用 channels add。
对于由运行时支持的渠道插件，channels remove 还会要求正在运行的 Gateway 网关在更新配置前停止所选账户，因此禁用或删除账户不会让旧监听器一直保持活跃直到重启。
常见的非交互式添加界面包括：
- bot-token 渠道：
--token、--bot-token、--app-token、--token-file - Signal/iMessage 传输字段：
--signal-number、--cli-path、--http-url、--http-host、--http-port、--db-path、--service、--region - Google Chat 字段：
--webhook-path、--webhook-url、--audience-type、--audience - Matrix 字段：
--homeserver、--user-id、--access-token、--password、--device-name、--initial-sync-limit - Nostr 字段：
--private-key、--relay-urls - Tlon 字段：
--ship、--url、--code、--group-channels、--dm-allowlist、--auto-discover-channels --use-env用于受支持位置的默认账户环境变量支持认证
openclaw channels add 时，交互式向导可以提示：
- 每个所选渠道的账户 ID
- 这些账户的可选显示名称
Route these channel accounts to agents now?
openclaw agents bindings、openclaw agents bind 和 openclaw agents unbind 管理相同的路由规则（参见 agents）。
当你向仍在使用单账户顶层设置的渠道添加非默认账户时，OpenClaw 会在写入新账户之前，将账户范围的顶层值提升到该渠道的账户映射中。大多数渠道会将这些值落在 channels.<channel>.accounts.default 中，但内置渠道可以改为保留现有的匹配提升账户。Matrix 是当前示例：如果已经存在一个命名账户，或者 defaultAccount 指向现有命名账户，提升会保留该账户，而不是创建新的 accounts.default。
路由行为保持一致：
- 现有的仅渠道绑定（没有
accountId）会继续匹配默认账户。 channels add在非交互模式下不会自动创建或重写绑定。- 交互式设置可以选择添加账户范围的绑定。
openclaw doctor --fix，将账户范围的值移动到为该渠道选择的提升账户中。大多数渠道会提升到 accounts.default；Matrix 可以改为保留现有的命名/默认目标。
登录和登出（交互式）
channels login支持--verbose。- 当只配置了一个受支持的登录目标时，
channels login和logout可以推断渠道。 channels logout在可访问时优先使用实时 Gateway 网关路径，因此登出会在清除渠道认证状态前停止所有活跃监听器。如果本地 Gateway 网关不可访问，它会回退为本地认证清理。- 请从 Gateway 网关主机上的终端运行
channels login。智能体exec会阻塞此交互式登录流程；可用时，应从聊天中使用渠道原生智能体登录工具，例如whatsapp_login。
故障排除
- 运行
openclaw status --deep进行广泛探测。 - 使用
openclaw doctor获取引导式修复。 openclaw channels list不再打印模型提供商用量/配额快照。如需这些信息，请使用openclaw status（概览）或openclaw models list（按提供商）。- 当 Gateway 网关无法访问时，
openclaw channels status会回退为仅基于配置的摘要。如果受支持的渠道凭据通过 SecretRef 配置，但在当前命令路径中不可用，它会将该账户报告为已配置并附带降级说明，而不是显示为未配置。
能力探测
获取提供商能力提示（可用时包括 intent/scope）以及静态功能支持：--channel是可选的；省略它可列出每个渠道（包括插件）。--account仅在与--channel搭配使用时有效。--target接受channel:<id>或原始数字渠道 ID，并且仅适用于 Discord。对于 Discord 语音渠道，权限检查会标记缺失的ViewChannel、Connect、Speak、SendMessages和ReadMessageHistory。- 探测因提供商而异：Discord intent + 可选渠道权限；Slack bot + user scope；Telegram bot 标志 + webhook；Signal daemon 版本；Microsoft Teams app token + Graph 角色/scope（在已知位置添加注释）。没有探测的渠道会报告
Probe: unavailable。
将名称解析为 ID
使用提供商目录将渠道/用户名称解析为 ID：- 使用
--kind user|group|auto强制目标类型。 - 当多个条目共享同一名称时，解析会优先选择活跃匹配项。
channels resolve是只读的。如果所选账户通过 SecretRef 配置，但该凭据在当前命令路径中不可用，该命令会返回带说明的降级未解析结果，而不是中止整个运行。channels resolve不会安装渠道插件。对于可安装目录渠道，请先使用channels add --channel <name>，再解析名称。