OpenClaw を使用して複数のチャットプラットフォームに接続する際には、さまざまな接続問題に遭遇することがあります。本記事では、各チャンネルの最も一般的な障害シナリオとトラブルシューティング方法をまとめ、問題を迅速に特定・解決するのに役立てます。
一般的なトラブルシューティング手順
どのチャンネルで問題が発生しているかに関係なく、まず以下の一般的な確認を行うことを推奨します：
チャンネルステータスの確認：openclaw channels status コマンドを実行して、設定された各チャンネルの接続状態、最終アクティブ時刻、エラー情報を確認します。
ログの確認：OpenClaw のログファイルには接続およびメッセージ処理の詳細情報が含まれています。openclaw logs --channel <channel-name> を使用して特定のチャンネルのログをフィルタリングします。より詳細な情報を得るために、設定でログレベルを debug に調整できます。
設定ファイルの検証：openclaw config validate を使用して openclaw.json の構文エラーや必須フィールドの欠落を確認します。多くの問題は設定のタイプミスやフィールドの漏れに起因しています。
ネットワーク接続の確認：OpenClaw インスタンスがターゲットプラットフォームの API サーバーに到達できることを確認します。Webhook を必要とするチャンネルの場合、サーバーが公開アクセス可能であることを確認してください。
Telegram のよくある問題
ボットがメッセージを受信しない：最も一般的な原因は、別のプログラムが同じ Bot Token を使用して getUpdates を呼び出していることです。Telegram の Bot API は2つのクライアントが同時にロングポーリングを使用することを許可しません。そのボットで実行されている OpenClaw インスタンスが1つだけであることを確認してください。
グループで応答しない：Privacy Mode の設定を確認してください。Privacy Mode が有効（デフォルト）の場合、ボットはコマンドと @メンションのみ受信できます。BotFather で Privacy Mode を無効にしてから、ボットをグループから削除して再追加する必要があります。
メッセージフォーマットの問題：Telegram の MarkdownV2 は特殊文字のエスケープに厳格な要件があります。AI の応答に _、*、[ などの文字が含まれると、フォーマットエラーが発生する場合があります。parseMode を HTML またはプレーンテキストに変更してみてください。
WhatsApp のよくある問題
QR コードの期限切れ：WhatsApp の QR コードは有効期間が短く、期限前にスキャンする必要があります。期限切れの場合は、openclaw channels login whatsapp を実行して QR コードを再生成します。
頻繁な切断：WhatsApp は長時間接続の WebSocket を使用しており、不安定なネットワークでは切断が発生しやすくなります。OpenClaw には自動再接続メカニズムが組み込まれており、ほとんどの場合は回復を処理します。切断が続く場合は、サーバーのネットワーク品質とファイアウォール設定を確認してください。
アカウント BAN のリスク：WhatsApp は自動化された使用に厳格な制限があります。ボットのメッセージ送信頻度が高すぎたり、多くの通報を受けたりすると、アカウントが BAN される可能性があります。送信頻度を制御し、大量のメッセージをプロアクティブに送信することを避け、ボットが既知のユーザーからのリクエストにのみ応答するようにしてください。
マルチデバイスログインの競合：Baileys はマルチデバイスプロトコルを使用していますが、スマートフォンで WhatsApp Web からログアウトしたり、スマートフォンを変更したりすると、ボットの接続が無効になり、QR コードの再スキャンが必要になります。
Discord のよくある問題
ボットがオフラインと表示される：Bot Token が有効で、ボットがターゲットサーバーに招待されていることを確認します。招待リンクの権限スコープに bot と applications.commands が含まれていることを確認してください。
メッセージを読み取れない：Discord の Privileged Gateway Intents は Discord Developer Portal で手動で有効にする必要があります。Bot 設定ページに移動して Message Content Intent を有効にしないと、ボットはメッセージ内容を読み取れません。
権限不足：サーバー内のボットのロール権限を確認し、「メッセージの読み取り」と「メッセージの送信」権限があることを確認します。チャンネルレベルの権限オーバーライドにより、特定のチャンネルでボットが操作できない場合もあります。
Slack のよくある問題
イベントサブスクリプションの失敗：Slack はイベントサブスクリプション設定時にチャレンジリクエストを送信して検証します。OpenClaw の Webhook エンドポイントが公開アクセス可能で、チャレンジレスポンスを正しく処理していることを確認してください。
ボットが応答しない：OAuth Scopes に chat:write、channels:history、im:history などの必要な権限が含まれているか確認します。Socket Mode と Event API モードでは設定要件が異なります。正しいモードを使用していることを確認してください。
トークンの期限切れ：Bot Token ではなくユーザートークンを使用している場合、期限切れになる可能性があります。期限切れのない Bot Token を常に使用することを推奨します。
Signal のよくある問題
signal-cli の接続問題：OpenClaw の Signal チャンネルは signal-cli ツールに依存しています。signal-cli が適切にインストールされ、番号の登録/リンクが完了していることを確認してください。signal-cli -u +number receive を実行して、メッセージが正常に受信できるかテストします。
メッセージ遅延：signal-cli はポーリングでメッセージを取得するため、数秒の遅延が発生する場合があります。これは正常な動作で、ポーリング間隔を調整して最適化できます。
プラグインチャンネルのよくある問題
プラグインシステムでインストールされたチャンネル（Lark、Mattermost、Nostr など）のよくある問題：
プラグインバージョンの非互換性：openclaw plugin update <plugin-name> を実行して最新バージョンに更新します。プラグインバージョンと OpenClaw メインプログラムのバージョン間に互換性要件がある場合があります。
プラグインの読み込み失敗：openclaw plugin list の出力でプラグインのステータスが active と表示されているか確認します。error と表示されている場合は、詳細ログで具体的なエラー原因を確認してください。
Webhook 関連の問題
複数のチャンネル（Lark、Zalo、Google Chat など）は Webhook に依存してメッセージを受信します。よくある Webhook の問題：
SSL 証明書の問題：ほとんどのプラットフォームは Webhook に HTTPS の使用を要求します。SSL 証明書が有効で期限切れでないことを確認してください。自己署名証明書は通常受け入れられません。
タイムアウトの問題：Webhook リクエスト送信後、プラットフォームは通常数秒以内の応答を期待します。AI の処理に時間がかかる場合、OpenClaw はまず 200 の確認応答を返し、その後非同期でメッセージを処理して能動的に返信を送信します。
IP ホワイトリスト：一部のプラットフォーム（Lark など）は特定の IP 範囲からのみ Webhook リクエストを送信します。ファイアウォールにインバウンドルールがある場合、これらの IP を許可してください。
自動再接続メカニズム
OpenClaw にはすべてのチャンネルに対する自動再接続メカニズムが組み込まれています。切断を検出すると、指数バックオフ戦略を使用してリトライします。最初の切断後に即座にリトライし、その後間隔を段階的に増加させ（1秒、2秒、4秒、8秒...）、デフォルトの最大間隔は60秒です。
設定で再接続パラメータを調整できます：
{
"reconnect": {
"maxRetries": 50,
"maxInterval": 60,
"resetAfter": 300
}
}
resetAfter は、リトライカウンターがリセットされるまでに接続が安定して動作する必要がある秒数を示します。
ヘルプを得るには
上記のトラブルシューティング方法で問題が解決しない場合は、OpenClaw の GitHub リポジトリに、サニタイズした設定ファイルと関連ログを添えて Issue を提出できます。コミュニティは通常1〜2日以内に応答します。Issue を提出する際は、OpenClaw のバージョン、オペレーティングシステム、影響を受けたチャンネル名を明記してください。