$ openclaw diagnose --all
openclaw.troubleshoot()
/** OpenClawの一般的な問題を診断して修復 — GitHubディスカッションからのコミュニティ情報 */
🚨 CRITICAL — Upgrade Impact
⚠ HIGH — Common Blockers
High📦 Installation#ubuntu
Ubuntuインストール失敗:systemctl --userとHomebrew
// Root cause: Ubuntu server / root: systemctl --user not available, Homebrew missing
→ Fix
High💻 Platform#windows
Windows QMD:tsxモジュールが見つからない
// Root cause: QMD installed via Bun on Windows 11 — tsx module resolution failure
→ Fix
High🤖 API / Providers#api
APIレート制限429エラー
// Root cause: Provider RPM/TPM limit hit — OpenAI, Anthropic, Gemini all affected
→ Fix
High🔗 Connectivity#telegram
再起動後にTelegramグループセッションがリセット
// Root cause: Gateway restart re-creates sessions instead of restoring from sessions.json
→ Fix
High🔒 Permissions#raspberrypi
Raspberry Pi 5:ファイルの読み書きができない
// Root cause: Raspberry Pi OS: no read/write/exec after fresh install — tools.profile
→ Fix
High🔗 Connectivity#whatsapp
WhatsAppセッションが切れ続ける
// Root cause: QR code session expires / Baileys auth file corrupted
→ Fix
● MEDIUM — Annoying But Fixable
Medium💻 Platform#windows
コントロールUIツールトグルが保存されない(Windows)
// Root cause: Windows: Control UI tool toggles revert on refresh — v2026.3.2 regression
→ Fix
Medium📦 Installation#linux
LinuxにHomebrewがない — スキルインストール失敗
// Root cause: Skill installer requires Homebrew for github/summarize skills on Linux
→ Fix
Medium🔗 Connectivity#ストリーミング
ストリーミングテキストがターン間で結合される
// Root cause: deltaBuffer missing cross-turn separator merges text across agent turns
→ Fix
Medium🔒 Permissions#権限
screen_recordがサンドボックスにブロックされる
// Root cause: screen_record blocked by sandbox policy; system.which fails in restricted profile
→ Fix
Medium⚡ Performance#ollama
Ollama:コールドスタート時にモデルが見つからない
// Root cause: Ollama cold-start timeout too short — model loads after response returns
→ Fix
Medium⚡ Performance#パフォーマンス
Ollamaが遅すぎる
// Root cause: Running on CPU only, wrong context length, wrong quantization
→ Fix
Medium⚡ Performance#パフォーマンス
メモリ使用量が高い
// Root cause: Model loaded fully in RAM, large context window, no swap
→ Fix
Medium🔗 Connectivity#telegram
Telegramスキルコマンドに_2、_3が重複表示
// Root cause: Telegram skill commands registered multiple times under _2, _3 suffixes
→ Fix
Medium🔗 Connectivity#discord
ハートビートメッセージがDiscord DMに漏洩
// Root cause: Heartbeat delivery default changed in v2026.2.24-beta — leaks to Discord DMs
→ Fix
Medium💻 Platform#macos
Mac Mini:再起動後にゲートウェイが自動起動しない
// Root cause: launchd plist missing or not loaded — gateway not auto-starting on Mac
→ Fix
Medium📦 Installation#docker
Dockerポート競合
// Root cause: Another process or old container is holding the port
→ Fix
○ LOW — Config & Setup Questions