# Send DeadClaw to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "deadclaw",
    "name": "DeadClaw",
    "source": "tencent",
    "type": "skill",
    "category": "其他",
    "sourceUrl": "https://clawhub.ai/Kintupercy/deadclaw",
    "canonicalUrl": "https://clawhub.ai/Kintupercy/deadclaw",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/deadclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=deadclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "deadclaw/docs/android-widget-guide.md",
      "deadclaw/docs/clawhub-listing.md",
      "deadclaw/docs/competitive-notes.md",
      "deadclaw/docs/iphone-shortcut-guide.md",
      "deadclaw/docs/launch-post.md",
      "deadclaw/docs/roadmap.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "deadclaw",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T04:38:53.333Z",
      "expiresAt": "2026-05-06T04:38:53.333Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=deadclaw",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=deadclaw",
        "contentDisposition": "attachment; filename=\"deadclaw-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "deadclaw"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/deadclaw"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/deadclaw",
    "downloadUrl": "https://openagent3.xyz/downloads/deadclaw",
    "agentUrl": "https://openagent3.xyz/skills/deadclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/deadclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/deadclaw/agent.md"
  }
}
```
## Documentation

### DeadClaw — Emergency Kill Switch for OpenClaw Agents

"One tap. Everything stops."

DeadClaw is a single-purpose emergency kill switch. When triggered, it immediately
halts all running OpenClaw agent processes, stops Docker containers, pauses all
scheduled cron jobs and heartbeats, kills all active sessions, and writes a
timestamped incident log. It then confirms back to whichever surface triggered it.

Works with both native OpenClaw installs and Docker-based deployments
(Hostinger VPS, etc.). Auto-detects your setup.

### Why DeadClaw Exists

The ClawHavoc attack (February 2026) exposed 1,184 malicious skills in the OpenClaw
ecosystem. People run agents autonomously — often overnight, often unattended. When
something goes wrong, you need a way to stop everything from wherever you are, even
from your phone. DeadClaw is that way.

### Activation Methods

DeadClaw supports three activation methods. All three execute the exact same kill
sequence — the only difference is how the user triggers it.

### Method 1: Message Trigger

The user sends a trigger word to any connected OpenClaw channel (Telegram, WhatsApp,
Discord, Slack, or any other connected channel). The following words activate DeadClaw:

kill or KILL
dead
stop everything
emergency stop
deadclaw
🔴

When a trigger word is detected:

Execute scripts/kill.sh from the DeadClaw skill directory
Capture the output (process count, containers stopped, cron jobs paused, timestamp)
Send confirmation back to the same channel the trigger came from:
🔴 DeadClaw activated. All agents stopped. [timestamp] — [X] killed ([X] processes, [X] containers). [X] cron jobs paused. See deadclaw.log for full report.

### Method 2: WebChat Kill Button

A persistent red button rendered in the OpenClaw WebChat dashboard. The HTML widget
is located at ui/deadclaw-button.html. It calls kill.sh via OpenClaw's WebChat
API hooks (window.OpenClaw.exec()). If the WebChat hooks are unavailable, the
button degrades to showing an error message with manual instructions.

To embed the button, use OpenClaw's WebChat customization hooks:

OpenClaw.WebChat.registerWidget('deadclaw-button', {
  src: 'skills/deadclaw/ui/deadclaw-button.html',
  position: 'top-bar',
  persistent: true
});

### Method 3: Phone Home Screen Shortcut

A pre-built shortcut that sends the kill trigger message (deadclaw) to the user's
configured Telegram bot. Setup guides for iOS and Android are in docs/:

docs/iphone-shortcut-guide.md — iOS Shortcuts setup
docs/android-widget-guide.md — Android widget setup (Tasker or HTTP Shortcuts)

### Watchdog (Passive Protection)

DeadClaw includes a background watchdog (scripts/watchdog.sh) that monitors for
dangerous conditions and auto-triggers the kill without any user action.

The watchdog checks every 60 seconds for (after a 5-minute startup grace period):

Runaway loops — Any agent process or Docker session running longer than 30 minutes
Token burn — Token spend exceeding 50,000 tokens in under 10 minutes
Unauthorized network — Outbound network calls to domains not on the user's whitelist
Sandbox escape — Any process attempting to write outside the designated OpenClaw workspace

The watchdog uses zero AI tokens — all checks use local system commands only.

When the watchdog auto-triggers, it sends an alert explaining the reason:
🔴 DeadClaw auto-triggered. Reason: [specific reason]. All processes stopped. Check deadclaw.log.

### Watchdog Configuration

The watchdog reads its thresholds from environment variables (with sensible defaults):

VariableDefaultDescriptionDEADCLAW_MAX_RUNTIME_MIN30Max agent runtime in minutes before auto-killDEADCLAW_MAX_TOKENS50000Max token spend in the monitoring windowDEADCLAW_TOKEN_WINDOW_MIN10Token spend monitoring window in minutesDEADCLAW_WHITELIST./network-whitelist.txtAllowed outbound domains (one per line)DEADCLAW_WORKSPACE$OPENCLAW_WORKSPACEDesignated workspace directory

Start the watchdog:

scripts/watchdog.sh start

Stop the watchdog:

scripts/watchdog.sh stop

### Status Check

User sends status to any connected channel. DeadClaw responds with a plain-English
health report by executing scripts/status.sh:

What agents are currently running (name, PID, uptime)
Current token spend rate
Whether the watchdog is active
Any warnings about approaching thresholds

### Restore After Kill

User sends restore to any connected channel. DeadClaw executes scripts/restore.sh,
which:

Shows what will be restored (backed-up crontab entries, stopped Docker containers, disabled services)
Prompts: "Restore [X] cron jobs from backup taken at [timestamp]? (yes/no)"
Restores the crontab from the most recent backup
Restarts stopped OpenClaw Docker containers
Detects the OpenClaw gateway
Confirms restoration with a summary

The watchdog does NOT auto-start after restore — the user verifies stability first,
then starts it manually with scripts/watchdog.sh start.

### Scripts Reference

ScriptPurposescripts/kill.shCore kill script — stops all agents + Docker containers, pauses cron, logs incidentscripts/watchdog.shBackground monitor daemon — auto-triggers kill on threshold breachscripts/status.shHealth report — shows running agents, Docker containers, token spend, watchdog statusscripts/restore.shPost-kill recovery — restores crontab, restarts Docker containers

All scripts support a --dry-run flag that logs what would happen without taking action.

### Incident Log

All kill events are logged to deadclaw.log in the skill directory. Each entry
records: timestamp, trigger source (channel name), trigger method (message/button/
watchdog/auto), processes killed (count and PIDs), Docker containers stopped, cron
jobs paused, and token spend at time of kill. The log is append-only and never
automatically cleared.

### Platform Support

DeadClaw works on both Linux (VPS, bare metal) and macOS (Mac Mini, MacBook).
Scripts auto-detect the OS and use the appropriate commands:

Linux: systemctl for services, pgrep for processes, Docker support
macOS: launchctl for agents, pgrep for processes, Docker support
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Kintupercy
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T04:38:53.333Z
- Expires at: 2026-05-06T04:38:53.333Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/deadclaw)
- [Send to Agent page](https://openagent3.xyz/skills/deadclaw/agent)
- [JSON manifest](https://openagent3.xyz/skills/deadclaw/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/deadclaw/agent.md)
- [Download page](https://openagent3.xyz/downloads/deadclaw)