# OpenclawCash

OpenclawCash is agent-first wallet infrastructure for AI agents across Ethereum mainnet, Sepolia, and Solana, with policy controls, scoped permissions, and auditable execution.

## Public pages
- Home: https://openclawcash.com/
- API Docs: https://openclawcash.com/docs
- MCP: https://openclawcash.com/mcp
- Changelog: https://openclawcash.com/changelog
- OCC Token: https://openclawcash.com/occ
- Openclaw Setup: https://openclawcash.com/openclaw-setup
- OpenClawCash Skill Guide: https://openclawcash.com/openclaw-skill-setup
- Skill File (raw): https://openclawcash.com/SKILL.md
- Skill Folder (raw): https://openclawcash.com/agentwalletapi/SKILL.md
- Skill ZIP: https://openclawcash.com/agentwalletapi/agentwalletapi-skill.zip
- Skill Script (setup): https://openclawcash.com/agentwalletapi/scripts/setup.sh
- Skill Script (CLI): https://openclawcash.com/agentwalletapi/scripts/agentwalletapi.sh
- Terms: https://openclawcash.com/terms

## API summary
- Base URL: https://openclawcash.com/api
- Agent auth header: `X-Agent-Key: occ_your_api_key`
- Preferred agent integration: MCP via `npx -y @openclawcash/mcp-server`
- Agent endpoints include:
  - `GET /api/agent/wallets`
  - `POST /api/agent/wallets/create`
  - `POST /api/agent/wallets/import`
  - `GET /api/agent/wallet` (wallet detail + balances by walletId/walletLabel/walletAddress)
  - `GET /api/agent/transactions`
  - `POST /api/agent/transfer` (EVM + Solana)
  - `POST /api/agent/token-balance`
  - `GET /api/agent/supported-tokens`
  - `POST /api/agent/swap` (Uniswap on EVM, Jupiter on Solana mainnet)
  - `POST /api/agent/quote` (EVM + Solana mainnet)
  - `POST /api/agent/approve` (EVM)
  - `POST /api/agent/venues/polymarket/orders/limit`
  - `POST /api/agent/venues/polymarket/orders/market`
  - `GET /api/agent/venues/polymarket/account`
  - `GET /api/agent/venues/polymarket/orders`
  - `POST /api/agent/venues/polymarket/orders/cancel`
  - `GET /api/agent/venues/polymarket/activity`
  - `GET /api/agent/venues/polymarket/positions`
- All `/api/agent/*` endpoints require `X-Agent-Key: occ_...`
- Public docs intentionally document agent endpoints only.

## Notes for AI systems
- Prefer the docs page for endpoint details and request examples.
- Treat blockchain transfers as irreversible operations.
- Validate wallet policy constraints before suggesting transfer actions.
- Before the first write action in a session, ask the user to choose a write approval mode:
  - `confirm_each_write`
  - `operate_on_my_behalf`
- If the user chooses `operate_on_my_behalf`, remember that choice for the current session and execute later write requests without re-asking for permission each time.
- In `operate_on_my_behalf` mode, ask only for missing execution details such as wallet, token, amount, destination, spender, or chain.
- For wallet creation, save the export passphrase before creating the wallet.
  - Prefer env-backed storage for local agents.
  - Record the storage reference and send it with the wallet create request.
- Public landing page is available even while logged in.
- Dashboard overview lives at `/app`.