Skip to content

LeoYeAI/agent-master-skills / skills/aquaclaw-openclaw-bridge

aquaclaw-openclaw-bridge

Unverified

Use 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.

FileKindSize
README.mdmarkdown9.9 KB
SKILL.mdskill md24.4 KB
_meta.jsonconfig304 B
agents/openai.yamlconfig2.7 KB
references/MEMORY.example.mdmarkdown617 B
references/TOOLS.example.mdmarkdown7.2 KB
references/beginner-install-connect-switch.mdmarkdown7.8 KB
references/bridge-workflow.mdmarkdown17.5 KB
references/clawhub-release.mdmarkdown3.4 KB
references/command-reference.mdmarkdown14.5 KB
references/doc-map.mdmarkdown4.2 KB
references/hosted-profile-plan.mdmarkdown10.2 KB
references/mirror-memory-boundary.mdmarkdown2.2 KB
references/mirror-pressure-envelope.mdmarkdown3.8 KB
references/mirror-service.mdmarkdown3.5 KB
references/openclaw-cron-template.mdmarkdown1.9 KB
references/public-install.mdmarkdown11.7 KB
references/runtime-heartbeat-service.mdmarkdown2.7 KB
scripts/README.mdmarkdown2.7 KB
scripts/aqua-context.shscript199 B
scripts/aqua-daily-intent.mjsscript57.1 KB
scripts/aqua-daily-intent.shscript151 B
scripts/aqua-hosted-context.mjsscript11.1 KB
scripts/aqua-hosted-context.shscript153 B
scripts/aqua-hosted-direct-message.mjsscript8.8 KB
scripts/aqua-hosted-direct-message.shscript161 B
scripts/aqua-hosted-intro.mjsscript13.8 KB
scripts/aqua-hosted-intro.shscript151 B
scripts/aqua-hosted-join.mjsscript13.5 KB
scripts/aqua-hosted-join.shscript150 B
scripts/aqua-hosted-profile.mjsscript19.8 KB
scripts/aqua-hosted-profile.shscript153 B
scripts/aqua-hosted-public-expression.mjsscript7.6 KB
scripts/aqua-hosted-public-expression.shscript163 B
scripts/aqua-hosted-pulse-loop.mjsscript17.6 KB
scripts/aqua-hosted-pulse-service-common.shscript10.1 KB
scripts/aqua-hosted-pulse.mjsscript115.2 KB
scripts/aqua-hosted-pulse.shscript151 B
scripts/aqua-hosted-relationship.mjsscript15.4 KB
scripts/aqua-hosted-relationship.shscript159 B
scripts/aqua-launch.shscript199 B
scripts/aqua-life-loop-read.mjsscript27.8 KB
scripts/aqua-life-loop-read.shscript154 B
scripts/aqua-life-loop-writeback.mjsscript18.0 KB
scripts/aqua-local-profile.mjsscript11.6 KB
scripts/aqua-local-profile.shscript147 B
scripts/aqua-mirror-common.mjsscript17.2 KB
scripts/aqua-mirror-daily-digest.mjsscript24.0 KB
scripts/aqua-mirror-daily-digest.shscript153 B
scripts/aqua-mirror-envelope.mjsscript24.4 KB
scripts/aqua-mirror-envelope.shscript154 B
scripts/aqua-mirror-memory-synthesis.mjsscript26.5 KB
scripts/aqua-mirror-memory-synthesis.shscript157 B
scripts/aqua-mirror-read.mjsscript24.4 KB
scripts/aqua-mirror-read.shscript150 B
scripts/aqua-mirror-service-common.shscript6.7 KB
scripts/aqua-mirror-status.mjsscript14.6 KB
scripts/aqua-mirror-status.shscript152 B
scripts/aqua-mirror-sync.mjsscript35.2 KB
scripts/aqua-mirror-sync.shscript150 B
scripts/aqua-profile.mjsscript19.8 KB
scripts/aqua-profile.shscript146 B
scripts/aqua-pulse.shscript197 B
scripts/aqua-runtime-heartbeat-service-common.shscript4.9 KB
scripts/aqua-runtime-heartbeat.mjsscript19.4 KB
scripts/aqua-runtime-heartbeat.shscript156 B
scripts/aqua-sea-diary-context.mjsscript33.0 KB
scripts/aqua-sea-diary-context.shscript151 B
scripts/aquaclaw-tools-md.mjsscript19.2 KB
scripts/build-openclaw-aqua-brief.shscript9.6 KB
scripts/community-memory-common.mjsscript14.8 KB
scripts/community-memory-read.mjsscript10.3 KB
scripts/community-memory-read.shscript156 B
scripts/community-memory-retrieval.mjsscript13.4 KB
scripts/community-memory-sync.mjsscript8.1 KB
scripts/community-memory-sync.shscript156 B
scripts/disable-aquaclaw-hosted-pulse-service.shscript1.5 KB
scripts/disable-aquaclaw-mirror-service.shscript1.5 KB
scripts/disable-aquaclaw-runtime-heartbeat-service.shscript1.5 KB
scripts/disable-openclaw-diary-cron.shscript1.0 KB
scripts/disable-openclaw-heartbeat-cron.shscript1.0 KB
scripts/disable-openclaw-pulse-cron.shscript1.0 KB
scripts/ensure-aquaclaw-community-agent.mjsscript8.9 KB
scripts/ensure-aquaclaw-community-agent.shscript165 B
scripts/env-readers.mjsscript1.3 KB
scripts/find-aquaclaw-repo.shscript835 B
scripts/hosted-aqua-common.mjsscript24.2 KB
scripts/hosted-aqua-http.mjsscript1.6 KB
scripts/install-aquaclaw-hosted-pulse-service.shscript10.4 KB
scripts/install-aquaclaw-mirror-service.shscript5.7 KB
scripts/install-aquaclaw-runtime-heartbeat-service.shscript4.6 KB
scripts/install-openclaw-diary-cron.shscript5.9 KB
scripts/install-openclaw-heartbeat-cron.shscript5.8 KB
scripts/install-openclaw-pulse-cron.shscript3.7 KB
scripts/openclaw-cron-common.shscript6.1 KB
scripts/openclaw-cron-job-find.mjsscript1.9 KB
scripts/openclaw-diary-cron-common.shscript3.0 KB
scripts/openclaw-heartbeat-cron-common.shscript1.2 KB
scripts/path-access.mjsscript199 B
scripts/remove-aquaclaw-hosted-pulse-service.shscript1.8 KB
scripts/remove-aquaclaw-mirror-service.shscript1.8 KB
scripts/remove-aquaclaw-runtime-heartbeat-service.shscript1.8 KB
scripts/remove-openclaw-diary-cron.shscript1.0 KB
scripts/remove-openclaw-heartbeat-cron.shscript1.0 KB
scripts/remove-openclaw-pulse-cron.shscript1.0 KB
scripts/resolve-aquaclaw-paths.mjsscript4.9 KB
scripts/resolve-openclaw-delivery-target.mjsscript7.6 KB
scripts/resolve-openclaw-user-timezone.mjsscript4.0 KB
scripts/show-aquaclaw-hosted-pulse-service.shscript6.0 KB
scripts/show-aquaclaw-mirror-service.shscript4.7 KB
scripts/show-aquaclaw-runtime-heartbeat-service.shscript2.7 KB
scripts/show-openclaw-diary-cron.shscript2.2 KB
scripts/show-openclaw-heartbeat-cron.shscript1.7 KB
scripts/show-openclaw-pulse-cron.shscript1.1 KB
scripts/soul-personality.mjsscript16.4 KB
scripts/sync-aquaclaw-tools-md.mjsscript3.8 KB
scripts/sync-aquaclaw-tools-md.shscript156 B

scripts/aqua-runtime-heartbeat-service-common.sh

View on GitHub
#!/usr/bin/env bash

set -euo pipefail

aquaclaw_hb_default_label() {
  echo "${AQUACLAW_RUNTIME_HEARTBEAT_LABEL:-ai.aquaclaw.runtime-heartbeat}"
}

aquaclaw_hb_default_workspace_root() {
  echo "${OPENCLAW_WORKSPACE_ROOT:-$HOME/.openclaw/workspace}"
}

aquaclaw_hb_default_hub_url() {
  echo "${AQUACLAW_HUB_URL:-http://127.0.0.1:8787}"
}

aquaclaw_hb_default_mode() {
  echo "${AQUACLAW_HEARTBEAT_MODE:-auto}"
}

aquaclaw_hb_default_hosted_config() {
  echo "${AQUACLAW_HOSTED_CONFIG:-}"
}

aquaclaw_hb_default_min_seconds() {
  echo "${AQUACLAW_HEARTBEAT_MIN_SECONDS:-900}"
}

aquaclaw_hb_default_jitter_seconds() {
  echo "${AQUACLAW_HEARTBEAT_JITTER_SECONDS:-60}"
}

aquaclaw_hb_default_timeout_ms() {
  echo "${AQUACLAW_HEARTBEAT_CONNECT_TIMEOUT_MS:-8000}"
}

aquaclaw_hb_default_state_file() {
  echo "${AQUACLAW_HEARTBEAT_STATE_FILE:-}"
}

aquaclaw_hb_default_stdout_log() {
  echo "${AQUACLAW_HEARTBEAT_STDOUT_LOG:-$HOME/.openclaw/logs/aquaclaw-runtime-heartbeat.log}"
}

aquaclaw_hb_default_stderr_log() {
  echo "${AQUACLAW_HEARTBEAT_STDERR_LOG:-$HOME/.openclaw/logs/aquaclaw-runtime-heartbeat.err.log}"
}

aquaclaw_hb_detect_platform() {
  case "$(uname -s)" in
    Darwin)
      echo "darwin"
      ;;
    Linux)
      echo "linux"
      ;;
    *)
      return 1
      ;;
  esac
}

aquaclaw_hb_node_bin() {
  local node_bin
  node_bin="$(command -v node || true)"
  if [[ -z "${node_bin}" ]]; then
    echo "could not find node in PATH" >&2
    return 1
  fi
  echo "${node_bin}"
}

aquaclaw_hb_script_dir() {
  cd "$(dirname "${BASH_SOURCE[0]}")" && pwd
}

aquaclaw_hb_script_path() {
  local script_dir
  script_dir="$(aquaclaw_hb_script_dir)"
  echo "${script_dir}/aqua-runtime-heartbeat.mjs"
}

aquaclaw_hb_service_file() {
  local platform="$1"
  local label="$2"
  case "${platform}" in
    darwin)
      echo "${HOME}/Library/LaunchAgents/${label}.plist"
      ;;
    linux)
      echo "${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user/${label}.service"
      ;;
    *)
      echo "unsupported platform: ${platform}" >&2
      return 1
      ;;
  esac
}

aquaclaw_hb_print_command() {
  printf '%q ' "$@"
  printf '\n'
}

aquaclaw_hb_render_file() {
  local platform="$1"
  local label="$2"
  local workspace_root="$3"
  local node_bin="$4"
  local script_path="$5"
  local hub_url="$6"
  local mode="$7"
  local hosted_config="$8"
  local min_seconds="$9"
  local jitter_seconds="${10}"
  local timeout_ms="${11}"
  local state_file="${12}"
  local stdout_log="${13}"
  local stderr_log="${14}"

  case "${platform}" in
    darwin)
      cat <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>${label}</string>
    <key>Comment</key>
    <string>AquaClaw runtime heartbeat fallback service</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>ThrottleInterval</key>
    <integer>5</integer>
    <key>WorkingDirectory</key>
    <string>${workspace_root}</string>
    <key>ProgramArguments</key>
    <array>
      <string>${node_bin}</string>
      <string>${script_path}</string>
    </array>
    <key>StandardOutPath</key>
    <string>${stdout_log}</string>
    <key>StandardErrorPath</key>
    <string>${stderr_log}</string>
    <key>EnvironmentVariables</key>
    <dict>
      <key>HOME</key>
      <string>${HOME}</string>
      <key>OPENCLAW_WORKSPACE_ROOT</key>
      <string>${workspace_root}</string>
      <key>AQUACLAW_HUB_URL</key>
      <string>${hub_url}</string>
      <key>AQUACLAW_HEARTBEAT_MODE</key>
      <string>${mode}</string>
      <key>AQUACLAW_HOSTED_CONFIG</key>
      <string>${hosted_config}</string>
      <key>AQUACLAW_HEARTBEAT_MIN_SECONDS</key>
      <string>${min_seconds}</string>
      <key>AQUACLAW_HEARTBEAT_JITTER_SECONDS</key>
      <string>${jitter_seconds}</string>
      <key>AQUACLAW_HEARTBEAT_CONNECT_TIMEOUT_MS</key>
      <string>${timeout_ms}</string>
      <key>AQUACLAW_HEARTBEAT_STATE_FILE</key>
      <string>${state_file}</string>
    </dict>
  </dict>
</plist>
EOF
      ;;
    linux)
      cat <<EOF
[Unit]
Description=AquaClaw runtime heartbeat fallback service
After=network-online.target

[Service]
Type=simple
WorkingDirectory=${workspace_root}
ExecStart=${node_bin} ${script_path}
Restart=always
RestartSec=5
Environment=HOME=${HOME}
Environment=OPENCLAW_WORKSPACE_ROOT=${workspace_root}
Environment=AQUACLAW_HUB_URL=${hub_url}
Environment=AQUACLAW_HEARTBEAT_MODE=${mode}
Environment=AQUACLAW_HOSTED_CONFIG=${hosted_config}
Environment=AQUACLAW_HEARTBEAT_MIN_SECONDS=${min_seconds}
Environment=AQUACLAW_HEARTBEAT_JITTER_SECONDS=${jitter_seconds}
Environment=AQUACLAW_HEARTBEAT_CONNECT_TIMEOUT_MS=${timeout_ms}
Environment=AQUACLAW_HEARTBEAT_STATE_FILE=${state_file}
StandardOutput=append:${stdout_log}
StandardError=append:${stderr_log}

[Install]
WantedBy=default.target
EOF
      ;;
    *)
      echo "unsupported platform: ${platform}" >&2
      return 1
      ;;
  esac
}
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 implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall