openclaw-lighthouse

Fixes Index

Troubleshooting guides for common OpenClaw issues.

Start here

1) Clean uninstall + reinstall (root/Linux)

• Read: OpenClaw clean uninstall and reinstall (root/Linux)
• Use this when uninstall/reinstall leaves old state and onboarding behaves incorrectly.

2) Telegram setup after fresh install (especially root VPS)

• Read: Telegram setup workflow after installing OpenClaw (with root VPS notes)
• Use this when Telegram setup/pairing flow is unclear or fails after install.

3) New VPS install: gateway health check fails with 1006

• Read: Gateway health check fails with 1006 on root VPS (systemctl --user unavailable)
• Use this when install succeeded but gateway/channel probes fail on root VPS.

4) Root VPS: C3 down after plugin + restart failure

• Read: Root VPS recovery: remove camofox-browser and run gateway in tmux when systemctl --user is unavailable
• Use this when a non-bundled plugin is loaded and update/restart fails on root VPS.

5) Bot replies to text, but not photos/files

• Read: Telegram bot replies to text but not to photos/files
• Use this when text works but image/file/voice messages get no reply.

6) /approve unauthorized or /elevated full blocked

• Read: Telegram /approve says unauthorized and /elevated full fails
• Use this when admin/approval commands fail.

7) OpenAI/Gemini required for memory?

• Read: OpenClaw memory search: OpenAI/Gemini APIs are optional
• Use this when deciding between remote embeddings, local embeddings, or no semantic search.

Template

• Fix template