Don't Be Scary
/install dont-be-scary
dont-be-scary
Safe OpenClaw update with snapshot + auto-rollback. Survives the gateway restart that would otherwise kill the agent mid-operation.
When to invoke
Trigger when the user requests an OpenClaw update or upgrade. Examples: "update openclaw", "upgrade openclaw", "actualízate", "openclaw update".
Do NOT call openclaw update directly — the gateway restart kills the calling agent before it can verify success or roll back.
How to use
Launch the script detached so it survives the gateway restart:
nohup "\x3Cpath-to-skill>/scripts/safe-update.sh" \x3C/dev/null >/dev/null 2>&1 & disown
Then tell the user: "Update launched in background. You'll get Telegram updates at each step." Do not wait for the script to finish — the gateway restart will likely terminate the current agent session. The user is the source of truth via Telegram.
The script's path inside an installed skill workspace is typically:
\x3Cworkspace>/skills/dont-be-scary/scripts/safe-update.sh
What the script does
- Reads bot token + chat_id from the user's
~/.openclaw/openclaw.json(Telegram default account, delivery target). - Snapshots
/opt/homebrew/lib/node_modules/openclawand/Applications/OpenClaw.appto/tmp/openclaw-rollback/\x3Ctimestamp>/(~500MB). - Sends Telegram: "🔄 Updating from \x3CX>".
- Runs
openclaw update --json(which restarts the gateway by itself). - Health check loop (180s) hitting
http://localhost:18789/. - Success → Telegram "✅ \x3CX> → \x3CY>", prunes old snapshots (keeps last 2).
- Failure → restores snapshot, restarts gateway via launchctl, Telegram "⚠️ rollback OK".
- Critical (rollback also failed) → Telegram urgent message pointing to
references/rescue-prompt.md.
Configuration via env vars (all optional)
Defaults match a standard brew install --cask openclaw setup. Override only if non-standard:
OPENCLAW_TG_CHAT_ID— Telegram chat to notify (default: auto-detect fromdelivery.targets[])OPENCLAW_TG_BOT— bot account name in config (default:default)OPENCLAW_CONFIG— path to openclaw.json (default:~/.openclaw/openclaw.json)OPENCLAW_NPM_DIR— npm install path (default:/opt/homebrew/lib/node_modules/openclaw)OPENCLAW_APP_DIR— .app bundle (default:/Applications/OpenClaw.app)OPENCLAW_GATEWAY_PORT— health check port (default:18789)OPENCLAW_PLIST— LaunchAgent (default:~/Library/LaunchAgents/ai.openclaw.gateway.plist)OPENCLAW_BIN— openclaw binary (default:/opt/homebrew/bin/openclaw)OPENCLAW_SNAP_ROOT— snapshot root (default:/tmp/openclaw-rollback)
Requirements
- macOS with brew cask install of OpenClaw
- ~500MB free in
/tmp - Telegram configured in
openclaw.json(channels.telegram.accounts.default.botToken+ a delivery target withchannel: telegramandto: \x3Cchat_id>) python3andcurlavailable (both shipped with macOS)
If the worst happens
If the script reports 🚨 CRITICAL, the gateway is down and the agent inside OpenClaw can't help itself. Open Claude Code on the same Mac and use the prompt in references/rescue-prompt.md to recover manually.
Logs
- Per-run log:
/tmp/openclaw-update-\x3Ctimestamp>.log - Update output:
/tmp/openclaw-update-\x3Ctimestamp>.update.json - Snapshots retained: 2 most recent in
/tmp/openclaw-rollback/
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install dont-be-scary - After installation, invoke the skill by name or use
/dont-be-scary - Provide required inputs per the skill's parameter spec and get structured output
What is Don't Be Scary?
Update OpenClaw safely on macOS (brew cask install) with automatic snapshot of the npm package + .app bundle, post-update health check, and automatic rollbac... It is an AI Agent Skill for Claude Code / OpenClaw, with 32 downloads so far.
How do I install Don't Be Scary?
Run "/install dont-be-scary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Don't Be Scary free?
Yes, Don't Be Scary is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Don't Be Scary support?
Don't Be Scary is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Don't Be Scary?
It is built and maintained by klouddy-cloud (@klouddy-cloud); the current version is v1.0.0.