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-hosted-pulse-service-common.sh

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

set -euo pipefail

aquaclaw_hp_default_label() {
  echo "${AQUACLAW_HOSTED_PULSE_LABEL:-ai.aquaclaw.hosted-pulse}"
}

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

aquaclaw_hp_default_service_path() {
  echo "${AQUACLAW_HOSTED_PULSE_SERVICE_PATH:-$HOME/.local/bin:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin}"
}

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

aquaclaw_hp_default_pulse_state_file() {
  echo "${AQUACLAW_HOSTED_PULSE_STATE:-}"
}

aquaclaw_hp_default_loop_state_file() {
  echo "${AQUACLAW_HOSTED_PULSE_LOOP_STATE_FILE:-}"
}

aquaclaw_hp_default_min_seconds() {
  echo "${AQUACLAW_HOSTED_PULSE_MIN_SECONDS:-1200}"
}

aquaclaw_hp_default_jitter_seconds() {
  echo "${AQUACLAW_HOSTED_PULSE_JITTER_SECONDS:-2100}"
}

aquaclaw_hp_default_failure_min_seconds() {
  echo "${AQUACLAW_HOSTED_PULSE_FAILURE_MIN_SECONDS:-180}"
}

aquaclaw_hp_default_failure_jitter_seconds() {
  echo "${AQUACLAW_HOSTED_PULSE_FAILURE_JITTER_SECONDS:-120}"
}

aquaclaw_hp_default_timeout_ms() {
  echo "${AQUACLAW_HOSTED_PULSE_TIMEOUT_MS:-120000}"
}

aquaclaw_hp_default_timezone() {
  echo "${AQUACLAW_HOSTED_PULSE_TIMEZONE:-Asia/Shanghai}"
}

aquaclaw_hp_default_author_agent() {
  echo "${AQUACLAW_HOSTED_PULSE_AUTHOR_AGENT:-auto}"
}

aquaclaw_hp_default_quiet_hours() {
  if [[ "${AQUACLAW_HOSTED_PULSE_QUIET_HOURS+x}" == "x" ]]; then
    echo "${AQUACLAW_HOSTED_PULSE_QUIET_HOURS}"
  else
    echo "00:00-08:00"
  fi
}

aquaclaw_hp_default_feed_limit() {
  echo "${AQUACLAW_HOSTED_PULSE_FEED_LIMIT:-6}"
}

aquaclaw_hp_default_social_cooldown_minutes() {
  echo "${AQUACLAW_HOSTED_PULSE_SOCIAL_COOLDOWN_MINUTES:-240}"
}

aquaclaw_hp_default_dm_cooldown_minutes() {
  echo "${AQUACLAW_HOSTED_PULSE_DM_COOLDOWN_MINUTES:-180}"
}

aquaclaw_hp_default_dm_target_cooldown_minutes() {
  echo "${AQUACLAW_HOSTED_PULSE_DM_TARGET_COOLDOWN_MINUTES:-720}"
}

aquaclaw_hp_default_stdout_log() {
  echo "${AQUACLAW_HOSTED_PULSE_STDOUT_LOG:-$HOME/.openclaw/logs/aquaclaw-hosted-pulse.log}"
}

aquaclaw_hp_default_stderr_log() {
  echo "${AQUACLAW_HOSTED_PULSE_STDERR_LOG:-$HOME/.openclaw/logs/aquaclaw-hosted-pulse.err.log}"
}

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

aquaclaw_hp_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_hp_script_dir() {
  cd "$(dirname "${BASH_SOURCE[0]}")" && pwd
}

aquaclaw_hp_pulse_script_path() {
  local script_dir
  script_dir="$(aquaclaw_hp_script_dir)"
  echo "${script_dir}/aqua-hosted-pulse.mjs"
}

aquaclaw_hp_script_path() {
  local script_dir
  script_dir="$(aquaclaw_hp_script_dir)"
  echo "${script_dir}/aqua-hosted-pulse-loop.mjs"
}

aquaclaw_hp_resolve_openclaw_bin() {
  local service_path="$1"
  local explicit_bin="${2:-${OPENCLAW_BIN:-}}"
  local candidate=""

  if [[ -n "${explicit_bin}" ]]; then
    candidate="${explicit_bin}"
    if [[ "${candidate}" != /* ]]; then
      candidate="$(PATH="${service_path}" command -v "${candidate}" || true)"
    fi
    if [[ -n "${candidate}" && -x "${candidate}" ]]; then
      echo "${candidate}"
      return 0
    fi
    return 1
  fi

  candidate="$(PATH="${service_path}" command -v openclaw || true)"
  if [[ -n "${candidate}" && -x "${candidate}" ]]; then
    echo "${candidate}"
    return 0
  fi

  for candidate in \
    "$HOME/.local/bin/openclaw" \
    "/usr/local/bin/openclaw" \
    "/opt/homebrew/bin/openclaw" \
    "/usr/bin/openclaw"
  do
    if [[ -x "${candidate}" ]]; then
      echo "${candidate}"
      return 0
    fi
  done

  return 1
}

aquaclaw_hp_authoring_preflight_json() {
  local workspace_root="$1"
  local author_agent="$2"
  local service_path="$3"
  local openclaw_bin="$4"
  local node_bin
  local pulse_script_path
  node_bin="$(aquaclaw_hp_node_bin)"
  pulse_script_path="$(aquaclaw_hp_pulse_script_path)"
  env \
    PATH="${service_path}" \
    OPENCLAW_WORKSPACE_ROOT="${workspace_root}" \
    OPENCLAW_BIN="${openclaw_bin}" \
    AQUACLAW_HOSTED_PULSE_AUTHOR_AGENT="${author_agent}" \
    "${node_bin}" "${pulse_script_path}" --print-authoring-preflight
}

aquaclaw_hp_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_hp_print_command() {
  printf '%q ' "$@"
  printf '\n'
}

aquaclaw_hp_resolve_paths_json() {
  local workspace_root="$1"
  local hosted_config="$2"
  local pulse_state_file="$3"
  local loop_state_file="$4"
  local node_bin
  local script_path
  node_bin="$(aquaclaw_hp_node_bin)"
  script_path="$(aquaclaw_hp_script_path)"
  OPENCLAW_WORKSPACE_ROOT="${workspace_root}" \
  AQUACLAW_HOSTED_CONFIG="${hosted_config}" \
  AQUACLAW_HOSTED_PULSE_STATE="${pulse_state_file}" \
  AQUACLAW_HOSTED_PULSE_LOOP_STATE_FILE="${loop_state_file}" \
    "${node_bin}" "${script_path}" --print-paths
}

aquaclaw_hp_render_file() {
  local platform="$1"
  local label="$2"
  local workspace_root="$3"
  local node_bin="$4"
  local script_path="$5"
  local service_path="$6"
  local openclaw_bin="$7"
  local author_agent="$8"
  local hosted_config="$9"
  local pulse_state_file="${10}"
  local loop_state_file="${11}"
  local min_seconds="${12}"
  local jitter_seconds="${13}"
  local failure_min_seconds="${14}"
  local failure_jitter_seconds="${15}"
  local timeout_ms="${16}"
  local timezone="${17}"
  local quiet_hours="${18}"
  local feed_limit="${19}"
  local social_cooldown_minutes="${20}"
  local dm_cooldown_minutes="${21}"
  local dm_target_cooldown_minutes="${22}"
  local stdout_log="${23}"
  local stderr_log="${24}"

  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 hosted participant randomized pulse scheduler</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>PATH</key>
      <string>${service_path}</string>
      <key>OPENCLAW_WORKSPACE_ROOT</key>
      <string>${workspace_root}</string>
      <key>OPENCLAW_BIN</key>
      <string>${openclaw_bin}</string>
      <key>AQUACLAW_HOSTED_PULSE_AUTHOR_AGENT</key>
      <string>${author_agent}</string>
      <key>AQUACLAW_HOSTED_CONFIG</key>
      <string>${hosted_config}</string>
      <key>AQUACLAW_HOSTED_PULSE_STATE</key>
      <string>${pulse_state_file}</string>
      <key>AQUACLAW_HOSTED_PULSE_LOOP_STATE_FILE</key>
      <string>${loop_state_file}</string>
      <key>AQUACLAW_HOSTED_PULSE_MIN_SECONDS</key>
      <string>${min_seconds}</string>
      <key>AQUACLAW_HOSTED_PULSE_JITTER_SECONDS</key>
      <string>${jitter_seconds}</string>
      <key>AQUACLAW_HOSTED_PULSE_FAILURE_MIN_SECONDS</key>
      <string>${failure_min_seconds}</string>
      <key>AQUACLAW_HOSTED_PULSE_FAILURE_JITTER_SECONDS</key>
      <string>${failure_jitter_seconds}</string>
      <key>AQUACLAW_HOSTED_PULSE_TIMEOUT_MS</key>
      <string>${timeout_ms}</string>
      <key>AQUACLAW_HOSTED_PULSE_TIMEZONE</key>
      <string>${timezone}</string>
      <key>AQUACLAW_HOSTED_PULSE_QUIET_HOURS</key>
      <string>${quiet_hours}</string>
      <key>AQUACLAW_HOSTED_PULSE_FEED_LIMIT</key>
      <string>${feed_limit}</string>
      <key>AQUACLAW_HOSTED_PULSE_SOCIAL_COOLDOWN_MINUTES</key>
      <string>${social_cooldown_minutes}</string>
      <key>AQUACLAW_HOSTED_PULSE_DM_COOLDOWN_MINUTES</key>
      <string>${dm_cooldown_minutes}</string>
      <key>AQUACLAW_HOSTED_PULSE_DM_TARGET_COOLDOWN_MINUTES</key>
      <string>${dm_target_cooldown_minutes}</string>
    </dict>
  </dict>
</plist>
EOF
      ;;
    linux)
      cat <<EOF
[Unit]
Description=AquaClaw hosted participant randomized pulse scheduler
After=network-online.target

[Service]
Type=simple
WorkingDirectory=${workspace_root}
ExecStart=${node_bin} ${script_path}
Restart=always
RestartSec=5
Environment=HOME=${HOME}
Environment=PATH=${service_path}
Environment=OPENCLAW_WORKSPACE_ROOT=${workspace_root}
Environment=OPENCLAW_BIN=${openclaw_bin}
Environment=AQUACLAW_HOSTED_PULSE_AUTHOR_AGENT=${author_agent}
Environment=AQUACLAW_HOSTED_CONFIG=${hosted_config}
Environment=AQUACLAW_HOSTED_PULSE_STATE=${pulse_state_file}
Environment=AQUACLAW_HOSTED_PULSE_LOOP_STATE_FILE=${loop_state_file}
Environment=AQUACLAW_HOSTED_PULSE_MIN_SECONDS=${min_seconds}
Environment=AQUACLAW_HOSTED_PULSE_JITTER_SECONDS=${jitter_seconds}
Environment=AQUACLAW_HOSTED_PULSE_FAILURE_MIN_SECONDS=${failure_min_seconds}
Environment=AQUACLAW_HOSTED_PULSE_FAILURE_JITTER_SECONDS=${failure_jitter_seconds}
Environment=AQUACLAW_HOSTED_PULSE_TIMEOUT_MS=${timeout_ms}
Environment=AQUACLAW_HOSTED_PULSE_TIMEZONE=${timezone}
Environment=AQUACLAW_HOSTED_PULSE_QUIET_HOURS=${quiet_hours}
Environment=AQUACLAW_HOSTED_PULSE_FEED_LIMIT=${feed_limit}
Environment=AQUACLAW_HOSTED_PULSE_SOCIAL_COOLDOWN_MINUTES=${social_cooldown_minutes}
Environment=AQUACLAW_HOSTED_PULSE_DM_COOLDOWN_MINUTES=${dm_cooldown_minutes}
Environment=AQUACLAW_HOSTED_PULSE_DM_TARGET_COOLDOWN_MINUTES=${dm_target_cooldown_minutes}
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