Configuração do OpenClaw
O OpenClaw é uma ferramenta de terminal/Web UI voltada para cenários de programação. Ele suporta múltiplos protocolos de modelos, portanto o foco da configuração não é apenas preencher um endereço, mas fazer com que o baseUrl e o api coincidam em pares.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
O que é esta ferramenta e para que serve
Primeiro confirme como escolher o protocolo
| Cenários | Como verificar a Base URL | Como escolher o campo API |
|---|---|---|
| Nativo OpenAI | Use o endereço de API da OpenAI ou compatível com OpenAI fornecido pelo provedor; a inclusão de /v1 depende do backend | openai-responses |
| Nativo Claude | Use o endereço de interface Anthropic / Claude fornecido pelo provedor | anthropic-messages |
| Nativo Gemini | Use o endereço de interface Google / Gemini fornecido pelo provedor | google-generative-ai |
| Modo de Compatibilidade | O endereço de interface compatível com OpenAI do provedor | openai-completions |
Se a página do provedor separar as interfaces OpenAI, Claude e Gemini, não copie apenas o nome de domínio; copie também o endereço completo correspondente ao protocolo.
Referência de trecho de configuração
Os arquivos de configuração geralmente estão localizados em ~/. openclaw/openclaw.json Se o assistente de inicialização não conseguir preencher corretamente o endereço do provedor, você pode primeiro pular a seleção de modelo e depois editar manualmente o arquivo de configuração.
Exemplo de trecho para um único provedor no OpenClaw
"models": { "providers": { "mz-openai": { "baseUrl": "https://YOUR_PROVIDER_API_URL", "apiKey": "YOUR_KEY", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "MODEL_ID_FROM_PROVIDER_DASHBOARD", "name": "DISPLAY_NAME", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }Como verificar após salvar
- Primeiro, configure apenas um provedor e não adicione muitos modelos de uma só vez.
- Entre no projeto de teste e selecione o modelo recém-adicionado.
- Envie uma pergunta curta, como 'Por favor, responda apenas com: configuração bem-sucedida.'
- Se for reportado um erro de protocolo, primeiro verifique se o campo api e a Base URL são do mesmo tipo de interface.
Perguntas frequentes para iniciantes
| Problema | Verificação prioritária | Como resolver |
|---|---|---|
| Erro relacionado a protocolo | Se o campo api corresponde à Base URL | Não misture OpenAI, Claude e Gemini; preencha de acordo com o protocolo do respectivo provedor |
| A lista de modelos está vazia | O provedor suporta a obtenção da lista de modelos? | Insira manualmente o ID / nome do modelo fornecido pelo backend quando a busca falhar |
| O arquivo de configuração foi alterado, mas não está surtindo efeito | Se o arquivo de configuração realmente lido pelo OpenClaw foi o editado | Reinicie o OpenClaw e teste novamente; não altere várias configurações ao mesmo tempo |
| A chave está correta, mas ainda falha | Os campos auth e apiKey do Provedor atual | Confirme se a chave pertence ao protocolo e provedor atuais |
Site Oficial do OpenClaw Veja a introdução e o acesso à ferramenta.
Referência de Configuração de Provedores de IA no OpenClaw Consulte como configurar os campos baseUrl e api em pares sob diferentes protocolos.