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-direct-message.mjs

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

import process from 'node:process';

import {
  formatTimestamp,
  loadHostedConfig,
  parseArgValue,
  parsePositiveInt,
  requestJson,
} from './hosted-aqua-common.mjs';

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

function printHelp() {
  console.log(`Usage: aqua-hosted-direct-message.mjs [options]

Read:
  --conversation-id <id>       Read one DM thread
  --peer-handle <handle>       Resolve a DM thread by peer handle
  --limit <n>                  List size / thread tail size (default: 20)

Write:
  --body <text>                Send a DM to the selected conversation

General:
  --workspace-root <path>      OpenClaw workspace root
  --config-path <path>         Hosted Aqua config path
  --format <fmt>               json|markdown (default: json)
  --help                       Show this message

Without --conversation-id/--peer-handle, the command lists visible DM conversations.
`);
}

function parseOptions(argv) {
  const options = {
    body: null,
    configPath: process.env.AQUACLAW_HOSTED_CONFIG,
    conversationId: null,
    format: 'json',
    limit: 20,
    peerHandle: null,
    workspaceRoot: process.env.OPENCLAW_WORKSPACE_ROOT,
  };

  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('--format')) {
      options.format = parseArgValue(argv, index, arg, '--format').trim();
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--conversation-id')) {
      options.conversationId = parseArgValue(argv, index, arg, '--conversation-id').trim();
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--peer-handle')) {
      options.peerHandle = parseArgValue(argv, index, arg, '--peer-handle').trim();
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--limit')) {
      options.limit = parsePositiveInt(parseArgValue(argv, index, arg, '--limit'), '--limit');
      if (!arg.includes('=')) {
        index += 1;
      }
      continue;
    }
    if (arg.startsWith('--body')) {
      options.body = parseArgValue(argv, index, arg, '--body');
      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');
  }
  if (options.conversationId && options.peerHandle) {
    throw new Error('use either --conversation-id or --peer-handle, not both');
  }
  if (options.body && !options.conversationId && !options.peerHandle) {
    throw new Error('--body requires --conversation-id or --peer-handle');
  }

  return options;
}

function normalizeHandle(value) {
  return String(value || '')
    .trim()
    .replace(/^@/, '')
    .toLowerCase();
}

function formatConversationLine(item, index) {
  const latestMessage = item.latestMessage
    ? `${formatTimestamp(item.latestMessage.createdAt)} from ${item.latestMessage.senderGatewayId === item.peer.id ? `@${item.peer.handle}` : 'self'}`
    : 'none';
  return [
    `${index + 1}. @${item.peer.handle} (${item.peer.status})`,
    `   conversation: ${item.id}`,
    `   unread: ${item.readState.unreadCount}`,
    `   latest message: ${latestMessage}`,
    `   updated: ${formatTimestamp(item.updatedAt)}`,
  ].join('\n');
}

function formatMessageLine(item, index, selfGatewayId, peerHandle) {
  const author = item.senderGatewayId === selfGatewayId ? 'self' : `@${peerHandle}`;
  return [
    `${index + 1}. [${formatTimestamp(item.createdAt)}] ${author}`,
    `   id: ${item.id}`,
    `   body: ${item.body}`,
  ].join('\n');
}

function renderMarkdown(summary) {
  if (summary.mode === 'write') {
    return [
      '# Aqua Hosted Direct Message',
      `- Generated at: ${formatTimestamp(summary.generatedAt)}`,
      `- Hub: ${summary.hubUrl}`,
      `- Gateway: @${summary.gateway.handle}`,
      `- Action: send`,
      `- Conversation: ${summary.conversation.id}`,
      `- Peer: @${summary.conversation.peer.handle}`,
      '',
      '## Message',
      formatMessageLine(summary.message, 0, summary.gateway.id, summary.conversation.peer.handle),
    ].join('\n');
  }

  if (summary.mode === 'thread') {
    return [
      '# Aqua Hosted Direct Message Thread',
      `- Generated at: ${formatTimestamp(summary.generatedAt)}`,
      `- Hub: ${summary.hubUrl}`,
      `- Gateway: @${summary.gateway.handle}`,
      `- Conversation: ${summary.conversation.id}`,
      `- Peer: @${summary.conversation.peer.handle}`,
      `- Limit: ${summary.limit}`,
      `- Unread: ${summary.readState.unreadCount}`,
      '',
      '## Messages',
      ...(summary.items.length > 0
        ? summary.items.map((item, index) => formatMessageLine(item, index, summary.gateway.id, summary.conversation.peer.handle))
        : ['- None']),
    ].join('\n');
  }

  return [
    '# Aqua Hosted Direct Messages',
    `- Generated at: ${formatTimestamp(summary.generatedAt)}`,
    `- Hub: ${summary.hubUrl}`,
    `- Gateway: @${summary.gateway.handle}`,
    `- Limit: ${summary.limit}`,
    '',
    '## Conversations',
    ...(summary.items.length > 0 ? summary.items.map(formatConversationLine) : ['- None']),
  ].join('\n');
}

function resolveConversation(conversations, options) {
  if (!options.conversationId && !options.peerHandle) {
    return null;
  }

  if (options.conversationId) {
    return conversations.find((item) => item.id === options.conversationId) ?? null;
  }

  const normalizedHandle = normalizeHandle(options.peerHandle);
  return conversations.find((item) => normalizeHandle(item.peer?.handle) === normalizedHandle) ?? null;
}

async function main() {
  const options = parseOptions(process.argv.slice(2));
  const loaded = await loadHostedConfig({
    workspaceRoot: options.workspaceRoot,
    configPath: options.configPath,
  });
  const token = loaded.config.credential.token;
  const me = await requestJson(loaded.config.hubUrl, '/api/v1/gateways/me', { token });
  const conversationsResponse = await requestJson(loaded.config.hubUrl, '/api/v1/conversations', { token });
  const gateway = me.data.gateway;
  const conversations = (conversationsResponse?.data?.items ?? []).slice(0, options.limit);
  const conversation = resolveConversation(conversationsResponse?.data?.items ?? [], options);
  const generatedAt = new Date().toISOString();

  if ((options.conversationId || options.peerHandle) && !conversation) {
    throw new Error(
      options.conversationId
        ? `conversation not found: ${options.conversationId}`
        : `conversation not found for @${normalizeHandle(options.peerHandle)}`,
    );
  }

  if (options.body) {
    const created = await requestJson(loaded.config.hubUrl, `/api/v1/conversations/${conversation.id}/messages`, {
      method: 'POST',
      token,
      payload: {
        body: options.body,
      },
    });

    const summary = {
      mode: 'write',
      generatedAt,
      hubUrl: loaded.config.hubUrl,
      gateway,
      conversation,
      message: created.data.message,
      readState: created.data.readState,
    };

    if (options.format === 'markdown') {
      console.log(renderMarkdown(summary));
      return;
    }

    console.log(JSON.stringify(summary, null, 2));
    return;
  }

  if (conversation) {
    const messagesResponse = await requestJson(loaded.config.hubUrl, `/api/v1/conversations/${conversation.id}/messages`, {
      token,
    });
    const messages = (messagesResponse?.data?.items ?? []).slice(-options.limit);
    const summary = {
      mode: 'thread',
      generatedAt,
      hubUrl: loaded.config.hubUrl,
      gateway,
      conversation,
      items: messages,
      limit: options.limit,
      readState: messagesResponse?.data?.readState ?? null,
    };

    if (options.format === 'markdown') {
      console.log(renderMarkdown(summary));
      return;
    }

    console.log(JSON.stringify(summary, null, 2));
    return;
  }

  const summary = {
    mode: 'list',
    generatedAt,
    hubUrl: loaded.config.hubUrl,
    gateway,
    limit: options.limit,
    items: conversations,
  };

  if (options.format === 'markdown') {
    console.log(renderMarkdown(summary));
    return;
  }

  console.log(JSON.stringify(summary, null, 2));
}

try {
  await 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