トラブルシューティング
ClawBox で問題が発生していますか？このガイドでは、よくある問題とその解決策を説明します。
クイック診断
Terminal
# SSH into your ClawBox (user: clawbox, password: clawbox)
# Check system status
ssh clawbox@clawbox.local 'openclaw status'
# View recent logs
ssh clawbox@clawbox.local 'openclaw logs --tail 50'
# Check service health
ssh clawbox@clawbox.local 'openclaw health'
# Test network connectivity
ping clawbox.localよくある問題
🔴
ClawBox が起動しない
critical症状：
- •ランプが点灯せず動作しない
- •ステータスLEDが消えたまま
- •電源ボタンを押しても反応なし
解決策：
- 1電源アダプターがしっかり接続されているか確認する
- 2別のコンセントを試す
- 3アダプターの電源LEDが点灯しているか確認する
- 4問題が解決しない場合はサポートにお問い合わせください
🌐
ネットワークに接続できない
high症状：
- •clawbox.local にアクセスできない
- •メッセージが送信されない
- •ステータスがオフラインと表示される
解決策：
- 1イーサネットケーブルの接続を確認する（抜き差しを試みる）
- 2ルーターに利用可能なDHCPアドレスがあるか確認する
- 3代わりにWi-Fi経由で接続してみる
- 4他のデバイスがネットワークにアクセスできるか確認する
🐢
AIの応答が遅い
medium症状：
- •応答までに長い遅延がある
- •複雑なクエリでタイムアウトが発生する
- •システム全体が重く感じる
解決策：
- 1十分な通気を確保する（密閉されたスペースを避ける）
- 2他のプロセスが実行されていないか確認する（top コマンド）
- 3AIサービスを再起動する：openclaw restart
- 4より速い応答のために小さなAIモデルの使用を検討する
💬
メッセージが受信されない
medium症状：
- •ボットはオンラインのように見えるが応答しない
- •メッセージは送信済みと表示されるが返信がない
- •一部のプラットフォームでは動作するが他では動作しない
解決策：
- 1プラットフォームが正しくペアリングされているか確認する（設定を確認）
- 2メッセージングサービスを再起動する：openclaw restart messaging
- 3影響を受けているプラットフォームでボットを再承認する
- 4プラットフォームの開発者設定でウェブフックURLを確認する
🌡️
過熱
high症状：
- •ファンが常にフル回転している
- •ログにサーマルスロットリングの警告が表示される
- •デバイスが熱くなっている
解決策：
- 1通気性のよい場所に移動する
- 2通気口とファンのほこりを取り除く
- 3周囲の温度を下げる
- 4デバイス周辺の気流が遮られていないか確認する
ログの確認
ログは問題の診断に不可欠です。以下のコマンドを使用して、異なるログの種類にアクセスしてください。
Terminal
# View all logs
openclaw logs
# View specific service logs
openclaw logs --service chat
openclaw logs --service browser
openclaw logs --service voice
# Follow logs in real-time
openclaw logs -f
# Filter by log level
openclaw logs --level error
# Export logs for support
openclaw logs --export support-bundle.zipリセットオプション
⚠️
警告
一部のリセットオプションはデータを消去します。事前に重要な設定を必ずバックアップしてください。
リセットの種類
openclaw reset --softデータを失わずにサービスを再起動しますopenclaw reset --hardキャッシュをクリアしてすべてのサービスを再起動しますopenclaw reset --factoryすべてのデータを消去して出荷時設定に戻します# Soft reset (restart services)
openclaw reset --soft
# Hard reset (clear cache, restart)
openclaw reset --hard
# Factory reset (WARNING: erases all data)
openclaw reset --factory --confirmLED ステータスインジケーター
緑の点灯
システムは正常に動作しています
緑の点滅
リクエスト処理中または起動中
橙の点灯
システムが起動中またはアップデート中
橙の点滅
警告状態 — ログで詳細を確認してください
赤の点灯
エラー状態 — 対処が必要です
サポートを受ける
問題を解決できない場合は、サポートチームがお手伝いします。
サポートに連絡する前に：
- □正確なエラーメッセージや動作内容をメモする
- □LED ステータスインジケーターを確認する
- □上記の関連するトラブルシューティング手順を試す
- □ログをエクスポートする：openclaw logs --export
お問い合わせ時に含める情報：
- ✓ClawBox のシリアル番号（底面のラベルに記載）
- ✓問題の詳細説明
- ✓再現手順
- ✓ログのエクスポートファイル（利用可能な場合）