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)

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

v1.0.15 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_*)
• Payment and checkout related tools (create_onramp_url, 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 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