openclaw-keeperlink

star 28

Post a swap job over Gensyn AXL, settle onchain via KeeperHub + Uniswap, persist receipt on 0G Storage, return both proofs. Use when an OpenClaw agent needs to ask another agent to perform a paid onchain action and get a verifiable, audit-traceable receipt back. Triggers on intents like "swap X USDC for Y on Base", "post a paid job to peer", "verify a KeeperLink receipt".

Scottcjn By Scottcjn schedule Updated 6/10/2026

name: openclaw-keeperlink description: Post a swap job over Gensyn AXL, settle onchain via KeeperHub + Uniswap, persist receipt on 0G Storage, return both proofs. Use when an OpenClaw agent needs to ask another agent to perform a paid onchain action and get a verifiable, audit-traceable receipt back. Triggers on intents like "swap X USDC for Y on Base", "post a paid job to peer", "verify a KeeperLink receipt".

OpenClaw KeeperLink — Skill

Post a job from one OpenClaw agent (Node A) to another (Node B) over Gensyn AXL with x402 payment, have Node B settle the request onchain via KeeperHub + Uniswap, and persist the receipt to 0G Storage. Node A receives a dual-verifiable receipt back over the same AXL request/response cycle.

When to use this skill

  • The user asks an OpenClaw agent to perform a paid onchain action via another agent, not directly from itself
  • Decentralized agent commerce — A pays B in USDC for an action B executes
  • Audit-traceable execution where the receipt must be both onchain-verifiable AND content-addressed (independent of any single chain)
  • Demo / hackathon context for ETHGlobal Open Agents

What this skill does NOT do

  • Execute swaps directly from the calling agent's wallet (use the uniswap skill for self-swap)
  • Bridge assets between chains (use a dedicated bridge skill)
  • Manage long-lived workflows (use KeeperHub MCP ai_generate_workflow for that)

Subcommands

Command What it does
/openclaw-keeperlink status Confirms AXL connectivity, peer reachability, KeeperHub auth, and 0G testnet RPC. Prints a health summary.
/openclaw-keeperlink post-job --intent "<NL intent>" Posts a job to a configured peer, prints tx hash + 0G rootHash on receipt.
/openclaw-keeperlink check-receipts Lists recent receipts received by Node A, dual-verifies each (onchain + 0G content-address).
/openclaw-keeperlink verify <rootHash> Pulls a receipt from 0G by Merkle rootHash and re-verifies its onchain tx.

Failure modes (non-fatal philosophy)

Following Gensyn's collaborative-autoresearch-demo pattern:

  • AXL peer unreachable → log + continue (return structured "peer_offline" error, don't crash)
  • KeeperHub retry budget exhausted → surface KeeperHub's audit ref, abort cleanly
  • x402 payment verification fails → 402 response with structured reason, no execution
  • 0G upload timeout → tx receipt still returned over AXL; 0G persistence retried in background

The skill never crashes mid-demo. Every error path returns a structured result the calling agent can reason about.

Implementation

See keeperlink_client.py for the glue code. The skill wraps:

  • shared/axl_client.py — AXL transport + MCP framing
  • shared/keeperhub.py — Direct Execution API + MCP fallback
  • shared/uniswap.py — Trading API quote + swap intent
  • shared/zerog.py — 0G upload + Merkle verification
  • shared/x402.py — Payment header sign/verify
Install via CLI
npx skills add https://github.com/Scottcjn/openclaw-keeperlink --skill openclaw-keeperlink
Repository Details
star Stars 28
call_split Forks 3
navigation Branch main
article Path SKILL.md
More from Creator