{"skill":{"slug":"clawpulse-bridge","displayName":"Clawpulse Bridge","summary":"Configure and maintain ClawPulse integration for OpenClaw, including token-protected status bridge, Tailscale-safe access, iOS endpoint/token defaults, and t...","description":"---\nname: clawpulse\ndescription: Configure and maintain ClawPulse integration for OpenClaw, including token-protected status bridge, Tailscale-safe access, iOS endpoint/token defaults, and troubleshooting for ATS/auth/sync issues. Use when setting up a new machine, rotating tokens, fixing ClawPulse connectivity, or enabling assistant name + token usage + thought metadata in status responses.\n---\n\n# ClawPulse\n\n## Overview\nSet up a secure status bridge from OpenClaw to ClawPulse and keep it working with minimal manual steps.\n\n## Dependencies\n- Required: `openclaw`, `python3`\n- Optional (remote access only): `tailscale`\n\n## Quick Workflow\n1. One-command bootstrap (recommended): `bash scripts/bootstrap_clawpulse.sh --apply`.\n2. This runs bridge + monitor setup, then prints QR/token for app import.\n3. Default bind is remote-ready (`0.0.0.0`) for mobile devices on Tailscale/LAN.\n4. If sync fails, use the troubleshooting checklist.\n\n## Step 1 — Bootstrap the bridge\nRun:\n\n```bash\n# Dry-run: generate token/server file and print settings (no background process)\nbash scripts/setup_clawpulse_bridge.sh\n\n# Start service (remote-ready default + QR)\nbash scripts/setup_clawpulse_bridge.sh --apply\n\n# Optional local-only mode (hardened)\nBIND_HOST=127.0.0.1 bash scripts/setup_clawpulse_bridge.sh --apply\n```\n\nExpected outputs:\n- endpoint (local or Tailscale format)\n- bearer token\n- bind host/port and log path\n\n## Step 2 — Validate response contract\nThe bridge response should include at least:\n\n```json\n{\n  \"online\": true,\n  \"assistantName\": \"OpenClaw\",\n  \"workStatus\": \"工作中\",\n  \"tokenUsage\": {\"prompt\": 1, \"completion\": 2, \"total\": 3},\n  \"thought\": \"...\"\n}\n```\n\n## Step 3 — Wire the app\nUse in ClawPulse:\n- URL: `http://<tailscale-or-lan-ip>:8787/health`\n- Token: Bearer token from setup script\n- Polling default: 5s (more responsive)\n\n## Monitor mode (recommended)\nUse monitor as the public endpoint, keep bridge as internal source.\n\n```bash\n# Start/restart monitor (reads bridge and applies anti-flap state machine)\nbash scripts/setup_clawpulse_monitor.sh --apply\n```\n\nThen configure app with monitor endpoint/token (from script output or QR), not bridge token.\n\n## Troubleshooting\n- HTTP blocked on iOS: ensure app Info.plist has ATS exception for development, or use HTTPS.\n- 401 auth error: token mismatch; regenerate and reapply.\n- 403 forbidden: source IP is not local/Tailscale; confirm the device is connected to Tailscale.\n- Timeout: check bridge process and network reachability.\n- Wrong display name: update `workspace/IDENTITY.md` Name field.\n\n## Token rotation\nRe-run setup script with `ROTATE_TOKEN=1`:\n\n```bash\nROTATE_TOKEN=1 bash scripts/setup_clawpulse_bridge.sh\n```\n\nUpdate token in ClawPulse immediately.\n","topics":["Sync"],"tags":{"latest":"2.0.4","openclaw":"1.0.5","tailscale":"1.0.5"},"stats":{"comments":0,"downloads":715,"installsAllTime":27,"installsCurrent":0,"stars":1,"versions":11},"createdAt":1772682745814,"updatedAt":1778491726627},"latestVersion":{"version":"2.0.4","createdAt":1772733155267,"changelog":"Add one-command bootstrap and update guides for monitor-first setup","license":null},"metadata":null,"owner":{"handle":"virtual-ny","userId":"s172fey5cgfzjcxaws7r8pyy7n8845s5","displayName":"virtual-ny","image":"https://avatars.githubusercontent.com/u/214746569?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089768131}}