ClawPulse
Overview
Set up a secure status bridge from OpenClaw to ClawPulse and keep it working with minimal manual steps.
Dependencies
- - Required:
openclaw, INLINECODE1 - Optional (remote access only): INLINECODE2
Quick Workflow
- 1. One-command bootstrap (recommended):
bash scripts/bootstrap_clawpulse.sh --apply. - This runs bridge + monitor setup, then prints QR/token for app import.
- Default bind is remote-ready (
0.0.0.0) for mobile devices on Tailscale/LAN. - If sync fails, use the troubleshooting checklist.
Step 1 — Bootstrap the bridge
Run:
CODEBLOCK0
Expected outputs:
- - endpoint (local or Tailscale format)
- bearer token
- bind host/port and log path
Step 2 — Validate response contract
The bridge response should include at least:
CODEBLOCK1
Step 3 — Wire the app
Use in ClawPulse:
- - URL: INLINECODE5
- Token: Bearer token from setup script
- Polling default: 5s (more responsive)
Monitor mode (recommended)
Use monitor as the public endpoint, keep bridge as internal source.
CODEBLOCK2
Then configure app with monitor endpoint/token (from script output or QR), not bridge token.
Troubleshooting
- - HTTP blocked on iOS: ensure app Info.plist has ATS exception for development, or use HTTPS.
- 401 auth error: token mismatch; regenerate and reapply.
- 403 forbidden: source IP is not local/Tailscale; confirm the device is connected to Tailscale.
- Timeout: check bridge process and network reachability.
- Wrong display name: update
workspace/IDENTITY.md Name field.
Token rotation
Re-run setup script with
ROTATE_TOKEN=1:
CODEBLOCK3
Update token in ClawPulse immediately.
ClawPulse
概述
建立从OpenClaw到ClawPulse的安全状态桥接，并以最少的手动步骤保持其运行。
依赖项
- - 必需：openclaw、python3
- 可选（仅限远程访问）：tailscale
快速工作流程
- 1. 一键引导（推荐）：bash scripts/bootstrap_clawpulse.sh --apply
- 此操作将运行桥接+监控设置，然后打印用于应用导入的二维码/令牌
- 默认绑定为远程就绪（0.0.0.0），适用于Tailscale/局域网上的移动设备
- 如果同步失败，请使用故障排除清单
步骤1 — 引导桥接
运行：
bash
预演：生成令牌/服务器文件并打印设置（无后台进程）
bash scripts/setup
clawpulsebridge.sh
启动服务（远程就绪默认 + 二维码）
bash scripts/setup
clawpulsebridge.sh --apply
可选仅本地模式（强化安全）
BIND
HOST=127.0.0.1 bash scripts/setupclawpulse_bridge.sh --apply
预期输出：
- - 端点（本地或Tailscale格式）
- 承载令牌
- 绑定主机/端口和日志路径
步骤2 — 验证响应契约
桥接响应应至少包含：
json
{
online: true,
assistantName: OpenClaw,
workStatus: 工作中,
tokenUsage: {prompt: 1, completion: 2, total: 3},
thought: ...
}
步骤3 — 连接应用
在ClawPulse中使用：
- - URL：http://:8787/health
- 令牌：来自设置脚本的承载令牌
- 轮询默认值：5秒（响应更灵敏）
监控模式（推荐）
使用监控作为公共端点，保持桥接作为内部源。
bash
启动/重启监控（读取桥接并应用防抖动状态机）
bash scripts/setup
clawpulsemonitor.sh --apply
然后使用监控端点/令牌（来自脚本输出或二维码）配置应用，而非桥接令牌。
故障排除
- - iOS上HTTP被阻止：确保应用Info.plist包含ATS开发例外，或使用HTTPS
- 401认证错误：令牌不匹配；重新生成并重新应用
- 403禁止：源IP不是本地/Tailscale；确认设备已连接到Tailscale
- 超时：检查桥接进程和网络可达性
- 显示名称错误：更新workspace/IDENTITY.md中的名称字段
令牌轮换
使用ROTATE_TOKEN=1重新运行设置脚本：
bash
ROTATETOKEN=1 bash scripts/setupclawpulse_bridge.sh
立即在ClawPulse中更新令牌。
