Clientes/OpenClaw
Use a API da Wokey com o OpenClaw
Obtenha uma chave de API da Wokey, aponte o OpenClaw para a base URL da Wokey e confirme a conexão com uma requisição curl.
Atualizado
Nesta páginaexpand_more
Obtenha uma chave de API e a base URLlink
Todos os clientes usam a mesma chave de API da Wokey e a mesma base URL.
Crie uma chave de API
Entre e crie uma chave da plataforma na página API. As chaves de uma mesma conta compartilham o saldo dela.
Criar chave de APIkeyUse a base URL da Wokey
Defina como base URL do cliente o domínio do gateway; a configuração abaixo mostra se é preciso acrescentar /v1.
Configure o clientelink
Grave um provider personalizado compatível com OpenAI com um único comando.
openclaw onboard --non-interactive --accept-risk \
--auth-choice custom-api-key \
--custom-base-url "https://api.wokey.ai" \
--custom-model-id "gpt-6-sol" \
--custom-api-key "YOUR_API_KEY" \
--custom-provider-id "wokey" \
--custom-compatibility openai \
--gateway-port 18789 \
--skip-healthFormatos de API e base URLslink
Quando um mesmo cliente troca de formato de API, pode mudar se a base URL termina em /v1.
| Formato | Base URL | Use para |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi e outros modelos |
Onde é configurado: Flags do comando openclaw onboard
Rode o OpenClaw como agente sempre ativo com o Opus 5.5: comparação com o Claude Duetlink
Em 2026-10-21 a Anthropic abriu uma prévia de pesquisa do Claude Duet, um agente proativo baseado no Claude Opus 5.5 que envia um resumo toda manhã, acompanha em segundo plano os apps que você conectou e pergunta antes de agir. O Duet só funciona com login em uma conta Claude; não há chave de API nem base URL personalizada, então ele não pode rodar pela Wokey. O OpenClaw é um agente sempre ativo, de código aberto e auto-hospedado: conectado à Wokey, ele usa o mesmo modelo Opus 5.5, sem lista de espera e sem restrição de região.
| Claude Duet | OpenClaw + Wokey | |
|---|---|---|
| Modelo | Claude Opus 5.5, não pode ser trocado | claude-opus-5-5 ou qualquer outro modelo da Wokey |
| Quem pode usar | Assinantes do Claude Pro e Max nos EUA, por lista de espera; ainda não Team nem Enterprise | Você mesmo instala; basta uma chave de API da Wokey, em qualquer região |
| Custo | Sem cobrança extra durante a prévia, mas compartilha os limites de uso do seu plano com o chat e o Claude Code, incluindo as verificações em segundo plano | Pagamento por token a partir do seu saldo na Wokey; você escolhe com que frequência ele verifica |
| Onde roda | Uma máquina virtual com navegador próprio na nuvem da Anthropic; continua funcionando com seu celular e notebook desligados | Seu próprio computador ou servidor; hospede em uma máquina sempre ligada para funcionar 24 horas por dia |
| Como você conversa com ele | O app Duet (iOS e Android) e claude.ai | Apps de chat como Telegram e Slack |
| Memória e ferramentas | Herda a memória, as skills e os conectores da sua conta Claude | Memória, skills e ferramentas ficam na sua máquina; você instala e gerencia |
| Aprovação antes de agir | Pergunta antes de enviar mensagens, pagar, assinar ou excluir; negociação de valores mobiliários e transferências entre contas nunca são permitidas | Você define as permissões e as regras de aprovação; dê acesso só às contas necessárias |
- Com cobrança por token, verificações frequentes custam mais: cada verificação reenvia o prompt de sistema e a memória. Use um modelo mais barato (como claude-sonnet-5-5 ou deepseek-v4.1-flash) nas verificações de rotina e mude para o Opus 5.5 para decisões e ações.
- Pelo Chat Completions, o Opus 5.5 pensa antes de escrever, então o primeiro token demora; um agente trabalhando em segundo plano quase não percebe.
openclaw onboard --non-interactive --accept-risk \
--auth-choice custom-api-key \
--custom-base-url "https://api.wokey.ai" \
--custom-model-id "claude-opus-5-5" \
--custom-api-key "YOUR_API_KEY" \
--custom-provider-id "wokey" \
--custom-compatibility openai \
--gateway-port 18789 \
--skip-healthInformações do Duet verificadas em 2026-10-22 · Fontes sobre o Duet: Introducing Claude Duet · Claude Duet FAQ
Verifique com curllink
Se o cliente mostrar um erro, primeiro descarte problemas com a chave e a base URL usando curl.
OpenClaw usa o formato OpenAI Chat Completions por padrão. Se esta requisição retornar 200, a chave e a base URL estão corretas. Substitua YOUR_API_KEY pela sua chave antes de enviar.
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'Erros e solução de problemaslink
Primeiro separe os casos de autenticação, saldo, limite de taxa, disponibilidade do modelo e tempo limite do upstream.
invalid api key
A chave está ausente, foi digitada errado, foi excluída, ou os cabeçalhos Authorization / x-api-key são conflitantes.
insufficient balance
O saldo da conta está baixo demais. Recarregue antes de enviar mais requisições.
model_denylisted / account_restricted
As chamadas ao modelo, ou a todos os modelos da conta, estão pausadas após violações repetidas. Veja Taxas de tratamento de violação e restrições.
request_blocked
Esta requisição foi bloqueada antes de chegar ao upstream e não é cobrada, por exemplo o reenvio sem alterações de uma requisição que o modelo acabou de recusar, ou um usuário final pausado (X-End-User-Id). A mensagem de erro diz o que está bloqueado; altere a requisição conforme indicado ou tente de novo mais tarde. As outras requisições não são afetadas.
rate limited
O tráfego está frequente demais. Tente de novo mais tarde ou reduza a concorrência. Se só um modelo, ou um usuário final (X-End-User-Id), continua retornando 429, pode ser um limite temporário após violações.
client disconnected
O cliente fechou a conexão antes de a resposta terminar (código downstream_aborted). Por padrão isso é gratuito. Quando uma conta tem pelo menos 50 desconexões do cliente nas últimas 24 horas e elas representam 10% ou mais das suas requisições, as requisições desconectadas seguintes são cobradas pelo uso que o upstream informou: a entrada processada, incluindo leituras e gravações de cache, e a saída apenas quando o upstream a contabilizou. Uma desconexão antes de o upstream informar qualquer uso continua gratuita. A conta é avisada quando a cobrança começa, e a cobrança para automaticamente em até uma hora quando a taxa de desconexão volta ao normal. A causa comum é um tempo limite do cliente ou do proxy curto demais, ou um programa que cancela requisições antes de terminarem.
upstream unavailable
O serviço do modelo upstream está temporariamente indisponível. Troque de modelo ou tente de novo mais tarde.
upstream timeout
A resposta do upstream excedeu o tempo limite. Encurte o contexto, reduza max_tokens ou tente de novo.
upstream overloaded
O modelo upstream está temporariamente sobrecarregado e a Wokey já tentou de novo por outras rotas (código upstream_overloaded). Não tem relação com o seu saldo. Tente de novo em instantes ou troque de modelo.
Perguntas frequenteslink
- O --custom-base-url do OpenClaw deve terminar em /v1?
- Não. Use https://api.wokey.ai.
- O que vai em --custom-compatibility?
- openai. Assim o OpenClaw chama a Wokey no formato compatível com OpenAI.
- O que vai em --custom-model-id?
- Um ID de modelo da página de modelos da Wokey, por exemplo gpt-6-sol ou claude-opus-5-5.