コマンド概要
openclaw channels は OpenClaw のメッセージチャンネルを管理するための中核コマンドです。チャンネルの追加・削除・変更・照会、ステータス監視、障害診断に対応しています。
チャンネル一覧の表示
openclaw channels list
出力:
Channels:
telegram-main Telegram ✓ Connected Agent: default
discord-dev Discord ✓ Connected Agent: code-expert
whatsapp-cs WhatsApp ✗ Disconnected Agent: customer-svc
webchat Web Chat ✓ Active Agent: default
チャンネルの追加
インタラクティブ追加
openclaw channels add
コマンドラインでの直接追加
openclaw channels add telegram-main \
--type telegram \
--token "123456:ABC-DEF" \
--webhook-url "https://gateway.example.com/webhook/telegram-main" \
--agent default
チャンネル詳細の表示
openclaw channels show telegram-main
チャンネル設定の変更
# 使用するエージェントの変更
openclaw channels set telegram-main --agent code-expert
# システムプロンプトの変更
openclaw channels set telegram-main --system-prompt "新しいプロンプト"
# 履歴上限の変更
openclaw channels set telegram-main --history-limit 50
# レート制限の変更
openclaw channels set telegram-main --rate-limit 60
チャンネルステータス管理
# チャンネルの一時停止(メッセージ処理を停止)
openclaw channels pause telegram-main
# チャンネルの再開
openclaw channels resume telegram-main
# 再接続
openclaw channels reconnect whatsapp-cs
チャンネルの削除
openclaw channels remove telegram-main
チャンネル診断
openclaw channels diagnose telegram-main
チャンネル統計
openclaw channels stats telegram-main
openclaw channels stats telegram-main --period 7d
ユーザー管理
# チャンネルのユーザーを表示
openclaw channels users telegram-main
# ユーザーをブロック
openclaw channels block telegram-main --user 12345678
# ユーザーのブロック解除
openclaw channels unblock telegram-main --user 12345678
# ホワイトリストモードの設定
openclaw channels set telegram-main --allowlist-only
openclaw channels allow telegram-main --user 12345678
一括操作
# すべてのチャンネルを一時停止
openclaw channels pause --all
# すべてのチャンネルを再開
openclaw channels resume --all
# チャンネル設定のエクスポート
openclaw channels export channels.json
# チャンネル設定のインポート
openclaw channels import channels.json
Webhook管理
# webhook情報の確認
openclaw channels webhook telegram-main
# webhookの再設定
openclaw channels webhook telegram-main --set "https://new-url.com/webhook/telegram"
# webhookの削除
openclaw channels webhook telegram-main --delete
まとめ
openclaw channels はチャンネルのライフサイクル全体の管理機能を提供します。追加から設定、監視、診断まで、チャンネル関連のすべての操作をこの一連のコマンドで完結でき、日常運用で最も頻繁に使用するコマンドの一つです。