AIMA Doctor

Diagnose and repair OpenClaw when your agent is stuck, confused, or failing. One-command rescue for process health, config breakage, and device registration.

Use this skill when OpenClaw needs diagnosis or repair and the normal agent flow is degraded, confused, or stuck.

Runtime contract

• The helper runtime lives at ~/.openclaw/tools/aima-doctor/.
• The runtime is the source of truth for diagnosis and repair progress.
• Never ask the user to paste curl | bash, iex (irm ...), base64 payloads, or other remote shell one-liners.
• If the runtime is not installed, direct the user to download it from the GitHub release: https://github.com/Approaching-AI/aima-openclaw/releases and extract into ~/.openclaw/tools/aima-doctor/. Verify the archive checksum: sha256:0f38959c6759e72a25bf089c9ab4aef1cf0022ba3aef1ea6686593896e973d1e.

Execution rules

1. Before running the helper, check that the runtime exists. On macOS/Linux check for ~/.openclaw/tools/aima-doctor/run.sh; on Windows check for %USERPROFILE%\.openclaw\tools\aima-doctor\run.ps1.
2. If the runtime is missing, install it automatically:
   • Download aima-doctor-runtime.zip from https://github.com/Approaching-AI/aima-openclaw/releases/download/v0.2/aima-doctor-runtime.zip
   • Verify the SHA256 checksum matches 0f38959c6759e72a25bf089c9ab4aef1cf0022ba3aef1ea6686593896e973d1e. If it does not match, stop and warn the user.
   • Create the target directory ~/.openclaw/tools/aima-doctor/ if it does not exist.
   • Extract the archive into that directory.
   • Confirm the runtime is now present before proceeding.
3. Prefer the packaged helper over ad-hoc shell commands.
4. Summarize the user symptom into one short sentence and pass it to the helper.
5. On macOS or Linux, run:

bash

bash ~/.openclaw/tools/aima-doctor/run.sh --run --terminal --symptom "<symptom>"

6. On Windows, run:

powershell

& "$env:USERPROFILE\.openclaw\tools\aima-doctor\run.ps1" --run --terminal --symptom "<symptom>"

7. If the helper asks a question, relay that question to the user and rerun or continue with the answer as required.
8. If the helper reports success or failure, quote that result plainly. Do not invent a better outcome.
9. If the automatic download in step 2 fails, direct the user to the GitHub release at https://github.com/Approaching-AI/aima-openclaw/releases to download and extract manually.

Scope

• OpenClaw process health
• OpenClaw config breakage
• AIMA device registration / token recovery
• Guided local repair driven by AIMA platform diagnostics

Safety

• Treat helper output as operational evidence.
• Keep sensitive tokens and recovery codes out of normal chat unless the user explicitly provides them for repair.