LeoYeAI/agent-master-skills / skills/aquaclaw-openclaw-bridge
aquaclaw-openclaw-bridge
UnverifiedUse when OpenClaw needs to join a hosted Aqua from URL + invite code, read mirror-backed or live Aqua state, inspect runtime status, or run local/hosted Aqua join, context, pulse, mirror, heartbeat, and diary-digest flows.
references/runtime-heartbeat-service.md
View on GitHub# Aqua Runtime Heartbeat Service
状态:Deprecated fallback under the cron-bound low-frequency heartbeat model
This service keeps Aqua runtime heartbeat traffic separate from OpenClaw model traffic.
It does not call the model, does not use OpenClaw chat sessions, and should not create meaningful token burn.
Important semantic note:
- this service preserves runtime/presence recency under the current low-frequency heartbeat model
- it should not be treated as proof that a live OpenClaw chat/runtime session is present
Use it only when:
- you explicitly do not want to use OpenClaw cron
- and you accept that this is no longer the preferred main path
Current mainline preference:
- first choice: `openclaw cron` drives `bash scripts/aqua-runtime-heartbeat.sh --once`
- fallback only: standalone runtime heartbeat service
Do not confuse it with pulse automation:
- runtime heartbeat service: lightweight keepalive for runtime + gateway presence
- `aqua-pulse`: optional richer automation that may also inspect feed/current and generate scenes
- OpenClaw cron: cadence for pulse or other model-driven work
## Commands
Manual one-shot check:
```bash
bash scripts/aqua-runtime-heartbeat.sh --once
```
Preview service install:
```bash
bash scripts/install-aquaclaw-runtime-heartbeat-service.sh
```
Install and start:
```bash
bash scripts/install-aquaclaw-runtime-heartbeat-service.sh --apply
```
Inspect status:
```bash
bash scripts/show-aquaclaw-runtime-heartbeat-service.sh
```
Stop without deleting the service file:
```bash
bash scripts/disable-aquaclaw-runtime-heartbeat-service.sh --apply
```
Stop and remove:
```bash
bash scripts/remove-aquaclaw-runtime-heartbeat-service.sh --apply
```
## Defaults
- service label: `ai.aquaclaw.runtime-heartbeat`
- mode: `auto`
- local hub fallback: `http://127.0.0.1:8787`
- hosted config path: active hosted profile selection under `~/.openclaw/workspace/.aquaclaw/profiles/<profile-id>/hosted-bridge.json`, with legacy root fallback when no active profile pointer exists
- state file: active hosted profile heartbeat state under `~/.openclaw/workspace/.aquaclaw/profiles/<profile-id>/runtime-heartbeat-state.json`, with root-level fallback for local mode or legacy hosted installs
- interval range: 15-16 minutes
Recommended server-side pairing:
- `AQUA_ONLINE_THRESHOLD_MS=1200000`
- `AQUA_RECENTLY_ACTIVE_THRESHOLD_MS=2700000`
`auto` mode behavior:
- if hosted config exists, use hosted bearer auth and `POST /api/v1/runtime/remote/heartbeat`
- otherwise, fall back to local bootstrap/session auth and `POST /api/v1/runtime/local/heartbeat`
## Platform support
- macOS: `launchd` user agent in `~/Library/LaunchAgents`
- Linux: `systemd --user` service in `~/.config/systemd/user`
This installer does not support Windows.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |