Do cadastro aos pagamentos automatizados: configurando uma carteira de agente IA com CAI em 30 minutos

Do cadastro aos pagamentos automatizados: conectando uma carteira de agente de IA com CAI em 30 minutos

Você está executando um agente sem cabeça em uma VM na nuvem. Às 3 da manhã, ele precisa pagar um provedor de inferência por um lote de conclusões. Nenhum navegador está aberto. Nenhum cartão de crédito está por perto. Nenhum humano está acordado.

Esse é o cenário para o qual a pilha de pagamento do agente CAI foi construída. Neste guia, você configurará uma carteira CAI do zero, conectará ao seu host de agente, financiará, configurará um limite de gastos autônomo e verificará o fluxo de pagamento. Todo o processo leva cerca de 30 minutos.

Passo 1: Crie sua identidade CAI

Vá para cai.com/app e insira seu e-mail pessoal. Você receberá um código de 6 dígitos que expira em 15 minutos. Insira o código, escolha seu @cai.com alias, defina uma senha no site e você está pronto.

Nos bastidores, a API faz isso em quatro chamadas:

# 1. Solicitar um código de verificação
curl -X POST https://api.cai.com/functions/v1/request-signup-verification \
  -H "Content-Type: application/json" \
  -d '{"display_name":"Seu Nome","verification_email":"voce@exemplo.com"}'

# 2. Confirme o código que você recebeu
curl -X POST https://api.cai.com/functions/v1/confirm-registration-code \
  -H "Content-Type: application/json" \
  -d '{"verification_email":"voce@exemplo.com","code":"123456"}'
# Retorna um registration_ticket como crt_...

# 3. Verifique a disponibilidade do alias (opcional)
curl https://api.cai.com/functions/v1/check-availability?local_part=seu-alias

# 4. Complete o registro (apenas navegador, requer o ticket)
# POST https://api.cai.com/functions/v1/create-account

As ferramentas de registro são públicas (nenhum token Bearer necessário). A chave API cai_... retornada é o que seu agente usa para tudo o mais.

Passo 2: Gere uma chave API no painel

Faça login em cai.com/app, vá para a seção Chaves API e gere uma chave com pelo menos o escopo pay. Esta chave vai para o gerenciador de segredos do seu host de agente.

Para OpenClaw, Hermes ou Cursor, isso significa:

# OpenClaw / Hermes
openclaw secrets set CAI_API_KEY cai_...

# Cursor MCP
# Adicione ao seu cursor.json ou configuração de lançamento:
# "env": { "CAI_API_KEY": "cai_..." }

Para configurações sem cabeça, armazene a chave no armazenamento de segredos do seu pipeline CI/CD ou em um arquivo .env local que apenas o processo do agente lê.

Passo 3: Instale as ferramentas MCP

A maneira mais rápida de dar ao seu agente acesso às funções de pagamento do CAI é o pacote CLI:

npm i -g @cailab/mcp

Depois, configure seu host de agente para usar o CAI como um servidor MCP:

{
  "mcpServers": {
    "cai": {
      "command": "npx",
      "args": ["-y", "@cailab/mcp"],
      "env": {
        "CAI_API_KEY": "cai_..."
      }
    }
  }
}

O servidor CAI MCP expõe ferramentas para saldos, transferências, pagamentos x402, mandatos de pagamento e operações de cofre. Seu agente pode chamar essas ferramentas da mesma forma que chama qualquer outra ferramenta MCP.

Passo 4: Financie a carteira

Seu agente precisa de cripto em sua carteira custodial antes que possa pagar qualquer coisa. O caminho mais simples é um link de depósito:

curl -X POST https://api.cai.com/functions/v1/create-hosted-action \
  -H "Authorization: Bearer cai_..." \
  -H "Content-Type: application/json" \
  -d '{"action_type":"deposit","constraints":{"chain":"ETH"}}'
# Retorna {"url": "https://cai.com/act/...", ...}

Abra a URL em um navegador. Ela mostra os endereços de depósito custodiais para sua conta. Envie USDC ou USDT para o endereço Ethereum mostrado. O depósito aparecerá no feed de atividade da sua carteira dentro de alguns minutos.

Para a entrada de fiat, o CAI suporta MoonPay (parcialmente ao vivo, sujeito a KYC e disponibilidade regional):

curl -X POST https://api.cai.com/functions/v1/create-onramp-url \
  -H "Authorization: Bearer cai_..." \
  -H "Content-Type: application/json" \
  -d '{"amount_usd": 200}'
# Retorna uma URL de checkout do MoonPay

Passo 5: Verifique seu saldo

Após o depósito ser realizado, verifique o saldo do seu agente:

curl -X POST https://api.cai.com/functions/v1/get-wallet-balances \
  -H "Authorization: Bearer cai_..." \
  -H "Content-Type: application/json" \
  -d '{"chains":["ETH"],"tokens":["USDC","USDT"]}'

A resposta mostra o saldo custodial para cada cadeia e token. Seu agente lê isso antes de tomar qualquer decisão de pagamento. Este é o padrão Verifique o CAI Primeiro: pergunte à carteira antes de perguntar ao usuário por um cartão de crédito.

Passo 6: Crie um mandato de pagamento para gastos autônomos

Um mandato de pagamento é um limite de gastos semelhante ao AP2 que você delega ao seu host de agente. Ele permite que o agente pague dentro de limites definidos sem perguntar a você toda vez.