🔧 _ _ _ ____ _
| | | | ___| |_ __ / ___| | __ ___ __
| |_| |/ _ \ | '_ \| | | |/ _` \ \ /\ / /
| _ | __/ | |_) | |___| | (_| |\ V V /
|_| |_|\___|_| .__/ \____|_|\__,_| \_/\_/
|_|
⚡ Your OpenClaw Fixer ⚡
Your AI-powered OpenClaw troubleshooting assistant.
Works with Claude Code, Codex, Copilot, and any AI CLI tool.
Discord •
Docs •
Report a Bug
HelpClaw is a universal troubleshooting repo for OpenClaw. Clone it, cd into it, open your favorite AI coding tool, and describe your problem. HelpClaw automatically loads as your personal support assistant — no setup, no configuration, no plugins.
It works because modern AI coding tools auto-read instruction files from the current directory:
| Tool | File it reads |
|---|---|
| Claude Code | CLAUDE.md |
| OpenAI Codex | AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
All three point to the same playbook (INSTRUCTIONS.md), so you get identical support regardless of which tool you use.
Three commands. That's it.
git clone https://github.com/silentobelisk/helpclaw.git
cd helpclaw
claude # or codex, copilot, etc.Then just describe your problem:
"My gateway won't start and it says bearer token unavailable"
HelpClaw walks you through it step by step — like a patient friend sitting next to you.
helpclaw/
├── CLAUDE.md # Auto-loads in Claude Code
├── AGENTS.md # Auto-loads in Codex
├── .github/copilot-instructions.md # Auto-loads in GitHub Copilot
├── INSTRUCTIONS.md # The full HelpClaw playbook
├── README.md # You're reading it
└── common-fixes/ # Offline troubleshooting guides
├── gateway-wont-start.md
├── bearer-token-error.md
├── config-syntax-errors.md
├── slash-commands-not-working.md
├── channel-not-connecting.md
├── openclaw-not-found.md
├── version-mismatch.md
└── permissions-errors.md
These are pre-written, verified solutions to the most common OpenClaw problems. The AI reads them to give you accurate fixes without needing to fetch external docs — which matters when your internet or setup is the thing that's broken.
They're also plain markdown, so if your AI tool isn't cooperating either, you can just open the file and follow the steps yourself.
| Guide | What it covers |
|---|---|
| Gateway Won't Start | Crashes, port conflicts, bad config, corrupt install |
| Bearer Token Error | Auth failures, expired keys, wrong provider |
| Config Syntax Errors | Bad JSON, missing commas, smart quotes |
| Slash Commands Not Working | Commands not registered or not responding |
| Channel Not Connecting | Discord / Telegram / Slack integration issues |
| OpenClaw Not Found | "command not found", PATH issues, installation |
| Version Mismatch | Outdated version, updating, downgrading |
| Permissions Errors | EACCES, permission denied, sudo problems |
HelpClaw follows a 5-step support workflow:
- Listen first — understands your problem before jumping to solutions
- Gather info — tells you exactly which commands to run and what to copy back
- Check common fixes, then live docs — uses offline guides first, fetches docs.openclaw.ai when needed
- Walk you through the fix — numbered steps, one action at a time, always backs up first
- Escalate if needed — drafts a help post for the community Discord if it can't solve it
Full details in INSTRUCTIONS.md.
Do I need to install anything?
Nope. Just clone and cd in. Your AI tool does the rest.
Does this work with [tool X]?
If your AI coding tool reads CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md from the working directory, yes. Most modern AI CLI tools do.
What if my AI tool isn't working either?
Open the common-fixes/ folder and read the markdown files directly. They're written for humans too.
Can I use this without an AI tool at all? Yes! The common-fixes guides are standalone. Open the one that matches your problem and follow the steps.
How do I update HelpClaw?
cd helpclaw
git pull- Community Discord: https://discord.gg/clawd
- OpenClaw Docs: https://docs.openclaw.ai
- OpenClaw GitHub: https://github.com/openclaw/openclaw
- Report an issue with HelpClaw: Open an issue
Built for the Agentic Business Academy