Más modelos nacionales y endpoints de relé personalizados
La página especial de modelos nacionales llega aquí a su cierre: DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, Hunyuan y Qianfan tienen plugins oficiales, y ya se conectaron en las lecciones anteriores. Esta lección resuelve las tres cosas restantes — StepFun, Xiaomi MiMo y Meituan LongCat, que aún tienen plugins oficiales; qué hacer con modelos como Spark y Baichuan que no tienen provider oficial; y la solución universal para el relé de OpenClaw: el endpoint personalizado custom-api-key, más las tres rutas agregadoras OpenRouter, LiteLLM y ClawRouter. Duración total de aproximadamente 10 minutos; este tutorial se basa en v2026.10.9.
Qué podrás hacer al terminar
- Instalar los tres plugins oficiales de StepFun, Xiaomi MiMo y Meituan LongCat, y hacer funcionar sus modelos predeterminados
- Distinguir qué modelos nacionales no tienen provider oficial (Spark, Baichuan, Lingyi Yi, SenseTime), y dejar de perder tiempo buscando plugins
- Conectar cualquier endpoint de relé compatible con OpenAI a OpenClaw con el flujo
custom-api-key— dos formas de escribirlo: onboarding y archivo de configuración - Conectar las tres rutas agregadoras OpenRouter / LiteLLM / ClawRouter y usar varios proveedores con una sola Key
- Saber ajustar los interruptores de compatibilidad del endpoint de relé:
reasoning_effortdevuelve 400, endpoints de red interna rechazados, paso a través de campos privados del proveedor
🎒 Preparativos antes de empezar
- Haber completado Panorama de conexión de modelos: sistema de providers y cambio de modelos: tener claros los tres pasos de «instalar plugin → configurar credenciales → elegir modelo» y las reglas de referencia
provider/model - OpenClaw instalado y Gateway en ejecución:
openclaw gateway statusproduce salida - Tener a mano las credenciales a conectar: la API Key del proveedor, o el baseUrl + API Key que te dio el sitio de relé
- Si usas despliegue en servidor / demonio, saber dónde está
~/.openclaw/.env— la Key terminará viviendo ahí
Hazlo conmigo
Paso 1: elige la ruta — ¿plugin oficial, endpoint personalizado o ruta agregadora?
Por qué: OpenClaw tiene tres caminos para conectar modelos; elegir mal es trabajo en balde — dedica primero 30 segundos a identificar tu caso.
| Tu situación | Qué ruta tomar | A qué paso de esta lección ir |
|---|---|---|
| Usar StepFun / Xiaomi MiMo / Meituan LongCat | Plugin oficial (externo, requiere instalación) | Paso 2 |
| Usar Spark, Baichuan, Lingyi Yi o SenseTime — el proveedor ofrece una API compatible con OpenAI | Endpoint personalizado custom-api-key | Paso 3 |
| Tener un sitio de relé (un proxy compatible con OpenAI que entrega baseUrl + Key) | Endpoint personalizado custom-api-key | Paso 3 |
| Querer usar varios proveedores con una sola Key / pasarela unificada para el equipo | Ruta agregadora | Paso 4 |
Primero, un resultado negativo (verificación completa del repositorio oficial 2026-11-03): iFlytek Spark, Baichuan, Lingyi Wanwu Yi y SenseTime SenseChat no tienen plugin de provider oficial en OpenClaw — no se encuentra el directorio correspondiente ni en extensions/ ni en docs/providers/. El SenseAudio de SenseTime sí es un plugin integrado, pero es un servicio de transcripción de voz, no el modelo grande SenseChat. Así que no busques un «plugin de Spark» — estos tres solo pueden ir por el endpoint personalizado del paso 3, o por la ruta agregadora del paso 4.
Paso 2: conecta StepFun, Xiaomi MiMo y Meituan LongCat (trío de plugins oficiales)
Por qué: estos tres son los últimos asientos de plugins oficiales de modelos nacionales (la versión internacional de Volcano, BytePlus, se trató en la lección de Doubao); el método de instalación es exactamente el mismo que el de DeepSeek — instalar plugin, configurar Key, elegir modelo.
Primero, mira la tabla resumen (toda la información proviene de la documentación oficial de providers):
| Proveedor | Paquete de plugin (externo, requiere instalación) | provider id | Variable de entorno | Modelo predeterminado |
|---|---|---|---|---|
| StepFun (阶跃星辰) | @openclaw/stepfun-provider | stepfun, stepfun-plan | STEPFUN_API_KEY | stepfun/step-3.5-flash |
| Xiaomi MiMo | @openclaw/xiaomi-provider | xiaomi, xiaomi-token-plan | XIAOMI_API_KEY, XIAOMI_TOKEN_PLAN_API_KEY | xiaomi/mimo-v2.6-pro |
| Meituan LongCat | @openclaw/longcat-provider | longcat | LONGCAT_API_KEY | longcat/LongCat-2.0 |
StepFun: distingue primero entre la Key de China y la Key internacional
Las Key de StepFun se dividen por región, y la documentación oficial exige claramente: la Key de China se usa con el endpoint .com, y la Key internacional con el endpoint .ai; no las mezcles.
openclaw plugins install @openclaw/stepfun-provider
openclaw onboard --auth-choice stepfun-standard-api-key-cn # 中国 Key → api.stepfun.com
openclaw onboard --auth-choice stepfun-standard-api-key-intl # 国际 Key → api.stepfun.aiDeberías ver: el onboarding pide pegar STEPFUN_API_KEY y, tras pasar la verificación, el modelo predeterminado pasa a ser stepfun/step-3.5-flash.
Catálogo de modelos del endpoint estándar:
| Referencia del modelo | Contexto | Salida máxima | Notas |
|---|---|---|---|
stepfun/step-3.5-flash | 262,144 | 65,536 | Modelo predeterminado |
stepfun/step-3.7-flash | 262,144 | 262,144 | Multimodal, admite entrada de imágenes |
También existe el endpoint Step Plan (provider independiente, prefijo de referencia stepfun-plan/..., auth-choice es stepfun-plan-api-key-cn|intl), con modelos como stepfun-plan/step-3.5-flash-2603. Step 3.7 admite tres niveles de effort (low / medium / high) y no tiene modo de no razonamiento; /think off se mapea a low.
Xiaomi MiMo: dos providers, pago por uso y Token Plan
openclaw plugins install @openclaw/xiaomi-provider
openclaw onboard --auth-choice xiaomi-api-key # 按量付费,sk-... Key
openclaw onboard --auth-choice xiaomi-token-plan-sgp # Token Plan,tp-... Key(区域可选 cn / sgp / ams)La Key de pago por uso se crea en la consola de Xiaomi MiMo: platform.xiaomimimo.com/#/console/api-keys; para el Token Plan, copia el endpoint regional desde la página de suscripción junto con la Key tp-... correspondiente.
Resumen de modelos: mimo-v2.6-pro (predeterminado), mimo-v2.6-flash, mimo-v2.6-pro-ultraspeed (el catálogo oficial indica una velocidad de salida de 20x), mimo-v2.5, mimo-v2.5-pro — todos con un contexto de 1,048,576 token. Se admite /think en todos los niveles (de off a max, predeterminado high). Este plugin también incluye TTS (mimo-v2.5-tts); si quieres darle voz a Claw, consulta la lección de imágenes y voz.
Meituan LongCat: un solo modelo, centrado en el razonamiento
openclaw plugins install @openclaw/longcat-provider
openclaw onboard --auth-choice longcat-api-keyLa Key se crea en la plataforma de API de LongCat: longcat.chat/platform/api_keys.
Solo hay un modelo: longcat/LongCat-2.0 — 1,048,576 de contexto / 131,072 de salida máxima, solo entrada de texto plano; el posicionamiento oficial es «un modelo de razonamiento construido para cargas de trabajo de coding y agentic». Precio (según la documentación oficial, por millón de token): entrada $0.75 (sin caché) / $0.015 (aciertos de caché), salida $2.95.
💡 ¿Quieres ejecutar localmente los pesos open source de LongCat?
No uses la referencia longcat/LongCat-2.0 para conectarte a un despliegue local: apunta a la API alojada. Para ejecutar localmente los pesos open source, usa vLLM / SGLang; consulta la siguiente lección Modelos locales: Ollama, vLLM y ds4.
- Con el proveedor que hayas instalado,
openclaw models list --provider stepfun(oxiaomi/longcat) listará su catálogo de modelos
Paso 3: configurar un endpoint intermedio en OpenClaw — el flujo general de custom-api-key
Por qué: Spark, Baichuan, Lingyi y SenseTime no tienen plugin oficial; y los «intermediarios» o «proxies de API» del mercado son cada uno despliegues privados propios. Pero mientras te den un baseUrl compatible con OpenAI más una API Key, OpenClaw podrá integrarse con el flujo custom-api-key — este es el método central de esta lección.
Método A (recomendado): un solo comando de onboarding
Versión no interactiva con todos los parámetros (parámetros tomados del ejemplo de la documentación oficial; $CUSTOM_API_KEY debe estar configurado en el entorno):
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice custom-api-key \
--custom-base-url "https://llm.example.com/v1" \
--custom-model-id "foo-large" \
--custom-api-key "$CUSTOM_API_KEY" \
--custom-compatibility openaiLos cinco parámetros se encargan cada uno de una cosa:
| Parámetro | Función | Atención |
|---|---|---|
--custom-base-url | Dirección del intermediario | Los endpoints compatibles con OpenAI normalmente deben incluir /v1; ver la advertencia sobre errores comunes |
--custom-model-id | ID del modelo | Se puede omitir: si se omite, se descubre automáticamente desde /models del endpoint (tiempo de espera de 5 s), guardando todos los modelos descubiertos y usando el primero como predeterminado; si falla el descubrimiento, vuelve a ejecutarlo y especifica explícitamente |
--custom-api-key | API Key | Si se omite, se lee de la variable de entorno CUSTOM_API_KEY |
--custom-compatibility | Forma del protocolo | openai (predeterminado, chat completions) / openai-responses (solo endpoints con /v1/responses) / anthropic; con anthropic hay que dar --custom-model-id |
--custom-image-input / --custom-text-input | Tipo de entrada | Los ID de modelos de visión habituales (GPT-4o/4.1/5.x, Claude 3/4, Gemini, Qwen-VL, LLaVA, Pixtral, etc.) se marcan automáticamente como entrada de imágenes; los modelos de visión que no estén en la lista se marcan forzosamente con el primero |
Deberías ver: el comando termina sin errores; en openclaw models status aparece un provider personalizado, con el modelo predeterminado apuntando al ID que diste.
¿No quieres memorizar parámetros? Ejecuta de forma interactiva openclaw onboard, elige Custom setup para recorrer todas las opciones guiadas; lo que rellenas es lo mismo.
⚠️ ¿Gateway corre como demonio? No pongas la Key en un shell interactivo
Cuando Gateway se ejecuta como servicio de launchd / systemd, no ve las variables de entorno que export en tu terminal. Escribe la Key en ~/.openclaw/.env, o propórcionasela a ese proceso mediante env.shellEnv de la configuración.
Método B: modificar el archivo de configuración manualmente
Te gusta tener todo bajo control, o necesitas desplegar configuraciones en lote en varias máquinas: models.providers escrito a mano. Ejemplo oficial de un endpoint sin autenticación (tal cual):
{
agents: {
defaults: { model: { primary: "my-studio/qwen3.8" } },
},
models: {
providers: {
"my-studio": {
baseUrl: "https://studio.example.ts.net/v1",
api: "openai-completions",
auth: "none",
models: [{ id: "qwen3.8", name: "Qwen3.8" }],
},
},
},
}Forma de escribirlo con Key y con metadatos completos del modelo (extracto tal cual del ejemplo oficial):
{
agents: {
defaults: {
model: { primary: "lmstudio/my-local-model" },
models: { "lmstudio/my-local-model": { alias: "Local" } },
},
},
models: {
providers: {
lmstudio: {
baseUrl: "http://localhost:1234/v1",
apiKey: "${LM_API_TOKEN}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "my-local-model",
name: "Local Model",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 200000,
maxTokens: 8192,
},
],
},
},
},
}Los campos del modelo se pueden omitir; valores por defecto al omitirlos: reasoning: false, input: ["text"], cost todo 0, cuando contextWindow no se establece se aplica 200000 como respaldo. Recomendación oficial: escribe todo explícitamente según los límites reales de tu proxy / modelo.
Endpoint sin autenticación: auth: "none"
Los servicios de inferencia autoconstruidos en red interna, en tailnet / VPN, a menudo no tienen Key. OpenClaw lo soporta, pero hay dos reglas estrictas:
- Declarar explícitamente
auth: "none"(en onboarding corresponde a--custom-no-auth, no se puede usar junto con--custom-api-key)——la detección automática de ausencia de autenticación solo cubre direcciones loopback y RFC1918; tailnet / VPN, que son «red privada pero no RFC1918», requieren declaración explícita auth: "none"solo surte efecto para el adaptadoropenai-completions; los endpoints compatibles con Responses, Azure OpenAI y Anthropic, incluso sin autenticación, deben llevar una Key de marcador de posición
Interruptores de compatibilidad (compat) para endpoints de retransmisión
OpenClaw aplica automáticamente una capa de recorte conservador a los «endpoints openai-completions cuyo baseUrl no es api.openai.com», para evitar que la estación de retransmisión sea saturada por campos exclusivos de OpenAI. Comparación entre reglas automáticas e interruptores manuales:
| Fenómeno / necesidad | Interruptor |
|---|---|
La estación de retransmisión no reconoce el rol developer | Automático: los endpoints no nativos fuerzan compat.supportsDeveloperRole: false (incluso si se escribe true explícitamente, se sobrescribe) |
Devuelve 400: no reconoce reasoning_effort | Establecer para ese modelo compat.supportsReasoningEffort: false (los modelos personalizados de reasoning: true envían por defecto este campo cuando thinking está activado) |
Las sesiones con thinking exigen reproducir reasoning_content | Establecer compat.requiresReasoningContentOnAssistantMessages: true (los nombres de los campos de reproducción reasoning / reasoning_text / reasoning_content se conservan por defecto tal cual) |
| Quieres pasar campos privados del fabricante | agents.defaults.models["provider/model"].params.extra_body (o extraBody), se fusionan en el cuerpo de la petición |
| Endpoint de LAN / tailnet rechazado | models.providers.<id>.request.allowPrivateNetwork: true (loopback se permite por defecto) |
| El endpoint lento siempre agota el tiempo de espera | models.providers.<id>.timeoutSeconds |
| La retransmisión compatible con Anthropic no reconoce las cabeceras beta | Automático: se suprimen las cabeceras beta implícitas (como claude-code-20250219); si realmente necesitas funciones beta, decláralas explícitamente en models.providers.<id>.headers["anthropic-beta"] |
openclaw models statuspermite ver el origen de las credenciales de los providers personalizados; la dirección del endpoint se consulta conopenclaw config get models.providers.<id>.baseUrl
Paso 4: elegir una de las tres rutas de agregación——OpenRouter, LiteLLM, ClawRouter
Por qué: ¿no quieres registrarte en cada proveedor de modelos? Las rutas de agregación te dan una sola Key para modelos de varios proveedores. Los tres plugins vienen todos integrados en OpenClaw (included in OpenClaw), no hace falta instalarlos primero.
| Ruta | Qué es | Autenticación | Dirección / modelo por defecto |
|---|---|---|---|
| OpenRouter | Servicio comercial de agregación, una sola Key para llamar a modelos de varios proveedores | OAuth o API Key | Modelo por defecto openrouter/auto |
| LiteLLM | Pasarela LLM open source autoalojada (100+ provider) | Proxy con tus propias Key | Proxy por defecto http://localhost:4000 |
| ClawRouter | OpenClaw Enrutador multi-upstream alojado oficialmente | Key con alcance de política emitida por el administrador | https://clawrouter.openclaw.ai |
OpenRouter: una sola Key para usar modelos nacionales + internacionales
En el directorio starter integrado ya hay modelos nacionales: openrouter/moonshotai/kimi-k2.6, openrouter/moonshotai/kimi-k2.5; otras referencias tienen la forma openrouter/<provider>/<model>, resolviendo dinámicamente el catálogo oficial de OpenRouter. Al llamar a DeepSeek V4 vía OpenRouter, OpenClaw rellena automáticamente reasoning_content para la reproducción, y las sesiones con thinking no se interrumpen.
# 方式一:API Key(在 openrouter.ai/keys 创建)
openclaw onboard --auth-choice openrouter-api-key
# 方式二:聊天里直接 OAuth(私聊发送,浏览器登录授权)
/login openrouterDeberías ver: tras pasar la validación, el modelo por defecto es openrouter/auto. Para fijar un modelo concreto: openclaw models set openrouter/moonshotai/kimi-k2.6.
LiteLLM: pasarela unificada autoalojada, con contabilidad de costes
LiteLLM es una pasarela LLM open source que expone una API unificada para 100+ provider, con seguimiento de costes, registros, Key virtuales con límites y conmutación por error de backend. OpenClaw se conecta a su /v1 compatible con OpenAI:
openclaw onboard --auth-choice litellm-api-key
# 提示代理地址时回车用默认 http://localhost:4000,或填你的代理 URLVersión no interactiva para proxy remoto (tal cual en la documentación oficial):
openclaw onboard --non-interactive --accept-risk --skip-health --auth-choice litellm-api-key \
--litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"El onboarding llamará al /v1/models del proxy para descubrir los modelos y usará el primero como predeterminado; si falla el descubrimiento, te pedirá rellenar el ID manualmente. Para un proxy LiteLLM en la LAN, recuerda añadir request.allowPrivateNetwork: true. Para emitir Key con límites a distintas personas, usa el POST /key/generate de LiteLLM (max_budget / budget_duration).
ClawRouter: alojado oficialmente, las credenciales no salen de casa
ClawRouter es el enrutador multi-upstream alojado oficialmente por OpenClaw: las credenciales y el reenvío de cada proveedor upstream permanecen del lado de ClawRouter, y en tu máquina OpenClawno hace falta instalar ningún plugin de provider upstream. El plugin está integrado y activado por defecto; solo necesitas una Key emitida por el administrador (se muestra una vez al emitirla, guárdala bien).
export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
openclaw models list --all --provider clawrouter(clawrouter ya está activado por defecto; solo hace falta añadirlo primero a la lista de permitidos si en la configuración se ha establecido plugins.allow.)
Las referencias de modelos conservan el espacio de nombres upstream, en formato de tres segmentos: clawrouter/openai/gpt-5.5, clawrouter/anthropic/claude-sonnet-4-6, clawrouter/google/gemini-3.5-flash——úsalas tal cual como las devuelve el catálogo, openclaw models set clawrouter/<provider>/<model>. El catálogo se descubre según el ámbito de permisos de la Key vía /v1/catalog (en caché 1 hora), y las cuotas se consultan en /v1/usage.
Paso 5: validar la cadena de retransmisión
Por qué: que la configuración esté guardada en disco no significa que la cadena funcione. Se comprueba por capas: catálogo, credenciales y conversación de extremo a extremo; así sabes dónde reparar si alguna capa se rompe——este paso es común para los plugins oficiales y para los endpoints de retransmisión personalizados.
# 1. 看目录:新接入的 provider 和模型有没有进来
openclaw models list
# 2. 看凭据:默认模型、fallback,以及各 provider 的凭据来源
openclaw models status
# 3. 发一条测试消息,确认端到端连通
openclaw agent --agent <agent-id> --model <provider/model> --message "用一句话介绍你自己"El comando 3 ejecuta desde el terminal una ronda completa de agent turn (reenviada vía Gateway). Ten en cuenta que openclaw agent debe llevar al menos un selector de sesión: --agent, --to, --session-key o --session-id; el más usado es --agent <id>; --model acepta referencias provider/model, surte efecto solo para esa ronda y no cambia el valor por defecto de la sesión.
Deberías ver:
models list: en el directorio aparecen el provider y el modelo que acabas de conectar; el endpoint personalizado muestra el ID de modelo guardado durante el onboarding (el descubrimiento automático guarda todos los modelos que devuelve/models)models status: el modelo predeterminado apunta al modelo que elegiste, y el origen de credenciales del provider personalizado se muestra correctamente; no aparece el texto «Unavailable auth profiles» (si apareciera, la entrada incluiría el motivo y la acción de recuperación; basta con seguirla). Para verificar la dirección del endpoint:openclaw config get models.providers.<id>.baseUrlagent: el modelo te responde una frase y el comando termina con código de salida 0; los errores, tiempos de espera agotados y cancelaciones terminan con 1. La cadena de retransmisión queda conectada de extremo a extremo
Una vez superadas las pruebas, establece el modelo que te resulte cómodo como predeterminado diario:
openclaw models set <provider/model>- el mensaje de prueba recibe respuesta y
openclaw agenttermina con código de salida 0: la cadena de retransmisión queda conectada de extremo a extremo
Punto de control ✅
- Instala el que uses:
openclaw models list --provider stepfun(oxiaomi/longcat) puede listar el directorio de modelos - Recuerda los resultados negativos: Spark, Baichuan, Yi de 01.AI y SenseChat de SenseTime no tienen provider oficial; ve directo al endpoint personalizado
custom-api-keyo a la ruta de agregación, y no pierdas más tiempo buscando plugins - Endpoint personalizado ya conectado:
openclaw models statuspermite ver el origen de credenciales de ese provider, yopenclaw config get models.providers.<id>.baseUrlpermite consultar la dirección del endpoint openclaw agentel mensaje de prueba recibe respuesta y el código de salida es 0: la cadena de retransmisión OpenClaw queda conectada de extremo a extremo- Si surge un problema de compatibilidad, sabes dónde consultar: la tabla de interruptores compat del paso 3 (
reasoning_effortdevuelve 400, endpoints de red interna rechazados, passthrough de campos privados del proveedor)
Avisos de errores comunes
❌ Falta /v1 en baseUrl, todas las solicitudes dan 404
El baseUrl de un endpoint compatible con OpenAI generalmente debe escribirse hasta .../v1: la petición de descubrimiento de modelos va a <baseUrl>/models (la documentación oficial da como ejemplo /v1/models), y la petición de conversación también se concatena después del baseUrl (por ejemplo /v1/chat/completions). Los baseUrl de los ejemplos oficiales terminan todos en /v1. Al recibir la dirección de una plataforma de retransmisión, mira primero el final; si no estás seguro, copia tal cual el «Base URL» de su documentación.
❌ El descubrimiento automático de modelos falla, o el modelo predeterminado no es el deseado
Al omitir --custom-model-id, el onboarding solicitará <baseUrl>/models para el descubrimiento automático (tiempo de espera de 5 segundos), guardando todos los modelos descubiertos y usando el primero como predeterminado. Si el endpoint no está disponible, devuelve datos no válidos o la lista está vacía, fallará; vuelve a ejecutarlo especificando explícitamente --custom-model-id. ¿El primer modelo descubierto no te sirve? No hace falta reconfigurar: cambia el predeterminado con openclaw models set <provider/model>.
❌ Una Key de StepFun de China configurada con el endpoint internacional (o al revés)
Las Keys de StepFun se dividen por región: la Key de China se configura con el endpoint .com, la Key internacional con el endpoint .ai, y la documentación oficial exige claramente no mezclarlas. El endpoint queda decidido al elegir entre stepfun-standard-api-key-cn y -intl en auth-choice; si la autenticación falla, comprueba primero si elegiste mal la región.
❌ El endpoint compatible con Anthropic no recibió --custom-model-id
La configuración de --custom-compatibility anthropicdebe incluir --custom-model-id: los endpoints compatibles con Anthropic no tienen fase de descubrimiento automático de modelos, y omitirlo hace que falle directamente.
❌ auth: "none" no surte efecto
Dos reglas estrictas: ① la detección automática de ausencia de autenticación solo cubre direcciones loopback y RFC1918; los endpoints en tailnet / VPN deben declarar explícitamente auth: "none" (en onboarding corresponde a --custom-no-auth, que no puede usarse junto con --custom-api-key); ② auth: "none" solo surte efecto con el adaptador openai-completions; Responses, Azure OpenAI y los endpoints compatibles con Anthropic necesitan una Key de marcador de posición incluso sin autenticación.
❌ Con el Gateway corriendo como demonio, la Key exportada «no surte efecto»
Cuando el Gateway se ejecuta como servicio de launchd / systemd, no ve las variables de entorno de export de tu terminal. Escribe la Key en ~/.openclaw/.env, o proporciónasela a ese proceso mediante env.shellEnv en la configuración (el recuadro de advertencia del método A del paso 3 ya lo explicó; es un error muy frecuente, así que lo recordamos aquí una vez más).
❌ La plataforma de retransmisión no reconoce reasoning_effort, y al activar thinking devuelve 400
Al activar thinking, un modelo personalizado con reasoning: true envía por defecto el campo reasoning_effort, que algunas plataformas de retransmisión no reconocen. Establece compat.supportsReasoningEffort: false para ese modelo. Otros problemas de compatibilidad (rechazo del rol developer, passthrough de campos privados, endpoints de red interna rechazados) se tratan en la tabla de interruptores compat del paso 3.
❌ Saldo insuficiente en la plataforma de retransmisión / facturación mal configurada
Aunque toda la cadena esté bien configurada, puede fallar por la facturación: saldo insuficiente en la plataforma de retransmisión o modelo vinculado no habilitado harán que las peticiones fallen. Si quieres usar la comprobación en vivo que trae OpenClaw: openclaw models status --probe envía peticiones reales a las credenciales configuradas (puede consumir tokens y activar límites de tasa), y los fallos de facturación se agrupan en el bucket de estado billing; ten en cuenta que exige exclusividad sobre el directorio de estado, así que primero ejecuta openclaw gateway stop para detener el Gateway. Para la resolución cotidiana, revisa primero el saldo y el estado de habilitación de modelos en el panel de la plataforma de retransmisión: es más directo.
Siguiente paso
Aquí concluye la página dedicada a los modelos nacionales: ya dominas las tres vías de plugins oficiales (DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, Hunyuan, Qianfan, StepFun, MiMo, LongCat), endpoint personalizado y ruta de agregación. La solución universal para la retransmisión con OpenClaw: Recuerda una frase: si hay plugin oficial, instala el plugin; si no hay provider oficial, usa custom-api-key; y si quieres usar varios proveedores con una sola Key, ve por la ruta de agregación. A continuación:
- Siguiente lección Modelos locales: Ollama, vLLM y ds4: inferencia local sin salir a la red y sin costos de API; ejecutar localmente los pesos de código abierto de LongCat también está en esta lección
- Otras páginas de modelos: entra desde Conexión de modelos: panorama general: sistema de providers y cambio de modelo del temario
- ¿Ya tienes los modelos configurados? El uso cotidiano empieza en Uso diario: convive eficientemente con tu Claw: Control UI, comandos de chat y sistema de memoria están en ese capítulo
Tutoriales relacionados
- Conectar DeepSeek: guía práctica de configuración de los modelos de la serie V4: el procedimiento estándar para conectar el plugin oficial; la instalación de StepFun / MiMo / LongCat de esta lección sigue el mismo patrón
- Conexión de modelos: panorama general: sistema de providers y cambio de modelo: los 3 pasos de «instalar plugin → configurar credenciales → elegir modelo» y las reglas de referencia
provider/model - Conectar Doubao/Volcengine: el endpoint Ark y el Coding Plan: el plugin oficial del ecosistema Volcano, incluye la versión internacional BytePlus
- Conectar Tencent Hunyuan y Baidu Qianfan: MaaS de las grandes tecnológicas en la práctica: la lección anterior: las dos plataformas MaaS de Tencent y Baidu
- Imágenes y voz: añade imágenes al contenido y convierte artículos a voz: el plugin MiMo de Xiaomi incluye TTS propio (
mimo-v2.5-tts); para configurar voz, mira esta lección