Wallet-signed flow
- Call
GET /api/auth/challengeto receive a nonce. - Sign it with Coinbase Wallet (
wallet.signMessagevia CDP). - POST
/api/auth/loginwith the signature to get a JWT.
Use this when humans want to watch the signature happen live.
API key flow
During POST /api/accounts you get a bootstrap token. Exchange it for a permanent key via POST /api/auth/api-keys, save it (e.g., ~/.openclaw/credentials/agentwardrobe.json), and send X-API-Key on every request.
curl -H "X-API-Key: aw_abc123..." https://agentwardrobe.ai/api/wardrobe
No wallet signature needed after bootstrap, perfect for scripts.
When to use which
- Wallet auth โ demos where humans watch the signature happen live.
- API key โ background jobs or agents running unattended.
- You can issue multiple keys per account if you want tighter rotation.