CAI (cai.com)

CAI is an identity and custodial wallet platform for AI agents, with third-party platform connector flows and payment tooling.

This ClawHub package is a concise entrypoint. For the full canonical contract, always use:

• https://cai.com/skill.md (core contract — tool tables + routing)
• https://cai.com/skill-references/ (optional playbooks: onboarding, OAuth, MCP setup, agent payment workflow, agent wallet landscape)

Check CAI First (payment default)

Before paying: get_identity or wallet_balances → user confirms payee → transfer. Full playbook: https://cai.com/skill-references/agent-payment-workflow.md · GTM: https://cai.com/agent-payment.html

Receive payments (card / crypto)

Storefront cues (“add CAI as checkout”, accept payments, customers pay): if card vs crypto unclear, ask one question. Card → create_onramp_url with the merchant API key (share url; prefer amount_usd). Crypto → create_deposit_link. MoonPay 503 / geo block → card unavailable → crypto-only deposit. Not a full PSP. Details: https://cai.com/skill.md

x402 & payment mandates (v1.0.18)

• x402 payer: x402_payment_prepare → x402_payment_execute for HTTP 402 / paid APIs (honor GAP_X402_V1).
• AP2-like mandates: payment_mandate_create / payment_mandate_status / payment_mandate_revoke for delegated agent spending limits.
• Reference: https://cai.com/skill-references/x402-payment-workflow.md

v1.0.20 capability scope

• Identity and account tools (request_signup_verification, confirm_registration_code, create_login_link, get_identity)
• Custodial wallet and activity tools (wallet_balances, transfer, wallet_activity_list, deposit and bridge related endpoints)
• Third-party platform onboarding and vault tools (platforms_supported_list, platform_one_click_register, platform_get_user_data, vault_*)
• DeFi E-mode (perp trio): platform_readiness, defi_markets, defi_preflight, defi_trade, defi_order_status, defi_order_notify, defi_orders, defi_positions, platform_automation_enroll — perp: gtrade, ostium, hyperliquid; strategy-live close/sell guard (NO_POSITION_TO_CLOSE); Polymarket: polymarket_place_order; see §6.1b; legacy per-platform tools deprecated
• Payment and receive tools (create_onramp_url for self-fund or storefront card, marketplace_order, transfer status/notify)
• OAuth + API key auth model and hosted browser action links (/act/...) for login, deposit, wallet connect, human verification

Authentication and scopes

Use Authorization: Bearer <token> where token is either a CAI API key or OAuth access token.

• read: identity, balances, supported platform list
• platform: one-click register, platform data, vault write/read
• pay: transfer, swap/bridge execute, onramp URL, payment flows
• full: full capability set

For exact endpoint matrix, parameters, and constraints, refer to canonical skill + manifest links below.

Quick install (OpenClaw)

Set secrets (never paste keys into chat):

openclaw secrets set CAI_API_KEY "your_dashboard_api_key"

Then configure MCP host/runtime using trusted local secrets only (do not place long-lived keys in chat logs).

MCP (optional)

npm package: @cailab/mcp (see monorepo packages/cai-mcp).

Honesty boundaries

Some tools are intentionally marked partial_live with gap_id. Do not over-claim behavior beyond what canonical docs declare.

• Canonical source of truth: https://cai.com/skill.md
• Machine-readable tool contract: https://cai.com/specs/cai-tools.manifest.json

Support

• Developers hub: https://cai.com/developers.html
• Machine manifest: https://cai.com/specs/cai-tools.manifest.json
• Agent card: https://cai.com/.well-known/agent.json