CLI commands
チャンネル
openclaw channels
チャットチャネルのアカウントと、Gateway 上での実行時ステータスを管理します。
関連ドキュメント:
一般的なコマンド
openclaw channels listopenclaw channels list --allopenclaw channels statusopenclaw channels capabilitiesopenclaw channels capabilities --channel discord --target channel:123openclaw channels resolve --channel slack "#general" "@jane"openclaw channels logs --channel allchannels list はチャットチャネルのみを表示します。デフォルトでは設定済みのアカウントを、アカウントごとの installed、configured、enabled ステータスタグとともに表示します（機械処理用の出力には --json を使用します）。--all を指定すると、まだ設定済みアカウントがない同梱チャネルと、まだディスク上にないインストール可能なカタログチャネルも表示されます。プロバイダー認証とモデル使用量は別の場所で管理します。プロバイダー認証プロファイルには openclaw models auth list、使用量とクォータには openclaw status または openclaw models list を使用します。
ステータス / 機能 / 解決 / ログ
channels status:--channel <name>、--probe、--timeout <ms>（デフォルトは10000）、--jsonchannels capabilities:--channel <name>、--account <id>（--channelが必要）、--target <dest>（--channelが必要）、--timeout <ms>（デフォルトは10000、上限は30000）、--jsonchannels resolve <entries...>:--channel <name>、--account <id>、--kind <auto|user|group>（デフォルトはauto）、--jsonchannels logs:--channel <name|all>（デフォルトはall）、--lines <n>（デフォルトは200）、--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 のセッション行は表示されない場合があります。
アカウントの追加 / 削除
openclaw channels add --channel telegram --token <bot-token>openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"openclaw channels remove --channel telegram --deletechannels remove は、インストール済みまたは設定済みのチャネル Plugin のみを対象とします。インストール可能なカタログチャネルでは、最初に channels add を使用してください。--delete を指定しない場合は、アカウントを無効にするか確認し、その設定を保持します。--delete を指定すると、確認せずに設定エントリを削除します。
実行時バックエンドを持つチャネル Plugin では、channels remove は設定を更新する前に、選択したアカウントを停止するよう実行中の Gateway にも要求します。そのため、アカウントを無効化または削除しても、再起動まで古いリスナーが動作し続けることはありません。
チャネル間で共通する非対話型追加フラグは、--account <id>、--name <name>、--token、--token-file、--bot-token、--app-token、--secret、--secret-file、--password、--cli-path、--url、--base-url、--http-url、--auth-dir、--use-env（環境変数ベースの認証。サポートされている場合にデフォルトアカウントのみ）です。チャネル固有のフラグには次のものがあります。
| チャネル | フラグ |
|---|---|
| Google Chat | --webhook-path、--webhook-url、--audience-type、--audience |
| iMessage | --cli-path、--db-path、--service、--region |
| Matrix | --homeserver、--user-id、--access-token、--password、--device-name、--initial-sync-limit |
| Nostr | --private-key、--relay-urls |
| Signal | --signal-number、--cli-path、--http-url、--http-host、--http-port |
| Tlon | --ship、--url、--code、--group-channels、--dm-allowlist、--auto-discover-channels |
--auth-dir |
フラグを使用した追加コマンドの実行中にチャネル Plugin のインストールが必要な場合、OpenClaw は対話型の Plugin インストールプロンプトを開かずに、そのチャネルのデフォルトのインストール元を使用します。
フラグなしで openclaw channels add を実行すると、対話型ウィザードで次の入力を求められる場合があります。
- 選択したチャネルごとのアカウント ID
- それらのアカウントの任意の表示名
Route these channel accounts to agents now?
ここでバインドを確定すると、ウィザードは設定済みの各チャネルアカウントをどのエージェントが所有するかを尋ね、アカウントスコープのルーティングバインディングを書き込みます。
同じルーティングルールは、後から openclaw agents bindings、openclaw agents bind、openclaw agents unbind でも管理できます（エージェントを参照）。
単一アカウント用のトップレベル設定を引き続き使用しているチャネルに、デフォルトではないアカウントを追加すると、OpenClaw は新しいアカウントを書き込む前に、それらのトップレベル値をチャネルのアカウントマップへ昇格させます。チャネルに名前付きアカウントがちょうど 1 つある場合、または defaultAccount がいずれかの名前付きアカウントを指している場合、昇格時にその既存アカウントを再利用します。それ以外の場合、値は channels.<channel>.accounts.default に格納されます。
ルーティング動作の一貫性は維持されます。
- 既存のチャネルのみのバインディング（
accountIdなし）は、引き続きデフォルトアカウントに一致します。 - 非対話モードでは、
channels addはバインディングを自動作成または書き換えしません。 - 対話型セットアップでは、任意でアカウントスコープのバインディングを追加できます。
設定がすでに混在状態（名前付きアカウントが存在し、トップレベルの単一アカウント値も引き続き設定されている状態）だった場合は、openclaw doctor --fix を実行して、アカウントスコープの値をそのチャネルで選択された昇格先アカウントへ移動してください。
ログインとログアウト（対話型）
openclaw channels login --channel whatsappopenclaw channels logout --channel whatsappchannels loginは--account <id>と--verboseをサポートし、channels logoutは--account <id>をサポートします。- 設定済みチャネルのうち、その操作をサポートするものが 1 つだけの場合、
channels loginとlogoutはチャネルを推測できます。複数ある場合は--channelを指定してください。 channels logoutは Gateway に到達できる場合、ライブ Gateway パスを優先するため、チャネルの認証状態を消去する前に、アクティブなリスナーを停止します。ローカル Gateway に到達できない場合は、ローカルでの認証クリーンアップへフォールバックします。gateway.mode: "remote"の場合は、代わりに Gateway エラーによってコマンドが失敗します。- ログインに成功すると、CLI は到達可能なローカル Gateway にアカウントの起動を要求します。リモートモードでは、認証をローカルに保存し、リモートランタイムが再起動されなかったことを通知します。
channels loginは Gateway ホスト上のターミナルから実行してください。エージェントのexecはこの対話型ログインフローをブロックします。利用可能な場合、whatsapp_loginなどのチャネルネイティブなエージェントログインツールをチャットから使用してください。
トラブルシューティング
- 広範なプローブを実行するには
openclaw status --deepを使用します。 - ガイド付きの修正には
openclaw doctorを使用します。 - Gateway に到達できない場合、
openclaw channels statusは設定のみの概要へフォールバックします。サポート対象チャネルの認証情報が SecretRef 経由で設定されていても、現在のコマンドパスでは利用できない場合、そのアカウントを未設定として表示する代わりに、劣化状態を示す注記付きで設定済みとして報告します。
機能プローブ
プロバイダーの機能ヒント（利用可能な場合はインテントやスコープ）と、静的な機能サポートを取得します。
openclaw channels capabilitiesopenclaw channels capabilities --channel discord --target channel:123注記:
--channelは任意です。省略すると、Plugin が提供するチャネルを含むすべてのチャネルを一覧表示します。--accountは--channelと併用する場合のみ有効です。--targetはchannel:<id>または生の数値チャネル ID を受け付け、Discord にのみ適用されます。Discord の音声チャネルでは、権限チェックによって不足しているViewChannel、Connect、Speak、SendMessages、ReadMessageHistoryが示されます。- プローブはプロバイダー固有です。Discord ではボットの ID とインテント、および任意のチャネル権限、Slack ではボットとユーザーのスコープ、Telegram ではボットフラグと Webhook、Signal ではデーモンのバージョン、Microsoft Teams ではアプリトークンと 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 経由で設定されていても、その認証情報が現在のコマンドパスでは利用できない場合、実行全体を中止する代わりに、注記付きの劣化した未解決結果を返します。channels resolveはチャネル Plugin をインストールしません。インストール可能なカタログチャネルの名前を解決する前に、channels add --channel <name>を使用してください。
