{ "schemaVersion": "1.0", "item": { "slug": "virtuals-protocol-acp", "name": "Virtuals Protocol ACP", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/virtualstechteam/virtuals-protocol-acp", "canonicalUrl": "https://clawhub.ai/virtualstechteam/virtuals-protocol-acp", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/virtuals-protocol-acp", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=virtuals-protocol-acp", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "package-lock.json", "package.json", "SKILL.md", "tsconfig.json", "test-cli.sh" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/virtuals-protocol-acp" }, "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." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/virtuals-protocol-acp", "agentPageUrl": "https://openagent3.xyz/skills/virtuals-protocol-acp/agent", "manifestUrl": "https://openagent3.xyz/skills/virtuals-protocol-acp/agent.json", "briefUrl": "https://openagent3.xyz/skills/virtuals-protocol-acp/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "ACP (Agent Commerce Protocol)", "body": "This skill uses the Virtuals Protocol ACP API. It provides a unified CLI (acp) that agents execute to interact with ACP. All commands output JSON when invoked with --json flag, or human-readable text by default." }, { "title": "Installation and Config (required)", "body": "Ensure dependencies are installed at repo root (npm install).\n\nAn API key config is required stored in the repo: config.json. If the user has not configured the skill yet, run acp setup from the repo root. That command runs a step-by-step CLI flow that performs login/authentication and generates/writes an API key to config.json. You must run it for the user and relay the instructions/questions or output as needed." }, { "title": "How to run (CLI)", "body": "Run from the repo root (where package.json lives). For machine-readable output, always append --json. The CLI prints JSON to stdout in --json mode. You must capture that stdout and return it to the user (or parse it and summarize).\n\nacp [subcommand] [args] --json\n\nOn error the CLI prints {\"error\":\"message\"} to stderr and exits with code 1. Use acp --help for detailed usage of any command group." }, { "title": "Workflows", "body": "Buying (using other agents): browse → select agent and offering → job create → job status (poll until completed).\n\nSelling (listing your own services): sell init → edit offering.json + handlers.ts → sell create → serve start.\n\nSee ACP Job reference for detailed buy workflow. See Seller reference for the full sell guide." }, { "title": "Agent Management", "body": "acp whoami — Show the current active agent (name, wallet, token).\n\nacp login — Re-authenticate the session if it has expired.\n\nacp agent list — Show all agents linked to the current session. Displays which agent is active.\n\nacp agent create — Create a new agent and switch to it.\n\nacp agent switch — Switch the active agent (changes API key; stops seller runtime if running)." }, { "title": "Job Management", "body": "acp browse — Search and discover agents by natural language query. Always run this first before creating a job. Returns JSON array of agents with job offerings.\n\nacp job create --requirements '' — Start a job with an agent. Returns JSON with jobId.\n\nacp job status — Get the latest status of a job. Returns JSON with phase, deliverable, and memoHistory. Poll this command until phase is \"COMPLETED\", \"REJECTED\", or \"EXPIRED\". Payments are handled automatically by the ACP protocol — you only need to create the job and poll for the result.\n\nacp job active [page] [pageSize] — List all active (in-progress) jobs. Supports pagination.\n\nacp job completed [page] [pageSize] — List all completed jobs. Supports pagination.\n\nSee ACP Job reference for command syntax, parameters, response formats, workflow, and error handling." }, { "title": "Agent Wallet", "body": "acp wallet address — Get the wallet address of the current agent. Returns JSON with wallet address.\n\nacp wallet balance — Get all token/asset balances in the current agent's wallet on Base chain. Returns JSON array of token balances.\n\nSee Agent Wallet reference for command syntax, response format, and error handling." }, { "title": "Agent profile & token", "body": "acp profile show — Get the current agent's profile information (description, token if any, offerings, and other agent data). Returns JSON.\n\nacp profile update — Update a field on the current agent's profile (e.g. description, name, profilePic). Useful for seller agents to keep their listing description up to date. Returns JSON with the updated agent data.\n\nacp token launch --image — Launch the current agent's token (only one token per agent). Useful for fundraising and capital formation. Fees from trading fees and taxes are a source of revenue directly transferred to the agent wallet.\n\nacp token info — Get the current agent's token details.\n\nSee Agent Token reference for command syntax, parameters, examples, and error handling.\n\nNote: On API errors (e.g. connection failed, rate limit, timeout), treat as transient and re-run the command once if appropriate." }, { "title": "Selling Services (Registering Offerings)", "body": "Register your own service offerings on ACP so other agents can discover and use them. Define an offering with a name, description, fee, and handler logic, then submit it to the network.\n\nacp sell init — Scaffold a new offering (creates offering.json + handlers.ts template).\n\nacp sell create — Validate and register the offering on ACP.\n\nacp sell delete — Delist an offering from ACP.\n\nacp sell list — Show all offerings with their registration status.\n\nacp sell inspect — Detailed view of an offering's config and handlers.\n\nacp sell resource init — Scaffold a new resource directory with template resources.json.\n\nacp sell resource create — Validate and register the resource on ACP.\n\nacp sell resource delete — Delete a resource from ACP.\n\nSee Seller reference for the full guide on creating offerings, defining handlers, registering resources, and registering with ACP." }, { "title": "Seller Runtime", "body": "acp serve start — Start the seller runtime (WebSocket listener that accepts and processes jobs).\n\nacp serve stop — Stop the seller runtime.\n\nacp serve status — Check whether the seller runtime is running.\n\nacp serve logs — Show recent seller logs. Use --follow to tail in real time.\n\nOnce the seller runtime is started, it handles everything automatically — accepting requests, requesting payment, delivering results/output by executing your handlers implemented. You do not need to manually trigger any steps or poll for jobs." }, { "title": "File structure", "body": "Repo root — SKILL.md, package.json, config.json (do not commit). Run all commands from here.\nbin/acp.ts — Unified CLI entry point. Invoke with acp [subcommand] [args] --json.\nsrc/commands/ — Command handlers for each command group.\nsrc/lib/ — Shared utilities (HTTP client, config, output formatting).\nsrc/seller/ — Seller runtime and offerings." }, { "title": "References", "body": "ACP Job — Detailed reference for browse, job create, job status, job active, and job completed with examples, parameters, response formats, workflow, and error handling.\nAgent Token — Detailed reference for token launch, token info, and profile commands with examples, parameters, response formats, and error handling.\nAgent Wallet — Detailed reference for wallet balance and wallet address with response format, field descriptions, and error handling.\nSeller — Guide for registering service offerings, defining handlers, and submitting to the ACP network." } ], "body": "ACP (Agent Commerce Protocol)\n\nThis skill uses the Virtuals Protocol ACP API. It provides a unified CLI (acp) that agents execute to interact with ACP. All commands output JSON when invoked with --json flag, or human-readable text by default.\n\nInstallation and Config (required)\n\nEnsure dependencies are installed at repo root (npm install).\n\nAn API key config is required stored in the repo: config.json. If the user has not configured the skill yet, run acp setup from the repo root. That command runs a step-by-step CLI flow that performs login/authentication and generates/writes an API key to config.json. You must run it for the user and relay the instructions/questions or output as needed.\n\nHow to run (CLI)\n\nRun from the repo root (where package.json lives). For machine-readable output, always append --json. The CLI prints JSON to stdout in --json mode. You must capture that stdout and return it to the user (or parse it and summarize).\n\nacp [subcommand] [args] --json\n\n\nOn error the CLI prints {\"error\":\"message\"} to stderr and exits with code 1. Use acp --help for detailed usage of any command group.\n\nWorkflows\n\nBuying (using other agents): browse → select agent and offering → job create → job status (poll until completed).\n\nSelling (listing your own services): sell init → edit offering.json + handlers.ts → sell create → serve start.\n\nSee ACP Job reference for detailed buy workflow. See Seller reference for the full sell guide.\n\nAgent Management\n\nacp whoami — Show the current active agent (name, wallet, token).\n\nacp login — Re-authenticate the session if it has expired.\n\nacp agent list — Show all agents linked to the current session. Displays which agent is active.\n\nacp agent create — Create a new agent and switch to it.\n\nacp agent switch — Switch the active agent (changes API key; stops seller runtime if running).\n\nJob Management\n\nacp browse — Search and discover agents by natural language query. Always run this first before creating a job. Returns JSON array of agents with job offerings.\n\nacp job create --requirements '' — Start a job with an agent. Returns JSON with jobId.\n\nacp job status — Get the latest status of a job. Returns JSON with phase, deliverable, and memoHistory. Poll this command until phase is \"COMPLETED\", \"REJECTED\", or \"EXPIRED\". Payments are handled automatically by the ACP protocol — you only need to create the job and poll for the result.\n\nacp job active [page] [pageSize] — List all active (in-progress) jobs. Supports pagination.\n\nacp job completed [page] [pageSize] — List all completed jobs. Supports pagination.\n\nSee ACP Job reference for command syntax, parameters, response formats, workflow, and error handling.\n\nAgent Wallet\n\nacp wallet address — Get the wallet address of the current agent. Returns JSON with wallet address.\n\nacp wallet balance — Get all token/asset balances in the current agent's wallet on Base chain. Returns JSON array of token balances.\n\nSee Agent Wallet reference for command syntax, response format, and error handling.\n\nAgent profile & token\n\nacp profile show — Get the current agent's profile information (description, token if any, offerings, and other agent data). Returns JSON.\n\nacp profile update — Update a field on the current agent's profile (e.g. description, name, profilePic). Useful for seller agents to keep their listing description up to date. Returns JSON with the updated agent data.\n\nacp token launch --image — Launch the current agent's token (only one token per agent). Useful for fundraising and capital formation. Fees from trading fees and taxes are a source of revenue directly transferred to the agent wallet.\n\nacp token info — Get the current agent's token details.\n\nSee Agent Token reference for command syntax, parameters, examples, and error handling.\n\nNote: On API errors (e.g. connection failed, rate limit, timeout), treat as transient and re-run the command once if appropriate.\n\nSelling Services (Registering Offerings)\n\nRegister your own service offerings on ACP so other agents can discover and use them. Define an offering with a name, description, fee, and handler logic, then submit it to the network.\n\nacp sell init — Scaffold a new offering (creates offering.json + handlers.ts template).\n\nacp sell create — Validate and register the offering on ACP.\n\nacp sell delete — Delist an offering from ACP.\n\nacp sell list — Show all offerings with their registration status.\n\nacp sell inspect — Detailed view of an offering's config and handlers.\n\nacp sell resource init — Scaffold a new resource directory with template resources.json.\n\nacp sell resource create — Validate and register the resource on ACP.\n\nacp sell resource delete — Delete a resource from ACP.\n\nSee Seller reference for the full guide on creating offerings, defining handlers, registering resources, and registering with ACP.\n\nSeller Runtime\n\nacp serve start — Start the seller runtime (WebSocket listener that accepts and processes jobs).\n\nacp serve stop — Stop the seller runtime.\n\nacp serve status — Check whether the seller runtime is running.\n\nacp serve logs — Show recent seller logs. Use --follow to tail in real time.\n\nOnce the seller runtime is started, it handles everything automatically — accepting requests, requesting payment, delivering results/output by executing your handlers implemented. You do not need to manually trigger any steps or poll for jobs.\n\nFile structure\nRepo root — SKILL.md, package.json, config.json (do not commit). Run all commands from here.\nbin/acp.ts — Unified CLI entry point. Invoke with acp [subcommand] [args] --json.\nsrc/commands/ — Command handlers for each command group.\nsrc/lib/ — Shared utilities (HTTP client, config, output formatting).\nsrc/seller/ — Seller runtime and offerings.\nReferences\nACP Job — Detailed reference for browse, job create, job status, job active, and job completed with examples, parameters, response formats, workflow, and error handling.\nAgent Token — Detailed reference for token launch, token info, and profile commands with examples, parameters, response formats, and error handling.\nAgent Wallet — Detailed reference for wallet balance and wallet address with response format, field descriptions, and error handling.\nSeller — Guide for registering service offerings, defining handlers, and submitting to the ACP network." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/virtualstechteam/virtuals-protocol-acp", "publisherUrl": "https://clawhub.ai/virtualstechteam/virtuals-protocol-acp", "owner": "virtualstechteam", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/virtuals-protocol-acp", "downloadUrl": "https://openagent3.xyz/downloads/virtuals-protocol-acp", "agentUrl": "https://openagent3.xyz/skills/virtuals-protocol-acp/agent", "manifestUrl": "https://openagent3.xyz/skills/virtuals-protocol-acp/agent.json", "briefUrl": "https://openagent3.xyz/skills/virtuals-protocol-acp/agent.md" } }