← 返回 Skills 市场
Claw Sos
作者
robertfarkash29-source
· GitHub ↗
· v6.1.2
· MIT-0
138
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install claw-sos
功能描述
Install, run, and manage the SOS emergency recovery tool for OpenClaw instances. Use when (1) the bot stops responding on Telegram/Discord and needs diagnosi...
使用说明 (SKILL.md)
claw-sos
Emergency recovery tool for OpenClaw. Diagnoses and fixes unresponsive bots via SSH.
Install
The script is bundled at scripts/sos.sh. Install locally:
cp scripts/sos.sh /usr/local/bin/sos
chmod +x /usr/local/bin/sos
To install on a remote machine:
scp scripts/sos.sh root@\x3CIP>:/usr/local/bin/sos
ssh root@\x3CIP> "chmod +x /usr/local/bin/sos"
Alternative — install from GitHub:
curl -fsSL https://raw.githubusercontent.com/clawsos/claw-sos/main/install.sh | bash
Usage
Interactive (human via SSH)
sos # whiptail arrow-key menu
Non-interactive (agent or cron)
sos auto # autofix: diagnose → doctor → restart → force → nuclear
sos net # network check only
sos tg # telegram test message
sos --version
sos --help
When the bot is down — decision tree
- Run
sos auto— handles 95% of cases automatically - If autofix fails → run
sos net— if network is broken, fix DNS/internet first - If network is fine but bot still down → run
sos tg— check Telegram delivery - If Telegram fails → check bot token validity
- Last resort →
sosmenu option 9 (Nuclear) — kills everything and starts fresh
Menu Options
| # | Name | What it does | Safe? |
|---|---|---|---|
| 1 | Check status | Gateway running, RAM, disk, version | ✅ Read-only |
| 2 | Restart | Graceful restart | ✅ Safe |
| 3 | Force kill | Kill process + restart | ⚠️ Drops active sessions |
| 4 | Rollback | Revert to previous version + config | ⚠️ Downgrade |
| 5 | View logs | Last 50 lines of gateway log | ✅ Read-only |
| 6 | Full diagnostic | RAM, disk, Telegram, sessions, process | ✅ Read-only |
| 7 | Backup config | Save config + version before changes | ✅ Safe |
| 8 | Self-test | Verify SOS script works | ✅ Read-only |
| 9 | Nuclear | Kill ALL openclaw processes, reload | 🔴 Last resort |
| 10 | Autofix | Escalating auto-repair | ⚠️ May restart |
| 11 | Network check | DNS, internet, Telegram API, Anthropic | ✅ Read-only |
| 12 | Telegram test | Send real test message | ✅ Safe |
Autofix Escalation Order
- Diagnose: process, RAM, disk
- Clean RAM/disk if critical
openclaw doctor --fix- Graceful restart → wait 15s → check
- Force kill + restart → wait 15s → check
- Nuclear (kill all + reload)
Stops as soon as gateway is healthy.
Log Location
All actions logged to ~/.openclaw/backups/sos.log. Read this to understand what happened during recovery:
cat ~/.openclaw/backups/sos.log
Platform Support
- Linux: Full support (systemd, journalctl, free, /proc)
- macOS: Full support (launchctl, log show, vm_stat, purge, dialog fallback)
- Docker: Partial — no systemd, manual fallback works
Credentials
This skill uses no API keys or tokens of its own. It reads existing OpenClaw config to:
- Check gateway status (local process, no network)
- Send Telegram test messages (uses the bot token already configured in
openclaw.json) - Check Anthropic API reachability (HTTPS ping only, no auth)
No credentials are stored, transmitted, or required to install or run SOS.
Source
安全使用建议
This skill appears to do what it says: an on-host emergency recovery helper for OpenClaw. Before installing or running it, consider: (1) Review openclaw.json — the script will read your OpenClaw config (including any bot token) to run Telegram tests; ensure you trust local config usage. (2) The installer offers a curl|bash option; prefer copying the provided sos.sh and inspecting it yourself rather than piping remote code directly into a shell. (3) Recovery actions (force kill, nuclear) are destructive by design — run them only when you understand the consequences and have backups (sos logs and config backups are stored at ~/.openclaw/backups/). (4) The script needs privileges to manage services and kill processes; run as an authorized administrator and audit activity in ~/.openclaw/backups/sos.log. If you want greater assurance, inspect the full sos.sh contents (you have them in the bundle) to confirm there are no network endpoints beyond common checks (google.com, Telegram endpoints) and no unexpected remote uploads.
功能分析
Type: OpenClaw Skill
Name: claw-sos
Version: 6.1.2
The claw-sos skill bundle provides a powerful system recovery utility (sos.sh) with high-risk capabilities including process termination, service management, and software reinstallation. Key indicators include the extraction of sensitive Telegram bot tokens from local configuration files (openclaw.json), the ability to overwrite system DNS settings (/etc/resolv.conf), and the use of 'curl | bash' installation patterns from a remote GitHub repository (clawsos/claw-sos). While these functions are aligned with the stated purpose of emergency bot recovery, the broad administrative access and potential for system-wide disruption make it a significant attack surface if misused by an AI agent.
能力评估
Purpose & Capability
Name/description (SOS emergency recovery for OpenClaw) align with the included scripts: sos.sh implements diagnostics, restart/kill/rollback, network checks, Telegram test, and logging; install/uninstall scripts match the expected need to place a helper binary in /usr/local/bin. No unrelated credentials or unrelated platform APIs are requested.
Instruction Scope
SKILL.md and sos.sh stay within recovery scope: they read the OpenClaw config (openclaw.json), inspect processes, logs, services (systemd/launchctl), run network checks (DNS/HTTP), and optionally send a Telegram test using the already-configured bot token. The instructions do ask the operator to scp/ssh as root for remote installs and to run potentially destructive actions (force kill / nuclear), which is appropriate for an emergency tool but requires explicit user consent when performed.
Install Mechanism
No packaged install spec in registry; install.sh offers installing by copying the bundled script or via curl to a raw.githubusercontent.com URL (GitHub raw). Using GitHub raw is a known release host (reasonable), but piping raw install scripts to bash (curl | bash) is inherently riskier — standard caution applies. No downloads from obscure hosts or shorteners were observed.
Credentials
The skill declares no required env vars and does not request external secrets. The script reads OPENCLAW_HOME (optional) and openclaw.json to access the existing OpenClaw configuration (including the bot token already configured there) in order to run Telegram tests; this is proportional to its stated purpose. The script requires privileged operations (systemctl, killing processes) which is expected for a recovery tool.
Persistence & Privilege
always:false and user-invocable:true. The skill does write logs to ~/.openclaw/backups/sos.log and may start/stop services or run node to start a gateway — actions appropriate for recovery. It does not request to persist as a platform-wide skill or modify other skills' configs.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install claw-sos - 安装完成后，直接呼叫该 Skill 的名称或使用
/claw-sos触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v6.1.2
fix: remove invalid local keyword outside function scope in main menu loop (bash syntax error)
v6.1.1
Bundle sos.sh in package, add credentials section, prefer local install over curl|bash
v6.1.0
Initial release: emergency recovery tool for OpenClaw. Whiptail TUI, autofix, rollback, network check, Telegram test. Linux + macOS.
元数据
常见问题
Claw Sos 是什么？
Install, run, and manage the SOS emergency recovery tool for OpenClaw instances. Use when (1) the bot stops responding on Telegram/Discord and needs diagnosi... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 138 次。
如何安装 Claw Sos？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install claw-sos」即可一键安装，无需额外配置。
Claw Sos 是免费的吗？
是的，Claw Sos 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Claw Sos 支持哪些平台？
Claw Sos 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Claw Sos？
由 robertfarkash29-source（@robertfarkash29-source）开发并维护，当前版本 v6.1.2。
推荐 Skills