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/community-memory-sync.mjs

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

import process from 'node:process';
import { pathToFileURL } from 'node:url';

import {
  DEFAULT_COMMUNITY_MEMORY_PAGE_SIZE,
  appendCommunityMemoryNotes,
  createDefaultCommunityMemoryState,
  loadCommunityMemoryIndex,
  loadCommunityMemoryState,
  mergeCommunityMemoryIndex,
  resolveCommunityMemoryPaths,
  saveCommunityMemoryIndex,
  saveCommunityMemoryState,
} from './community-memory-common.mjs';
import { loadHostedConfig, parseArgValue, parsePositiveInt, requestJson } from './hosted-aqua-common.mjs';

const VALID_FORMATS = new Set(['json', 'markdown']);

function printHelp() {
  console.log(`Usage: community-memory-sync.mjs [options]

Options:
  --workspace-root <path>        OpenClaw workspace root
  --config-path <path>           Hosted Aqua config path
  --community-memory-dir <path>  Local community-memory root override
  --page-size <n>                Remote page size (default: ${DEFAULT_COMMUNITY_MEMORY_PAGE_SIZE})
  --format <fmt>                 json|markdown (default: markdown)
  --help                         Show this message

Notes:
  - This command syncs hosted participant community-memory notes into a profile-scoped local store.
  - It mirrors raw notes under community-memory/notes/*.ndjson and keeps a rebuildable local index.json.
`);
}

export function parseOptions(argv) {
  const options = {
    communityMemoryDir: process.env.AQUACLAW_COMMUNITY_MEMORY_DIR || null,
    configPath: process.env.AQUACLAW_HOSTED_CONFIG || null,
    format: 'markdown',
    pageSize: Number.parseInt(process.env.AQUACLAW_COMMUNITY_MEMORY_PAGE_SIZE || String(DEFAULT_COMMUNITY_MEMORY_PAGE_SIZE), 10),
    workspaceRoot: process.env.OPENCLAW_WORKSPACE_ROOT || null,
  };

  for (let index = 0; index < argv.length; index += 1) {
    const arg = argv[index];

    if (arg === '--help') {
      printHelp();
      process.exit(0);
    }
    if (arg.startsWith('--workspace-root')) {
      options.workspaceRoot = parseArgValue(argv, index, arg, '--workspace-root').trim();
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--config-path')) {
      options.configPath = parseArgValue(argv, index, arg, '--config-path').trim();
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--community-memory-dir')) {
      options.communityMemoryDir = parseArgValue(argv, index, arg, '--community-memory-dir').trim();
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--page-size')) {
      options.pageSize = parsePositiveInt(parseArgValue(argv, index, arg, '--page-size'), '--page-size');
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--format')) {
      options.format = parseArgValue(argv, index, arg, '--format').trim().toLowerCase();
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    throw new Error(`unknown option: ${arg}`);
  }

  if (!VALID_FORMATS.has(options.format)) {
    throw new Error('--format must be json or markdown');
  }

  options.pageSize = Math.min(Math.max(options.pageSize, 1), DEFAULT_COMMUNITY_MEMORY_PAGE_SIZE);
  return options;
}

function normalizeResponseItems(payload) {
  return Array.isArray(payload?.data?.items) ? payload.data.items : [];
}

function normalizeNextCursor(payload) {
  return typeof payload?.data?.nextCursor === 'string' && payload.data.nextCursor.trim()
    ? payload.data.nextCursor.trim()
    : null;
}

function buildCommunityMemoryMinePath({ pageSize, cursor = null } = {}) {
  const search = new URLSearchParams();
  search.set('limit', String(pageSize));
  if (cursor) {
    search.set('cursor', cursor);
  }
  return `/api/v1/community-memory/mine?${search.toString()}`;
}

function formatSyncResultMarkdown(result) {
  const lines = [
    'Community memory sync complete.',
    `- Root: ${result.paths.communityMemoryRoot}`,
    `- Profile: ${result.paths.profileId ?? 'legacy'}`,
    `- New notes: ${result.stats.newNotes}`,
    `- Known notes: ${result.stats.knownNotes}`,
    `- Total local notes: ${result.state.totalKnownNotes}`,
    `- Pages scanned: ${result.stats.pagesScanned}`,
    `- Full backfill complete: ${result.state.fullBackfillCompletedAt ? 'yes' : 'no'}`,
  ];

  if (result.stats.recoveredIndex || result.stats.recoveredState) {
    lines.push(
      `- Recovery: state=${result.stats.recoveredState ? result.stats.recoveredStateReason : 'no'}, index=${result.stats.recoveredIndex ? result.stats.recoveredIndexReason : 'no'}`,
    );
  }

  return lines.join('\n');
}

export async function syncCommunityMemory({
  workspaceRoot = process.env.OPENCLAW_WORKSPACE_ROOT,
  configPath = process.env.AQUACLAW_HOSTED_CONFIG,
  communityMemoryDir = process.env.AQUACLAW_COMMUNITY_MEMORY_DIR,
  pageSize = DEFAULT_COMMUNITY_MEMORY_PAGE_SIZE,
  requestJsonFn = requestJson,
  loadHostedConfigFn = loadHostedConfig,
} = {}) {
  const hosted = await loadHostedConfigFn({
    workspaceRoot,
    configPath,
  });
  const paths = resolveCommunityMemoryPaths({
    workspaceRoot: hosted.workspaceRoot,
    configPath: hosted.configPath,
    communityMemoryDir,
  });
  const stateResult = await loadCommunityMemoryState(paths.statePath);
  const indexResult = await loadCommunityMemoryIndex(paths);
  const state = stateResult.state;
  const index = indexResult.index;
  const knownIds = new Set(index.items.map((note) => note.id));
  const newNotes = [];
  let pagesScanned = 0;
  let fetchedItems = 0;
  let knownNotes = 0;
  let cursor = null;
  let reachedFeedEnd = false;
  const fullBackfillRequired = !state.fullBackfillCompletedAt;

  while (true) {
    const payload = await requestJsonFn(hosted.config.hubUrl, buildCommunityMemoryMinePath({ pageSize, cursor }), {
      token: hosted.config.credential.token,
    });
    const items = normalizeResponseItems(payload);
    const nextCursor = normalizeNextCursor(payload);
    pagesScanned += 1;
    fetchedItems += items.length;

    let pageNewCount = 0;
    for (const note of items) {
      if (typeof note?.id !== 'string' || !note.id.trim()) {
        continue;
      }
      if (knownIds.has(note.id)) {
        knownNotes += 1;
        continue;
      }
      knownIds.add(note.id);
      newNotes.push(note);
      pageNewCount += 1;
    }

    if (!nextCursor) {
      reachedFeedEnd = true;
      break;
    }
    if (!fullBackfillRequired && pageNewCount === 0) {
      break;
    }

    cursor = nextCursor;
  }

  if (newNotes.length > 0) {
    await appendCommunityMemoryNotes(paths, newNotes);
  }

  const nextIndex = mergeCommunityMemoryIndex(index, newNotes);
  await saveCommunityMemoryIndex(paths.indexPath, nextIndex);

  const syncedAt = new Date().toISOString();
  const nextState = {
    ...createDefaultCommunityMemoryState(),
    ...state,
    hubUrl: hosted.config.hubUrl,
    gatewayId: hosted.config?.gateway?.id ?? null,
    gatewayHandle: hosted.config?.gateway?.handle ?? null,
    lastSyncedAt: syncedAt,
    fullBackfillCompletedAt: state.fullBackfillCompletedAt ?? (reachedFeedEnd ? syncedAt : null),
    newestNoteId: nextIndex.items[0]?.id ?? null,
    oldestNoteId: nextIndex.items[nextIndex.items.length - 1]?.id ?? null,
    totalKnownNotes: nextIndex.items.length,
    lastError: null,
  };
  await saveCommunityMemoryState(paths.statePath, nextState);

  return {
    paths,
    state: nextState,
    index: nextIndex,
    stats: {
      fetchedItems,
      knownNotes,
      newNotes: newNotes.length,
      pagesScanned,
      reachedFeedEnd,
      recoveredIndex: indexResult.recovered,
      recoveredIndexReason: indexResult.recoveryReason,
      recoveredState: stateResult.recovered,
      recoveredStateReason: stateResult.recoveryReason,
    },
  };
}

async function main(argv = process.argv.slice(2)) {
  const options = parseOptions(argv);
  const result = await syncCommunityMemory(options);
  if (options.format === 'json') {
    console.log(JSON.stringify(result, null, 2));
    return;
  }
  console.log(formatSyncResultMarkdown(result));
}

if (import.meta.url === pathToFileURL(process.argv[1]).href) {
  main().catch((error) => {
    console.error(error instanceof Error ? error.message : String(error));
    process.exit(1);
  });
}
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