← Back to Skills Marketplace
skyguan92

AIMA Doctor

by guanjiawei · GitHub ↗ · v0.2.7 · MIT-0
darwinlinuxwin32 ⚠ suspicious
124
Downloads
1
Stars
0
Active Installs
9
Versions
Install in OpenClaw
/install aima-doctor
Description
Diagnose and repair OpenClaw when your agent is stuck, confused, or failing. One-command rescue for process health, config breakage, and device registration.
README (SKILL.md)

AIMA Doctor

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 ools\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 ~/.openclaw/tools/aima-doctor/run.sh --run --terminal --symptom "\x3Csymptom>"
  1. On Windows, run:
& "$env:USERPROFILE\.openclaw	ools\aima-doctor\run.ps1" --run --terminal --symptom "\x3Csymptom>"
  1. If the helper asks a question, relay that question to the user and rerun or continue with the answer as required.
  2. If the helper reports success or failure, quote that result plainly. Do not invent a better outcome.
  3. 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.
Usage Guidance
This skill appears to do what it says: download a packaged helper and run it to diagnose and repair OpenClaw. Before installing, verify the release/source: 1) Confirm the GitHub repository and homepage URLs are legitimate and match the vendor you trust. 2) If the installer runs automatically, prefer the SHA256 verification step and manually verify the checksum yourself. 3) Note README references a different download host — prefer the canonical release location you trust and avoid ambiguous mirrors. 4) Inspect the extracted runtime (run.sh / run.ps1) before executing, or run it in a sandbox/VM if you're unsure. 5) Never paste secrets into chat unless explicitly asked and you understand why; follow the skill's guideline to keep tokens out of normal chat. If you want greater assurance, request the runtime source code or a signed release from the publisher before proceeding.
Capability Analysis
Type: OpenClaw Skill Name: aima-doctor Version: 0.2.7 The skill implements an automated downloader and executor pattern in SKILL.md, instructing the agent to fetch a remote runtime (aima-doctor-runtime.zip) from GitHub and execute shell or PowerShell scripts (run.sh/run.ps1). While the instructions include a SHA256 checksum verification step, the core functionality involves downloading and running external code to handle sensitive tasks like 'token recovery' and 'device registration,' which presents a significant security risk despite the lack of explicit malicious intent in the provided files.
Capability Assessment
✓ Purpose & Capability
The name/description (diagnose and repair OpenClaw) matches the runtime actions: the skill checks for a local helper and, if absent, downloads and runs a packaged runtime to perform repairs. Asking to place a helper under ~/.openclaw/tools/aima-doctor/ and to run it is proportionate to the stated purpose.
ℹ Instruction Scope
Instructions are narrowly scoped to checking/placing/executing the helper runtime and relaying user symptoms. The SKILL.md explicitly warns not to solicit remote shell one-liners and to keep tokens out of chat. However, the runtime is executed with a symptom string provided by the agent — the helper could access system state, so you should inspect the runtime before running if you have concerns.
ℹ Install Mechanism
This is instruction-only and the install step directs automatic download from a GitHub releases URL with an expected SHA256 checksum (good practice). A minor inconsistency: README references a different host (aimaservice.ai/doctor/runtime.zip) while SKILL.md points to the GitHub releases URL. Downloads from GitHub releases are common; extracting and executing an archive into the user's home is higher-risk but coherent for a repair runtime.
✓ Credentials
The skill requests no environment variables or credentials and does not require unrelated secrets. The SKILL.md also admonishes keeping sensitive tokens out of chat. This is appropriate for a local repair tool.
ℹ Persistence & Privilege
The skill writes the runtime under ~/.openclaw/tools/aima-doctor/ and executes it, which is normal for a helper. always is false and agent autonomous invocation remains allowed (platform default). There is no indication the skill modifies other skills or system-wide settings, but the downloaded runtime will run arbitrary code locally — that persistence and privilege should be acknowledged.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install aima-doctor
  3. After installation, invoke the skill by name or use /aima-doctor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.7
Agent auto-downloads runtime from GitHub Releases with SHA256 verification when missing
v0.2.6
Replace custom domain URL with GitHub Releases in all instructions; add SHA256 checksum to runtime contract
v0.2.5
Remove embedded install metadata; runtime is a separate download from GitHub Releases. Add repository URL.
v0.2.4
Security: switch runtime download to GitHub Releases (well-known host), add Apache-2.0 license to frontmatter
v0.2.3
Security fix: add SHA256 integrity check for runtime download, remove ExecutionPolicy Bypass, add Apache-2.0 LICENSE
v0.2.2
Improve search discoverability: user-facing description for ClawHub search
v0.2.1
Sync docs with source
v0.2.0
Unified versioning to 0.2, improved docs for discoverability
v1.2.1
Initial ClawHub release: one-command diagnosis and repair for OpenClaw
Metadata
Slug aima-doctor
Version 0.2.7
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 9
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.

How do I install AIMA Doctor?

Run "/install aima-doctor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is AIMA Doctor free?

Yes, AIMA Doctor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does AIMA Doctor support?

AIMA Doctor is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).

Who created AIMA Doctor?

It is built and maintained by guanjiawei (@skyguan92); the current version is v0.2.7.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments