--- read_when: - チャネルアカウント（WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost（Plugin）/Signal/iMessage/Matrix）を追加/削除したい - チャネルのステータスを確認するか、チャネルログを追跡表示したい summary: '`openclaw channels` の CLI リファレンス（アカウント、ステータス、ログイン/ログアウト、ログ）' title: チャネル x-i18n: generated_at: "2026-05-11T20:25:47Z" model: gpt-5.5 provider: openai source_hash: 58a964b4db9526defab6ee47b7a99c11086e345d42c8d20f5262fc134337947f source_path: cli/channels.md workflow: 16 --- # `openclaw channels` Gateway 上のチャットチャネルアカウントと、そのランタイム状態を管理します。 関連ドキュメント: - チャネルガイド: [チャネル](/ja-JP/channels) - Gateway 設定: [設定](/ja-JP/gateway/configuration) ## よく使うコマンド ```bash openclaw channels list openclaw channels list --all openclaw channels status openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 openclaw channels capabilities --channel discord --target channel: openclaw channels resolve --channel slack "#general" "@jane" openclaw channels logs --channel all ``` `channels list` はチャットチャネルのみを表示します。既定では設定済みアカウントを表示し、アカウントごとに `installed`、`configured`、`enabled` の状態タグを示します。`--all` を渡すと、まだ設定済みアカウントがない同梱チャネルと、まだディスク上にないインストール可能なカタログチャネルも表示します。認証プロバイダー (OAuth + API キー) とモデルプロバイダーの使用量/クォータのスナップショットは、ここには出力されなくなりました。プロバイダー認証プロファイルには `openclaw models auth list` を、使用量には `openclaw status` または `openclaw models list` を使用してください。 ## 状態 / 機能 / 解決 / ログ - `channels status`: `--channel `、`--probe`、`--timeout `、`--json` - `channels capabilities`: `--channel `、`--account ` (`--channel` と併用する場合のみ)、`--target `、`--timeout `、`--json` - `channels resolve`: ``、`--channel `、`--account `、`--kind `、`--json` - `channels logs`: `--channel `、`--lines `、`--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 セッション行が表示されないことがあります。 ## アカウントの追加 / 削除 ```bash openclaw channels add --channel telegram --token openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY" openclaw channels remove --channel telegram --delete ``` `openclaw channels add --help` は、チャネルごとのフラグ (トークン、秘密鍵、アプリトークン、signal-cli パスなど) を表示します。 `channels remove` は、インストール済み/設定済みのチャネル Plugin に対してのみ動作します。インストール可能なカタログチャネルには、先に `channels add` を使用してください。 ランタイムに支えられたチャネル Plugin では、`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` - 対応している場合、既定アカウントの env ベース認証には `--use-env` フラグ駆動の追加コマンド中にチャネル Plugin をインストールする必要がある場合、OpenClaw は対話型 Plugin インストールプロンプトを開かずに、そのチャネルの既定のインストールソースを使用します。 フラグなしで `openclaw channels add` を実行すると、対話型ウィザードは次を尋ねる場合があります。 - 選択したチャネルごとのアカウント ID - それらのアカウントの任意の表示名 - `Route these channel accounts to agents now?` 今すぐバインドすることを確認すると、ウィザードは設定済みチャネルアカウントごとにどのエージェントが所有するかを尋ね、アカウントスコープのルーティングバインディングを書き込みます。 同じルーティングルールは、後で `openclaw agents bindings`、`openclaw agents bind`、`openclaw agents unbind` でも管理できます ([agents](/ja-JP/cli/agents) を参照)。 単一アカウントのトップレベル設定をまだ使用しているチャネルに非既定アカウントを追加すると、OpenClaw は新しいアカウントを書き込む前に、アカウントスコープのトップレベル値をそのチャネルのアカウントマップへ昇格します。ほとんどのチャネルでは、それらの値は `channels..accounts.default` に配置されますが、同梱チャネルでは、既存の一致する昇格済みアカウントを保持できる場合があります。現在の例は Matrix です。名前付きアカウントが 1 つ既に存在する場合、または `defaultAccount` が既存の名前付きアカウントを指している場合、昇格では新しい `accounts.default` を作成せず、そのアカウントを保持します。 ルーティング動作は一貫したままです。 - 既存のチャネルのみのバインディング (`accountId` なし) は、引き続き既定アカウントに一致します。 - `channels add` は、非対話型モードではバインディングを自動作成または書き換えません。 - 対話型セットアップでは、任意でアカウントスコープのバインディングを追加できます。 設定が既に混在状態 (名前付きアカウントが存在し、トップレベルの単一アカウント値もまだ設定されている状態) だった場合は、`openclaw doctor --fix` を実行して、アカウントスコープの値をそのチャネル用に選択された昇格済みアカウントへ移動してください。ほとんどのチャネルは `accounts.default` へ昇格しますが、Matrix は既存の名前付き/既定ターゲットを保持できる場合があります。 ## ログインとログアウト (対話型) ```bash openclaw channels login --channel whatsapp openclaw channels logout --channel whatsapp ``` - `channels login` は `--verbose` に対応しています。 - `channels login` と `logout` は、対応しているログインターゲットが 1 つだけ設定されている場合、チャネルを推測できます。 - `channels logout` は、到達可能な場合はライブ Gateway パスを優先するため、チャネル認証状態をクリアする前にアクティブなリスナーを停止します。ローカル Gateway に到達できない場合は、ローカル認証クリーンアップにフォールバックします。 - `channels login` は Gateway ホスト上のターミナルから実行してください。エージェントの `exec` はこの対話型ログインフローをブロックします。`whatsapp_login` などのチャネルネイティブのエージェントログインツールが利用できる場合は、チャットから使用してください。 ## トラブルシューティング - 広範なプローブには `openclaw status --deep` を実行します。 - ガイド付き修正には `openclaw doctor` を使用します。 - `openclaw channels list` はモデルプロバイダーの使用量/クォータのスナップショットを出力しなくなりました。それらには `openclaw status` (概要) または `openclaw models list` (プロバイダーごと) を使用してください。 - `openclaw channels status` は、Gateway に到達できない場合、設定のみの要約にフォールバックします。対応しているチャネル資格情報が SecretRef 経由で設定されているものの、現在のコマンドパスで利用できない場合、そのアカウントを未設定として表示するのではなく、劣化注記付きで設定済みとして報告します。 ## 機能プローブ プロバイダー機能のヒント (利用可能な場合はインテント/スコープ) と静的な機能対応状況を取得します。 ```bash openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 ``` 注記: - `--channel` は任意です。すべてのチャネル (extensions を含む) を一覧表示するには省略します。 - `--account` は `--channel` と併用する場合のみ有効です。 - `--target` は `channel:` または生の数値チャネル ID を受け取り、Discord にのみ適用されます。Discord ボイスチャネルでは、権限チェックが不足している `ViewChannel`、`Connect`、`Speak`、`SendMessages`、`ReadMessageHistory` をフラグします。 - プローブはプロバイダー固有です。Discord インテント + 任意のチャネル権限、Slack bot + ユーザースコープ、Telegram bot フラグ + Webhook、Signal デーモンバージョン、Microsoft Teams アプリトークン + Graph ロール/スコープ (既知の場合は注記付き) です。プローブのないチャネルは `Probe: unavailable` を報告します。 ## 名前を ID に解決 プロバイダーディレクトリを使用して、チャネル/ユーザー名を ID に解決します。 ```bash 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 ` を使用してください。 ## 関連 - [CLI リファレンス](/ja-JP/cli) - [チャネル概要](/ja-JP/channels)