openclaw channels

Gatewayのチャットチャネルアカウントとランタイムステータスを管理します。

関連ドキュメント：

基本コマンド

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

アカウントの追加 / 削除

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

ヒント: openclaw channels add --helpでチャネルごとのフラグ（token、app token、signal-cliパスなど）を確認できます。

openclaw channels addをフラグなしで実行すると、対話型ウィザードが以下を確認します：

  • 選択したチャネルごとのアカウントID
  • それらのアカウントのオプションの表示名
  • Bind configured channel accounts to agents now?（設定済みチャネルアカウントを今すぐエージェントにバインドするか）

バインドを確認すると、ウィザードは各設定済みチャネルアカウントを所有するエージェントを尋ね、アカウントスコープのルーティングバインディングを書き込みます。

同じルーティングルールはopenclaw agents bindings、openclaw agents bind、openclaw agents unbindでも管理できます（agentsを参照）。

シングルアカウントのトップレベル設定（channels.<channel>.accountsエントリなし）を使用しているチャネルにデフォルト以外のアカウントを追加すると、OpenClawはアカウントスコープのシングルアカウントトップレベル値をchannels.<channel>.accounts.defaultに移動してから、新しいアカウントを書き込みます。これにより、マルチアカウント形式に移行しつつ元のアカウントの動作を保持します。

ルーティング動作の一貫性：

  • 既存のチャネルのみのバインディング（accountIdなし）は引き続きデフォルトアカウントにマッチします。
  • channels addは非対話モードでバインディングを自動作成しません。
  • 対話型セットアップではオプションでアカウントスコープのバインディングを追加できます。

設定が混在状態（名前付きアカウントが存在するがdefaultがなく、トップレベルのシングルアカウント値がまだ設定されている）の場合は、openclaw doctor --fixを実行してアカウントスコープの値をaccounts.defaultに移動してください。

ログイン / ログアウト（対話型）

openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp

トラブルシューティング

  • openclaw status --deepで広範な診断を実行。
  • openclaw doctorでガイド付き修復を実行。
  • openclaw channels listがClaude: HTTP 403 ... user:profileを出力 → 使用量スナップショットにuser:profileスコープが必要。--no-usageを使用するか、claude.aiセッションキー（CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE）を提供するか、Claude Code CLIで再認証してください。
  • openclaw channels statusはGatewayに到達できない場合、設定のみの概要にフォールバックします。サポート対象のチャネル認証情報がSecretRef経由で設定されているが現在のコマンドパスで利用できない場合、そのアカウントを「未設定」ではなく「設定済み（機能低下あり）」として報告します。

Capabilitiesプローブ

プロバイダーの機能ヒント（利用可能な場合はintents/scopes）と静的な機能サポートを取得：

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

補足：

  • --channelはオプション。省略するとすべてのチャネル（拡張機能含む）を一覧表示。
  • --targetはchannel:<id>または数値のチャネルIDを受け付け、Discordにのみ適用。
  • プローブはプロバイダー固有：Discordのintents + オプションのチャネル権限、Slackのbot + userスコープ、Telegramのbotフラグ + webhook、Signalのdaemonバージョン、MS Teamsのappトークン + Graphロール/スコープ（既知の場合は注釈付き）。プローブのないチャネルはProbe: unavailableを報告。

名前からIDへの解決

プロバイダーディレクトリを使用してチャネル/ユーザー名をIDに解決：

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でターゲットタイプを強制できます。
  • 同名のエントリが複数ある場合、アクティブなマッチが優先されます。
  • channels resolveは読み取り専用です。選択されたアカウントがSecretRef経由で設定されているがその認証情報が現在のコマンドパスで利用できない場合、コマンドは全体を中止するのではなく、注記付きの機能低下した未解決結果を返します。
arrow_back
前へ
Browser
次へ
Clawbot
arrow_forward