> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 頻道

# `openclaw channels`

在 Gateway 閘道器上管理聊天頻道帳號及其執行期狀態。

Related docs:

* 頻道指南：[Channels](/channels/index)
* Gateway 閘道器設定：[Configuration](/gateway/configuration)

## 常用指令

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels list
openclaw channels status
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels logs --channel all
```

## 新增／移除帳號

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels add --channel telegram --token <bot-token>
openclaw channels remove --channel telegram --delete
```

提示：`openclaw channels add --help` 會顯示各頻道專用的旗標（權杖、應用程式權杖、 signal-cli 路徑等）。

## 登入／登出（互動式）

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp
```

## Troubleshooting

* 執行 `openclaw status --deep` 進行全面檢測。
* 使用 `openclaw doctor` 取得引導式修復。
* `openclaw channels list` 會列印 `Claude: HTTP 403 ... user:profile` → usage snapshot needs the `user:profile` scope. user:profile`→ 使用快照需要`user:profile`範圍。請使用`--no-usage`，或提供 claude.ai 工作階段金鑰（`CLAUDE\_WEB\_SESSION\_KEY`／`CLAUDE\_WEB\_COOKIE\\\`），或透過 Claude Code CLI 重新驗證。

## 能力探測

擷取提供者的能力提示（在可用時包含 intents／scopes）以及靜態功能支援：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
```

注意事項：

* `--channel` 為選用；省略即可列出所有頻道（包含擴充）。
* `--target` 接受 `channel:<id>` 或原始的數字頻道 ID，且僅適用於 Discord。
* 探測機制依供應商而異：Discord intents + 可選的頻道權限；Slack 機器人 + 使用者 scopes；Telegram 機器人旗標 + webhook；Signal daemon 版本；MS Teams 應用程式權杖 + Graph 角色／scopes（已於可知處標註）。未啟用探測的頻道將顯示 `Probe: unavailable`。 Channels without probes report `Probe: unavailable`.

## 將名稱解析為 ID

使用提供者目錄將頻道／使用者名稱解析為 ID：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels resolve --channel discord "My Server/#support" "@someone"
openclaw channels resolve --channel matrix "Project Room"
```

注意事項：

* 使用 `--kind user|group|auto` 強制指定目標類型。
* Resolution prefers active matches when multiple entries share the same name.