跳到內容

如何管理你的聊天頻道:openclaw channels 指南

要在多個聊天平台之間切換,處理各種 API Token 和登入狀態,對開發者來說總是很瑣碎。你可能剛剛才搞定 Telegram 的 Bot,轉頭又要去處理 WhatsApp 的 QR Code 登入,或是排查 Discord 的權限範圍。

如果能有一個統一的介面來查看所有頻道的連線狀態,並直接在終端機管理帳號,開發效率會提高不少。openclaw channels 就是為了簡化這些流程而設計的工具。

在開始之前,請確保你已經準備好:

  • 已安裝並配置好的 Gateway
  • 對應頻道的憑證(如 Telegram bot token、Claude session key 或 WhatsApp 帳號)

這裡有幾個最常用的指令,讓你能在 5 分鐘內上手:

首先,列出目前所有的頻道狀態:

Terminal window
openclaw channels list
openclaw channels status

如果要新增一個 Telegram 頻道,直接貼上你的 bot token:

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

如果你不確定某個頻道需要哪些參數,可以輸入 openclaw channels add --help 查看特定頻道的 flag(例如 Signal 的路徑或 App token)。

對於像 WhatsApp 這種需要掃碼或互動操作的頻道,使用 login 指令:

Terminal window
openclaw channels login --channel whatsapp

想知道你的 Bot 在 Discord 或 Slack 有哪些權限?執行 capabilities 探測:

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

開發時最煩人的就是找 ID。你可以透過 resolve 指令直接把頻道名稱或使用者名稱轉成 ID:

Terminal window
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels resolve --channel discord "My Server/docs/support" "@someone"

你可以使用 --kind user|group|auto 來強制指定要解析的類型。當有多個名稱重複時,系統會優先匹配活躍的項目。

如果你遇到連線問題或權限錯誤,可以嘗試以下步驟:

  • 執行 openclaw status --deep 進行全面探測。
  • 使用 openclaw doctor 獲取修復建議。
  • Claude 403 錯誤:如果 openclaw channels list 顯示 Claude: HTTP 403 ... user:profile,這代表你需要 user:profile 權限。你可以加上 --no-usage 參數,或者提供 CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE 環境變數,也可以透過 Claude Code CLI 重新認證。

如果你在設定過程中遇到任何困難,歡迎詢問 AI Setup Assistant 獲取即時協助。

OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。