Skip to Content
DocumentaçãoIntegraçõesOpenClaw 🦞

OpenClaw

O OpenClaw  é um assistente de IA open source que roda localmente e interage com você via WhatsApp, Telegram, Slack e outros aplicativos de mensagem. Ele executa ações reais — gerenciar e-mails, calendário, check-in de voos, navegar na web e mais. Todos os dados permanecem no seu dispositivo.

Por que usar com o OfoxAI?

  • 100+ modelos com uma API — Um API Key para Claude, GPT, Gemini, Qwen, Doubao e todos os principais modelos
  • Estratégias flexíveis de Agent — Atribua modelos diferentes a Agents diferentes: Sonnet como principal, Opus para raciocínio, Haiku para tarefas leves
  • 99,9% SLA — Redundância multi-nó, failover automático
  • Custos controláveis — Painel de faturamento unificado, monitoramento de tokens em tempo real

Como assistente de IA agêntico, o OpenClaw consome muitos tokens por tarefa (geralmente 10K a 100K+). Escolha o modelo de acordo com a complexidade da tarefa para evitar custos desnecessários. Este artigo oferece três esquemas de configuração.

Instalação

macOS / Linux
curl -sSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))

Início rápido

1. Obter API Key

Acesse o Painel OfoxAI  e crie um API Key.

2. Executar assistente de configuração

O OpenClaw oferece um assistente interativo:

openclaw onboard

No assistente, selecione Custom Provider e preencha:

ConfiguraçãoValor
Provider Typeanthropic-messages
Base URLhttps://api.ofox.ai/anthropic
API KeySeu API Key OfoxAI
Modelanthropic/claude-sonnet-4.5

3. Iniciar e verificar

openclaw start

Envie uma mensagem de teste ao OpenClaw. Se receber uma resposta normal, a configuração está correta.

O assistente gera automaticamente o arquivo de configuração openclaw.json. Para controle mais granular, consulte a configuração completa abaixo.

Configuração completa

O OpenClaw gerencia todas as configurações via ~/.openclaw/openclaw.json (suporta formato JSON5, com comentários).

Configuração de Provider

Os Providers são definidos em models.providers. Cada Provider precisa de tipo de protocolo API, endereço e chave:

~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": []
      },
      "ofoxai-openai": {
        "baseUrl": "https://api.ofox.ai/v1",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "openai-responses",
        "models": []
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.ai/gemini",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "google-generative-ai",
        "models": []
      }
    }
  }
}

O apiKey suporta a sintaxe ${ENV_VAR} para referenciar variáveis de ambiente, evitando expor a chave em texto plano. Três protocolos para diferentes famílias de modelos: Claude usa ofoxai-anthropic (anthropic-messages), OpenAI usa ofoxai-openai (openai-responses), Gemini usa ofoxai-gemini (google-generative-ai). Outros modelos podem se conectar via ofoxai-openai.

Configuração de modelos

Os modelos são definidos no array models do Provider correspondente. Oferecemos três esquemas:

Time completo Claude — Máxima capacidade para cenários exigentes.

openclaw.json — models.providers
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "anthropic/claude-opus-4.6",
            "name": "Claude Opus 4.6",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-4.5",
            "name": "Claude Haiku 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      }
    }
  }
}
ModeloFunçãoCenário de uso
anthropic/claude-sonnet-4.5Modelo principalConversas diárias, execução de tarefas, geração de código
anthropic/claude-opus-4.6Raciocínio profundoAnálise complexa, cadeias longas de raciocínio, pesquisa
anthropic/claude-haiku-4.5Resposta rápidaConsultas simples, respostas rápidas, tarefas leves

Configuração de Agents

O OpenClaw define padrões globais via agents.defaults e diferentes Agents pelo array agents.list. Cada Agent pode sobrescrever a configuração padrão:

openclaw.json — seção agents
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ofoxai-anthropic/anthropic/claude-sonnet-4.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-4.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-4.6": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-4.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-4.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-opus-4.6"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-haiku-4.5"
        }
      }
    ]
  }
}
AgentModeloUso
mainclaude-sonnet-4.5 (herda de defaults)Agent padrão, todas as tarefas diárias
researchclaude-opus-4.6Pesquisa profunda, raciocínio complexo, análise de textos longos
quickclaude-haiku-4.5Perguntas simples, respostas rápidas, baixo custo

Modelos são referenciados no formato nome-provider/model-id (ex: ofoxai-anthropic/anthropic/claude-sonnet-4.5). Os models em defaults definem aliases que podem ser usados na conversa com /model opus para trocar rapidamente. Agents em list herdam todas as configurações de defaults e só precisam sobrescrever os campos que diferem.

Exemplo de configuração completa

Um openclaw.json completo integrando Provider, Models e Agents (esquema de máxima performance):

~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "anthropic/claude-opus-4.6",
            "name": "Claude Opus 4.6",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-4.5",
            "name": "Claude Haiku 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.ai/gemini",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "models/google/gemini-2.5-flash",
            "name": "Gemini 2.5 Flash",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          },
          {
            "id": "models/google/gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ofoxai-anthropic/anthropic/claude-sonnet-4.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-4.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-4.6": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-4.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-4.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-opus-4.6"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-haiku-4.5"
        }
      }
    ]
  }
}

Cenários de uso

Após configurar, envie comandos ao OpenClaw pelo seu aplicativo de mensagens:

  • Gerenciamento de e-mails — “Organize meus e-mails não lidos por prioridade”
  • Agendamento — “Agende uma reunião de equipe amanhã as 15h”
  • Pesquisa — “Busque artigos recentes sobre AI Agents e resuma os pontos principais”
  • Assistência com código — “Faça um review deste código Python e verifique problemas de segurança”
  • Automação de workflows — “Envie o relatório diário da equipe no canal #general do Slack todos os dias as 9h”

Solução de problemas

Não consegue conectar ao OfoxAI

Confirme a baseUrl correta:

  • Protocolo Anthropic: https://api.ofox.ai/anthropic
  • Protocolo OpenAI-Response: https://api.ofox.ai/v1
  • Protocolo Gemini: https://api.ofox.ai/gemini

Modelo não encontrado

Confirme o formato correto do ID do modelo. Ao definir modelos em models.providers, use o ID completo do OfoxAI (ex: anthropic/claude-sonnet-4.5). Ao referenciar em agents, adicione o prefixo do Provider: ofoxai-anthropic/anthropic/claude-sonnet-4.5.

Alto consumo de tokens

O OpenClaw consome bastante por tarefa. Recomendações:

  1. Para tarefas diárias, use claude-haiku-4.5 ou modelos econômicos
  2. Só troque para o Agent research (com claude-opus-4.6) em tarefas complexas
  3. Monitore o uso no Painel OfoxAI 

Como trocar de modelo rapidamente

Na conversa, use aliases: /model opus, /model sonnet, /model haiku (requer aliases configurados em agents.defaults.models).

Last updated on
ClineCherry Studio