Configuración de OpenClaw
OpenClaw es una herramienta de terminal/interfaz web orientada a escenarios de programación. Es compatible con múltiples protocolos de modelos, por lo que la clave de la configuración no es solo rellenar una dirección, sino hacer coincidir baseUrl y api en pares.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
Qué es esta herramienta y para qué sirve
Primero confirma cómo elegir el protocolo
| Escenarios | Cómo consultar la Base URL | Cómo elegir el campo API |
|---|---|---|
| Nativo de OpenAI | Usa la dirección de API de OpenAI / compatible con OpenAI proporcionada por el proveedor; incluir /v1 o no depende del backend | openai-responses |
| Nativo de Claude | Usa la dirección de interfaz de Anthropic / Claude proporcionada por el proveedor | anthropic-messages |
| Nativo de Gemini | Usa la dirección de interfaz de Google / Gemini proporcionada por el proveedor | google-generative-ai |
| Modo de compatibilidad | La dirección de interfaz compatible con OpenAI del proveedor | openai-completions |
Si la página del proveedor separa las interfaces de OpenAI, Claude y Gemini, no copies solo el nombre de dominio; copia también la dirección completa correspondiente al protocolo.
Fragmento de configuración de referencia
Los archivos de configuración suelen encontrarse en ~/. openclaw/openclaw.json. Si el asistente de inicialización no puede completar correctamente la dirección del proveedor, puedes omitir primero la selección del modelo y luego editar manualmente el archivo de configuración.
Fragmento de ejemplo para un solo proveedor en 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 } ] } } }Cómo verificar después de guardar
- Primero, configura solo un proveedor y no agregues muchos modelos de golpe.
- Entra al proyecto de prueba y selecciona el modelo recién añadido.
- Envía la pregunta más breve posible, por ejemplo: 'Por favor, responde únicamente con configuración exitosa.'
- Si se produce un error de protocolo, comprueba primero si el campo api y la Base URL provienen del mismo tipo de interfaz.
Preguntas frecuentes para principiantes
| Problema | Comprobación prioritaria | Solución |
|---|---|---|
| Error relacionado con el protocolo | Si el campo api coincide con la Base URL | No mezcles OpenAI, Claude y Gemini; completa según el protocolo correspondiente del proveedor |
| La lista de modelos está vacía | ¿El proveedor permite obtener la lista de modelos? | Introduce manualmente el ID / nombre del modelo proporcionado por el backend cuando falle la obtención |
| El archivo de configuración cambió pero no surte efecto | Si se ha editado el archivo de configuración que OpenClaw lee realmente | Reinicia OpenClaw y prueba de nuevo; no cambies múltiples ajustes de configuración a la vez |
| La Key es correcta pero sigue fallando | Los campos auth y apiKey del proveedor actual | Confirma que la Key pertenezca al protocolo actual y al proveedor actual |
Sitio web oficial de OpenClaw Consulta la introducción y el acceso a la herramienta.
Referencia de configuración de proveedores de IA en OpenClaw Consulta el enfoque de configurar los campos baseUrl y api en pares bajo diferentes protocolos.