7 days raising shrimp, 3 days fixing shrimp. I’m sure everyone has experienced OpenClaw breaking itself while trying to tweak its own features. If you’ve run into this, you can follow the steps below to troubleshoot and fix all kinds of issues, so you won’t feel helpless next time. 1. For simple issues, self-repair is the fastest. Use the official command line (CLI) to fix it. OpenClaw has a built-in diagnostic tool specifically for resolving common startup problems. Remember these commands: `openclaw doctor --fix` Doctor diagnosis: Automatically checks environment variables, permissions, and dependencies. `gateway.pid` If you see “Gateway already running” but it’s not actually running, it’s usually caused by a leftover `.pid` file. You can also stop the task from the Activity Monitor and restart it. `openclaw gateway restart` Force restart the gateway service. `openclaw onboard --install-daemon` Reinitialize the configuration. If the `openclaw.json` config file is corrupted, you can use reinstall mode (data will be preserved, but the boot process will reset). 2. For more complex issues, use Claude code or Codx for troubleshooting. Installing Claude code is a bit more complicated, but Codx can be downloaded directly from OpenAI’s official website, making it easier for beginners. OpenClaw’s official documentation is super detailed and can provide Claude code and Codx with ideas to quickly pinpoint issues without fumbling around. To make the repair process more efficient, you can save the documentation as memory after reading it and generate related skills. This way, you can quickly resolve issues in the future. Prompt: `/docs.openclaw.ai/zh-CN` Fully scrape OpenClaw’s official documentation, store the content as your permanent memory, and generate related skills. In the future, when you need to fix OpenClaw, it will automatically retrieve this memory and repair it. Of course, you can also send the documentation to OpenClaw itself, but if it’s already down, it won’t be of any use. That’s why we need external “doctors.” Just yesterday, I ran into an issue while modifying the memory system, and I used this method to fix it. The official doctor couldn’t solve it, so I had to call in the pros. OpenClaw’s coding and software engineering capabilities are still relatively weak. When adding features, I’d recommend using Claude code or Codx. Otherwise, over time, the code you write in OpenClaw might turn into a pile of spaghetti that’s impossible to maintain. #OpenClaw #Troubleshooting #CodingTips