The emergency room for your OpenClaw gateway.
One command. Twenty checks. Six phases. Back from the brink.
Your gateway was fine yesterday. Today: plugins throwing api.config.get, openclaw doctor hangs forever, Discord silently ignores DMs, 18789 looks “busy” but isn’t yours, plugins.allow is empty, CLI and gateway don’t match versions — and you’re grepping JSON5 at 2 a.m.
ClawICU doesn’t replace OpenClaw. It’s the stretcher team: triage → diagnose → treat → verify — with backups, menus that work even through
curl | sh, and a doctor pass that won’t hang your terminal.
POSIX sh · stdin reattached to /dev/tty so interactive menus work when piped · Automatic backups before risky repairs where applicable.
|
xagent.icu — homepage 
|
|
Rescue script (illustrative terminal) — phases, vital-signs summary, and interactive menu as you’d see in a real run:
Screenshots are generated from the static export + a styled terminal mock; regenerate with npm run build && npm run build:readme-screenshots.
| 20 diagnostic modules | Config (JSON5), gateway /healthz, plugins & SDK, credentials, daemon (systemd / launchd), version skew, port 18789 (skips OpenClaw’s own listener), disk, channel policy, env, exec approvals, … |
| 6-phase protocol | Bootstrap → crash-safe doctor (~30s timeout) → standalone checks → triage “vital signs” → interactive treatment menu → execute repairs + verify |
| Real repairs | e.g. disable crashing plugins, fill plugins.allow, restart gateway for mismatch, tune channel policy paths — not just pretty logs |
| 25 issue guides | Deep pages on xagent.icu/docs — bookmark the one that matches your outage |
| ICU-themed site + SEO | Landing, docs, sitemap, structured data — built with Next.js static export |
| Share “SOS” | xagent.icu/sos + Open Graph card for quick Share to X from the homepage CTA |
flowchart LR
P0([0 Bootstrap]) --> P1([1 Doctor 30s cap])
P1 --> P2([2 Twenty checks])
P2 --> P3([3 Triage])
P3 --> P4([4 Menu])
P4 --> P5([5 Repair + verify])
| # | Phase | In one line |
|---|---|---|
| 0 | Bootstrap | OS, install flavor, temp workspace, logging. |
| 1 | Doctor | openclaw doctor with timeout; bad plugins can’t freeze the whole run. |
| 2 | Checks | 20 independent modules — not “one command said OK”. |
| 3 | Triage | Fatal / warn / info rolled into a single “patient chart”. |
| 4 | Menu | Auto · Quick · Full · Nuclear · Export · Quit — works via pipe. |
| 5 | Execute | Targeted fixes + re-verify after changes. |
Also on the site (not a numbered phase): Tool Unlock Panel — exec / browser / elevated / sandbox via openclaw config.
rescue/ # Modular checks + repairs + lib
scripts/build-rescue.sh # → dist/rescue.sh (inlined for curl | sh)
public/rescue.sh # Copy served by the static site
src/ # Next.js → static export to out/
public/sos-card.svg # Social share art → npm run build:share-card → .png
Rebuild bundle after editing rescue/:
sh scripts/build-rescue.sh && cp dist/rescue.sh public/rescue.shgit clone https://github.com/SonicBotMan/clawicu.git && cd clawicu
npm install
npm run dev # http://localhost:3000
npm run build # → out/
# Regenerate Twitter/OG PNG after editing public/sos-card.svg (needs Chrome/Chromium)
npm run build:share-card
# Regenerate README screenshots (needs Chrome; serves out/ on localhost briefly)
npm run build && npm run build:readme-screenshotsSpotted a new failure mode or a bad heuristic? Open an issue — PRs welcome.
MIT License · Made for operators who ship fast and fix faster.
ClawICU — when OpenClaw codes red, we go green.
网关昨天还好好的：今天可能是 插件崩在 api.config.get、openclaw doctor 卡死、Discord 策略导致消息全吞、18789 端口误报冲突、plugins.allow 为空、CLI 与 Gateway 版本不一致……你在凌晨两点对着 JSON5 和日志发呆。
ClawICU 不替代 OpenClaw，而是 分诊 → 检查 → 处置 → 复核：带 超时 的 doctor、20 个独立检查模块、
curl | sh下仍可交互的菜单，以及变更前的 备份 习惯。
| 官网首页 | 文档中心 |
|---|---|
 |
 |
终端救援示意：
截图由 npm run build && npm run build:readme-screenshots 生成（需本机 Chrome）。
- 20 个诊断模块：JSON5 配置、网关
/healthz、插件与 SDK、凭据、守护进程、版本不一致、端口（会识别是否为 OpenClaw 自身占用）、磁盘、频道策略等。 - 6 个阶段：Bootstrap → 30 秒超时 doctor → 独立检查 → 分诊 → 交互式处置方案 → 修复与验证。
- 25 篇故障百科：xagent.icu/docs。
- SOS 落地页 + 分享卡片：xagent.icu/sos（适合转发求助）。
- 官网与文档站：Next.js 静态导出，含 SEO 与站点地图。
| # | 阶段 | 一句话 |
|---|---|---|
| 0 | 引导 | 系统与安装方式、临时目录、日志。 |
| 1 | Doctor | openclaw doctor，超时保护，输出写入后续阶段使用。 |
| 2 | 检查 | 20 个模块并行于 doctor 结论，交叉验证。 |
| 3 | 分诊 | 致命 / 警告 / 信息汇总成「体征面板」。 |
| 4 | 菜单 | 自动 / 快速 / 完整 / 核选项等，管道下可交互。 |
| 5 | 执行 | 定向修复 + 再验证。 |
工具权限相关另见：工具解锁面板文档。
git clone https://github.com/SonicBotMan/clawicu.git && cd clawicu
npm install && npm run dev
# 修改 rescue/ 后：
sh scripts/build-rescue.sh && cp dist/rescue.sh public/rescue.sh
# 修改分享卡 SVG 后（需本机 Chrome/Chromium）：
npm run build:share-card欢迎 提交 Issue 或 PR。
MIT License · 脚本当前版本 0.2.0（见 CLAWICU_VERSION）
OpenClaw 红灯时，我们帮你拉回绿区。