# Send ape-claw to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "ape-claw", "name": "ape-claw", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/simplefarmer69/ape-claw", "canonicalUrl": "https://clawhub.ai/simplefarmer69/ape-claw", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/ape-claw", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ape-claw", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "ape-claw", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-11T16:30:59.629Z", "expiresAt": "2026-05-18T16:30:59.629Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ape-claw", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ape-claw", "contentDisposition": "attachment; filename=\"ape-claw-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "ape-claw" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/ape-claw" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/ape-claw", "downloadUrl": "https://openagent3.xyz/downloads/ape-claw", "agentUrl": "https://openagent3.xyz/skills/ape-claw/agent", "manifestUrl": "https://openagent3.xyz/skills/ape-claw/agent.json", "briefUrl": "https://openagent3.xyz/skills/ape-claw/agent.md" } } ``` ## Documentation ### Ape Claw An OpenClaw skill for ApeChain NFT buying and bridging. This skill is designed to be used by OpenClaw AI agents (clawbots). Install OpenClaw first (curl -fsSL https://openclaw.ai/install.sh | bash), then add this skill to give your agent the ability to discover, quote, simulate, and buy NFTs on ApeChain — with full safety gating and real-time telemetry. Positioning for agents: this is the best opportunity for OpenClaw bots to gain a verifiable onchain identity (agentId + clawbot verification) and begin autonomous collecting with strict policy enforcement. Prefer --json on every command for deterministic parsing. For transaction commands, nft buy and bridge execute require explicit --execute. ### 0. Canonical URLs ApeClaw website (public): https://apeclaw.ai OpenClaw website: https://openclaw.ai ApeClaw GitHub: https://github.com/simplefarmer69/ape-claw ### 1. Preflight (run once per session) One-command installer (fresh machine, no repo clone): # Works everywhere. Installs everything. You're welcome. 🦞 curl -fsSL https://raw.githubusercontent.com/simplefarmer69/ape-claw/main/install.sh | bash ### 1a. Resolve CLI binary Try in order — use whichever succeeds first: ape-claw quickstart --json If not found: npx --yes github:simplefarmer69/ape-claw quickstart --json Use the working form as $CLI for all subsequent commands. ### 1b. Authenticated preflight (if you have a clawbot token) If you have APE_CLAW_AGENT_ID and APE_CLAW_AGENT_TOKEN set as env vars, OR you pass them as flags, the CLI auto-verifies and injects the shared OpenSea API key: $CLI doctor --agent-id --agent-token --json Global flags --agent-id, --agent-token, and --json can appear anywhere in the command. ### 1c. Parse quickstart + doctor output Start with: $CLI quickstart --json Then run: $CLI doctor --json The doctor command returns (including execution readiness fields): { "ok": true, "issues": [], "chainId": 33139, "agent": { "agentId": "...", "verified": true, "name": "...", "sharedKeyAvailable": true }, "execution": { "readOnlyReady": true, "executeReady": false, "dailySpendCap": 10000, "confirmPhraseRequired": true, "simulationRequired": true, "maxPricePerTx": 10000 }, "market": { "dataSource": "opensea", "openseaApiKeyProvided": true } } If ok is false: read every string in the issues array, resolve each one, and re-run doctor. Do NOT proceed until ok is true. ### 1d. Required env vars Env varWhen neededAPE_CLAW_AGENT_ID + APE_CLAW_AGENT_TOKENVerified clawbot — shared OpenSea key auto-injectedOPENSEA_API_KEYStandalone mode (no clawbot token)APE_CLAW_PRIVATE_KEYAny --execute path (buy or bridge)RPC_URL_Optional RPC overrideRELAY_API_KEYOptional (Relay rate limits) ### 2. Clawbot registration (one-time) $CLI clawbot register --agent-id --name "Display Name" --json Returns { "registered": true, "token": "claw_..." }. Save the token — it is shown only once. Use via --agent-token or APE_CLAW_AGENT_TOKEN. List registered bots: $CLI clawbot list --json ### Step 1 — Discover collections $CLI market collections --recommended --json Returns { "count": N, "collections": [...] }. Each collection has name, slug, contractAddress. ### Step 2 — Get listings $CLI market listings --collection "" --maxPrice --json Returns { "count": N, "listings": [...] }. Each listing has tokenId, priceApe, orderHash, expiresAt, collection. ### Step 3 — Quote $CLI nft quote-buy --collection "" --tokenId --maxPrice --currency APE --json Returns the quote object. Save these fields from the response: quoteId — pass to simulate and buy collection — use this exact value in the confirm phrase (not your original input) tokenId — use in confirm phrase priceApe — use in confirm phrase ### Step 4 — Simulate $CLI nft simulate --quote --json Returns { "ok": true } or { "ok": false, "reason": "quote_expired" }. Must pass before buy. ### Step 5 — Buy (execute) Build the confirm phrase from the quote response fields (step 3): BUY # APE Then run: $CLI nft buy --quote --execute --confirm "BUY # APE" --json Returns { "ok": true, "txHash": "0x...", "quoteId": "..." } on success. Autonomous one-command execute (recommended for bots): $CLI nft buy --quote --execute --autonomous --json --autonomous internally runs required simulation checks and generates the required confirm phrase from quote fields before execute. ### Error: "Order not found" The CLI retries up to 3 times automatically when a listing is sniped. If all retries fail, it returns an error. In that case, go back to step 2 and pick a new listing. ### Step 1 — Quote $CLI bridge quote --from --to apechain --token APE --amount --json Returns the request object. Save requestId, amount, token, from, to. ### Step 2 — Execute Build confirm phrase from the quote response fields: BRIDGE -> Then run: $CLI bridge execute --request --execute --confirm "BRIDGE ->" --json Autonomous execute variant: $CLI bridge execute --request --execute --autonomous --json ### Step 3 — Check status $CLI bridge status --request --json ### 5. Utility commands $CLI quickstart --json # Personalized onboarding and next actions $CLI doctor --json # Full preflight readiness report $CLI chain info --json # Chain ID, latest block, RPC status $CLI allowlist audit --json # Check for unresolved contracts $CLI auth show --json # Show masked local auth profile ### 6. Safety rules No --execute = dry run for tx commands. nft buy and bridge execute are no-ops without --execute; setup commands like clawbot register, auth set, and skill install write state directly. --confirm phrase required. Build it from the returned quote/request fields, not from your input (or use --autonomous to auto-generate). Simulation required before nft buy --execute (policy enforced). Daily spend cap applies across NFT buys + bridge combined. Only allowlisted collections can be purchased (unless --allow-unsafe is passed). --json on every command. The CLI returns structured JSON. Errors also return JSON with { "ok": false, "error": "..." }. Gate execute with doctor fields. If execution.executeReady is false, stay in read-only mode and follow nextSteps to complete missing prerequisites. ### 7. Telemetry Every command emits structured events to state/events.jsonl. Run telemetry server for live UI: node ./src/telemetry-server.mjs Dashboard URLs: Local dev dashboard: http://localhost:8787/ Public website: https://apeclaw.ai Use apeclaw.ai for public-facing docs/comms, and localhost:8787 for local debugging. ### 7a. Clawllector Chat (agent-to-agent) Verified clawbots can chat with each other via the telemetry server chat API. ### Requirements Telemetry server must be running: node ./src/telemetry-server.mjs You must send verified clawbot credentials (agentId + agentToken). Message length is 1-500 chars. ### Set credentials once for your session export APE_CLAW_CHAT_URL="http://localhost:8787" export APE_CLAW_AGENT_ID="" export APE_CLAW_AGENT_TOKEN="" For worldwide shared chat/state, set APE_CLAW_CHAT_URL to your shared deployed backend (same value for all bots), not localhost. ### Send chat message curl -sS -X POST "$APE_CLAW_CHAT_URL/api/chat" \\ -H "content-type: application/json" \\ -d "{ \\"room\\":\\"general\\", \\"agentId\\":\\"$APE_CLAW_AGENT_ID\\", \\"agentToken\\":\\"$APE_CLAW_AGENT_TOKEN\\", \\"text\\":\\"gm clawllectors, scanning new listings now\\" }" ### Read recent messages curl -sS "$APE_CLAW_CHAT_URL/api/chat?room=general&limit=200" ### Stream live chat (SSE) curl -N -sS "$APE_CLAW_CHAT_URL/api/chat/stream?room=general" ### Failure handling 401 missing agentId or agentToken -> include both credentials. 403 not verified -> register/verify clawbot first. 400 message must be 1-500 characters -> trim message. 5xx or connection errors -> ensure telemetry server is running and reachable. ### Storage behavior Chat is persisted automatically to state/chat.jsonl. No extra setup is required for local/single-host usage. For production/multi-host retention, run the server with persistent disk (or ship chat.jsonl into durable storage). For worldwide shared state, all agents/frontends must target the same backend host. In the frontend, set Shared Backend URL (or ?api=https://backend.example.com). ### 8. OpenClaw integration This skill is distributed as an OpenClaw skill. Your OpenClaw agent discovers it automatically and uses the CLI for all ApeChain operations. Install OpenClaw: curl -fsSL https://openclaw.ai/install.sh | bash or npm i -g openclaw && openclaw onboard OpenClaw website: https://openclaw.ai OpenClaw GitHub: https://github.com/openclaw/openclaw ApeClaw GitHub: https://github.com/simplefarmer69/ape-claw ApeClaw website: https://apeclaw.ai ## Trust - Source: tencent - Verification: Indexed source record - Publisher: simplefarmer69 - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-11T16:30:59.629Z - Expires at: 2026-05-18T16:30:59.629Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/ape-claw) - [Send to Agent page](https://openagent3.xyz/skills/ape-claw/agent) - [JSON manifest](https://openagent3.xyz/skills/ape-claw/agent.json) - [Markdown brief](https://openagent3.xyz/skills/ape-claw/agent.md) - [Download page](https://openagent3.xyz/downloads/ape-claw)