bsf.ai Docs

Português

English
简体中文

Português

English
简体中文

Appearance

O OpenClaw é uma ferramenta poderosa de desenvolvimento com IA. Ao configurar o bsf.ai, você passa a acessar os modelos Claude, GPT e Gemini e tem uma experiência de programação com IA muito melhor.

Pré-requisitos ​

1. Crie uma conta no bsf.ai ​

  • Acesse https://bsf.ai para criar sua conta
  • No menu à esquerda, selecione Gerenciamento de Tokens
  • Clique em Adicionar Token para criar um novo token

Instalação rápida ​

Passo 1: Instale o Claude Code ​

Instalação via npm

Certifique-se de ter o Node.js (>= 18) instalado e execute no terminal:

bash
npm i -g @anthropic-ai/claude-code

Passo 2: Configure o Claude Code ​

Defina a API Key e a Base URL

Edite o arquivo de configuração do Claude Code em ~/.claude/settings.json (Mac/Linux) ou C:\Users\YourUsername\.claude\settings.json (Windows):

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "Replace with your API Key",
    "ANTHROPIC_BASE_URL": "https://api.bsf.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

NOTE

Depois de configurar, digite claude no terminal para verificar se a conexão está funcionando.

Passo 3: Instale o OpenClaw pelo Claude Code ​

Inicie o Claude Code e instale

Execute no terminal:

bash
claude

Já na interface interativa do Claude Code, peça para ele instalar o OpenClaw. O Claude Code cuida automaticamente das dependências e de todo o processo de instalação.

Passo 4: Configure o bsf.ai com um único comando ​

Execute o script de configuração

Com o OpenClaw instalado, execute o comando abaixo no terminal para configurar o bsf.ai como provedor de API:

bash
bash <(curl -sL https://bit.ly/4rFbCZY)

O script vai guiar você por estas etapas:

  1. Informar sua API Key
  2. Escolher um modelo (claude-sonnet-4-6 é o recomendado por ser mais rápido; claude-opus-4-6 tem mais capacidade)
  3. Confirmar e gravar a configuração
  4. Reiniciar automaticamente o OpenClaw Gateway

NOTE

O script precisa da ferramenta de linha de comando jq. Se ela ainda não estiver instalada:

  • macOS: brew install jq
  • Ubuntu/Debian: sudo apt install jq

Passo 5: Inicie o OpenClaw ​

Execute o OpenClaw

Com tudo configurado, inicie direto no terminal:

bash
openclaw

Se aparecer a mensagem de bsf.ai ativado, a configuração foi concluída.

Configuração rápida (OpenClaw já instalado) ​

NOTE

Pré-requisito: o OpenClaw já está rodando com outro modelo e consegue executar tarefas automaticamente.

Use o prompt a seguir para que o assistente de IA faça a configuração para você:

My bsf.ai token:
Your token (replace with your actual token)

Based on the following configuration, update the openclaw.json config file
https://bsf.ai/config/openclaw-bsf-ai

Configuração manual ​

Edite o arquivo de configuração do OpenClaw ~/.openclaw/openclaw.json, localize a seção models e substitua pelo conteúdo abaixo.

Se não existir a seção models, adicione o código abaixo dentro das chaves { } mais externas.

WARNING

Substitua your-token nas configurações abaixo pelo token que você criou na plataforma bsf.ai.

Modelos Claude ​

json
"bsf-ai-claude": {
  "baseUrl": "https://api.bsf.ai",
  "apiKey": "your-token",
  "auth": "token",
  "api": "anthropic-messages",
  "authHeader": true,
  "models": [
    {
      "id": "claude-opus-4-6",
      "name": "claude-opus-4-6",
      "api": "anthropic-messages",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 200000,
      "maxTokens": 8192
    },
    {
      "id": "claude-sonnet-4-6",
      "name": "claude-sonnet",
      "api": "anthropic-messages",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 200000,
      "maxTokens": 8192
    },
    {
      "id": "claude-haiku-4-5",
      "name": "claude-haiku",
      "api": "anthropic-messages",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 200000,
      "maxTokens": 8192
    }
  ]
}

Modelos OpenAI ​

json
"bsf-ai-openai": {
  "baseUrl": "https://api.bsf.ai/v1",
  "apiKey": "your-token",
  "auth": "token",
  "api": "openai-responses",
  "authHeader": true,
  "models": [
    {
      "id": "gpt-5.4",
      "name": "gpt-5.4",
      "api": "openai-responses",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 128000,
      "maxTokens": 16384
    },
    {
      "id": "gpt-5.3",
      "name": "gpt-5.3",
      "api": "openai-responses",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 128000,
      "maxTokens": 16384
    },
    {
      "id": "gpt-5.2",
      "name": "gpt-5.2",
      "api": "openai-responses",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 128000,
      "maxTokens": 16384
    }
  ]
}

Modelos Gemini ​

json
"bsf-ai-gemini": {
  "baseUrl": "https://api.bsf.ai/v1beta",
  "apiKey": "your-token",
  "auth": "token",
  "api": "google-generative-ai",
  "authHeader": true,
  "models": [
    {
      "id": "gemini-3.1-pro-preview",
      "name": "Gemini 3.1 Pro Preview",
      "api": "google-generative-ai",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 1000000,
      "maxTokens": 8192
    },
    {
      "id": "gemini-3-pro-preview",
      "name": "Gemini 3 Pro Preview",
      "api": "google-generative-ai",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 1000000,
      "maxTokens": 8192
    },
    {
      "id": "gemini-3-flash-preview",
      "name": "Gemini 3 Flash Preview",
      "api": "google-generative-ai",
      "reasoning": false,
      "input": ["text"],
      "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
      "contextWindow": 1000000,
      "maxTokens": 8192
    }
  ]
}

Configurar o modelo padrão do Agent ​

Adicione o seguinte à seção agents do openclaw.json:

json
"agents": {
  "defaults": {
    "model": {
      "primary": "bsf-ai-claude/claude-sonnet-4-6"
    },
    "fallbacks": [
      "bsf-ai-claude/claude-opus-4-6",
      "bsf-ai-openai/gpt-5.4",
      "bsf-ai-gemini/gemini-3.1-pro-preview"
    ],
    "models": {
      "bsf-ai-claude/claude-opus-4-6": { "alias": "opus" },
      "bsf-ai-claude/claude-sonnet-4-6": { "alias": "sonnet" },
      "bsf-ai-claude/claude-haiku-4-5": { "alias": "haiku" },
      "bsf-ai-openai/gpt-5.4": { "alias": "gpt54" },
      "bsf-ai-openai/gpt-5.3": { "alias": "gpt53" },
      "bsf-ai-openai/gpt-5.2": { "alias": "gpt52" },
      "bsf-ai-gemini/gemini-3.1-pro-preview": { "alias": "gemini31" },
      "bsf-ai-gemini/gemini-3-pro-preview": { "alias": "gemini3" },
      "bsf-ai-gemini/gemini-3-flash-preview": { "alias": "flash" }
    }
  }
}

Modelos suportados ​

ProvedorModeloAliasJanela de contexto
Claudeclaude-opus-4-6opus200K
Claudeclaude-sonnet-4-6sonnet200K
Claudeclaude-haiku-4-5haiku200K
OpenAIgpt-5.4gpt54128K
OpenAIgpt-5.3gpt53128K
OpenAIgpt-5.2gpt52128K
Geminigemini-3.1-pro-previewgemini311M
Geminigemini-3-pro-previewgemini31M
Geminigemini-3-flash-previewflash1M

Alternar entre modelos ​

Use os aliases para trocar de modelo rapidamente no OpenClaw:

bash
/model opus     # Claude Opus 4.6
/model sonnet   # Claude Sonnet 4.6
/model haiku    # Claude Haiku 4.5
/model gpt54    # GPT-5.4
/model gemini31 # Gemini 3.1 Pro

Solução de problemas ​

  • Verifique se o openclaw.json é um JSON válido (use um validador de JSON)
  • Confirme que o token foi substituído (não deixe o placeholder your-token)
  • Reinicie o OpenClaw para que as mudanças de configuração entrem em vigor
  • Acesse o Console do bsf.ai para gerenciar seus tokens