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/openclaw-cron-common.sh

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

set -euo pipefail

aquaclaw_default_repo() {
  echo "${AQUACLAW_REPO:-$HOME/.openclaw/workspace/gateway-hub}"
}

aquaclaw_default_interval() {
  echo "${AQUACLAW_PULSE_EVERY:-37m}"
}

aquaclaw_default_timezone() {
  if [[ -n "${AQUACLAW_TIMEZONE:-}" ]]; then
    echo "${AQUACLAW_TIMEZONE}"
    return 0
  fi
  aquaclaw_resolve_user_timezone
}

aquaclaw_default_quiet_hours() {
  echo "${AQUACLAW_QUIET_HOURS:-00:00-08:00}"
}

aquaclaw_default_job_name() {
  echo "${AQUACLAW_PULSE_JOB_NAME:-aquaclaw-pulse}"
}

aquaclaw_default_session() {
  echo "${AQUACLAW_PULSE_SESSION:-isolated}"
}

aquaclaw_default_thinking() {
  echo "${AQUACLAW_PULSE_THINKING:-low}"
}

aquaclaw_default_timeout_seconds() {
  echo "${AQUACLAW_PULSE_TIMEOUT_SECONDS:-120}"
}

aquaclaw_default_description() {
  echo "AquaClaw pulse tick template (disabled by default)"
}

aquaclaw_build_message() {
  local repo="$1"
  local timezone="$2"
  local quiet_hours="$3"

  cat <<EOF
Use \$aquaclaw-openclaw-bridge. Read TOOLS.md for the preferred AquaClaw wrappers on this machine. Run the Aqua pulse wrapper against ${repo} with a live pulse tick, using --timezone ${timezone} --quiet-hours ${quiet_hours} --format markdown. Report whether the runtime heartbeat was written, whether a scene was generated, and why the pulse chose that branch. Do not create, edit, enable, disable, or remove cron jobs from inside the job itself. If AquaClaw is unavailable, say so directly.
EOF
}

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

aquaclaw_print_cron_schema_mismatch_hint() {
  cat >&2 <<'EOF'

AquaClaw diagnosis:
- the heartbeat/pulse/diary installer is asking OpenClaw to create an isolated cron agent-turn job
- your local OpenClaw gateway rejected that cron payload schema before the Aqua script even ran
- this points to a local OpenClaw CLI / Gateway version mismatch or an older Gateway scheduler schema on that machine
- it is not an Aqua remote-hub failure

Recommended local checks on that machine:
- `openclaw --version`
- `openclaw gateway status`
- `openclaw doctor --fix`
- `openclaw update`
- `openclaw gateway restart`

If the Gateway service is older than the CLI, update/restart the Gateway so they match, then rerun the AquaClaw onboarding step.
If AquaClaw already tried a local `doctor --fix` + `gateway restart` pass and the same schema error still remains, the next likely fix is `openclaw update`.
EOF
}

aquaclaw_should_auto_repair_cron_schema_mismatch() {
  local enabled="${AQUACLAW_OPENCLAW_AUTO_REPAIR_ON_CRON_SCHEMA_MISMATCH:-1}"
  case "${enabled}" in
    0|false|FALSE|no|NO)
      return 1
      ;;
    *)
      return 0
      ;;
  esac
}

aquaclaw_is_cron_schema_mismatch_output() {
  local output="$1"
  [[ "$output" == *"invalid cron.add params"* || "$output" == *"invalid cron.update params"* ]]
}

aquaclaw_attempt_local_openclaw_cron_repair() {
  local doctor_output=""
  local doctor_status=0
  local restart_output=""
  local restart_status=0

  echo "AquaClaw: attempting one local OpenClaw repair pass (doctor --fix + gateway restart) before retrying cron install." >&2

  set +e
  doctor_output="$(openclaw doctor --fix --non-interactive --yes 2>&1)"
  doctor_status=$?
  set -e
  if [[ -n "$doctor_output" ]]; then
    printf '%s\n' "$doctor_output" >&2
  fi
  if [[ "$doctor_status" -ne 0 ]]; then
    echo "AquaClaw: local OpenClaw doctor repair failed." >&2
    return "$doctor_status"
  fi

  set +e
  restart_output="$(openclaw gateway restart 2>&1)"
  restart_status=$?
  set -e
  if [[ -n "$restart_output" ]]; then
    printf '%s\n' "$restart_output" >&2
  fi
  if [[ "$restart_status" -ne 0 ]]; then
    echo "AquaClaw: local OpenClaw gateway restart failed." >&2
    return "$restart_status"
  fi

  sleep 2
  echo "AquaClaw: local OpenClaw repair pass completed; retrying cron install once." >&2
  return 0
}

aquaclaw_run_cron_command() {
  local output=""
  local status=0
  local mismatch=0

  set +e
  output="$("$@" 2>&1)"
  status=$?
  set -e

  if [[ "$status" -ne 0 ]]; then
    if aquaclaw_is_cron_schema_mismatch_output "$output"; then
      mismatch=1
    fi

    if [[ "$mismatch" -eq 1 ]] && aquaclaw_should_auto_repair_cron_schema_mismatch; then
      if [[ -n "$output" ]]; then
        printf '%s\n' "$output" >&2
      fi
      if aquaclaw_attempt_local_openclaw_cron_repair; then
        set +e
        output="$("$@" 2>&1)"
        status=$?
        set -e
        if [[ "$status" -eq 0 ]]; then
          echo "AquaClaw: cron install succeeded after local OpenClaw repair." >&2
          if [[ -n "$output" ]]; then
            printf '%s\n' "$output"
          fi
          return 0
        fi
        if aquaclaw_is_cron_schema_mismatch_output "$output"; then
          mismatch=1
        else
          mismatch=0
        fi
      fi
    fi

    if [[ -n "$output" ]]; then
      printf '%s\n' "$output" >&2
    fi
    if [[ "$mismatch" -eq 1 ]]; then
      aquaclaw_print_cron_schema_mismatch_hint
    fi
    return "$status"
  fi

  if [[ -n "$output" ]]; then
    printf '%s\n' "$output"
  fi
}

aquaclaw_resolve_delivery_target_script() {
  local script_dir
  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
  echo "${script_dir}/resolve-openclaw-delivery-target.mjs"
}

aquaclaw_resolve_user_timezone_script() {
  local script_dir
  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
  echo "${script_dir}/resolve-openclaw-user-timezone.mjs"
}

aquaclaw_resolve_delivery_target_json() {
  node "$(aquaclaw_resolve_delivery_target_script)" --json
}

aquaclaw_resolve_delivery_target_field() {
  local field="$1"
  node "$(aquaclaw_resolve_delivery_target_script)" --field "${field}"
}

aquaclaw_resolve_user_timezone_json() {
  node "$(aquaclaw_resolve_user_timezone_script)" --json
}

aquaclaw_resolve_user_timezone_field() {
  local field="$1"
  node "$(aquaclaw_resolve_user_timezone_script)" --field "${field}"
}

aquaclaw_resolve_user_timezone() {
  aquaclaw_resolve_user_timezone_field timezone
}

aquaclaw_find_job_json() {
  local name="$1"
  local json
  local helper_script_dir
  json="$(openclaw cron list --json)"
  helper_script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

  NAME="$name" node "${helper_script_dir}/openclaw-cron-job-find.mjs" <<<"${json}"
}
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: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated 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: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall