MandAPI
Español ▾
Herramientas de programación

Añade MandAPI como proveedor de OpenClaw

Registra un proveedor personalizado y comprueba un chat local antes de conectar canales.

Usa esta guía con tu asistente de programación

Leer las instrucciones
Configura mi instalación existente de OpenClaw con un proveedor personalizado de MandAPI, conservando canales, espacio de trabajo y políticas de herramientas. Localiza el archivo activo con openclaw config file y guarda una copia. Añade models.providers.mandapi con baseUrl https://api.mandapi.com/v1, api openai-completions, apiKey ${MANDAPI_API_KEY} y un MODEL_ID exacto visible para mi cuenta. Mantén la clave real privada y comprueba que la recibe el proceso o servicio correcto. Si los ajustes difieren, revisa modelos sobrescritos en models.json del agente. Valida, selecciona mandapi/MODEL_ID y guía una prueba local de texto y un resumen del proyecto sin cambios. Revisa el consumo y explica cómo restaurar. No crees conexiones de mensajería ni despliegues un servicio público.
TXT

Registra la conexión del modelo

Utiliza tu instalación local existente de OpenClaw. Ejecuta openclaw config file para localizar la configuración activa y guarda una copia antes de combinar cambios. Elige un ID exacto de MandAPI con Chat Completions y herramientas adecuadas para tu agente.

Combina el bloque siguiente con la configuración existente. Sustituye MODEL_ID y conserva tus otros proveedores, canales y ajustes del espacio de trabajo:

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "mandapi": {
        "baseUrl": "https://api.mandapi.com/v1",
        "apiKey": "${MANDAPI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "MODEL_ID",
            "name": "MandAPI"
          }
        ]
      }
    }
  }
}

openai-completions es el nombre del adaptador Chat Completions en OpenClaw y utiliza la base /v1 indicada. Responses necesita otro adaptador y un modelo que admita ese formato; cambiar solo el nombre del modelo no cambia el protocolo.

Proporciona la credencial al proceso

Configura MANDAPI_API_KEY de forma privada antes de iniciar el proceso local. En Bash:

bash
read -rsp "Clave de MandAPI: " MANDAPI_API_KEY
printf '\n'
export MANDAPI_API_KEY

O en PowerShell:

powershell
$env:MANDAPI_API_KEY = [Net.NetworkCredential]::new('', (Read-Host 'Clave de MandAPI' -AsSecureString)).Password

Si OpenClaw se ejecuta como servicio, añade la variable al entorno de ese servicio; una variable en otra terminal no llega automáticamente. El texto ${MANDAPI_API_KEY} del JSON es una referencia, no la clave real.

Valida y selecciona

bash
openclaw config validate
openclaw models list
openclaw models set mandapi/MODEL_ID

Inicia un chat local desde tu interfaz habitual de OpenClaw. Haz una pregunta breve sin herramientas y después pide un resumen pequeño del proyecto sin modificar archivos. Comprueba el modelo seleccionado y su consumo en MandAPI. Esta prueba local no necesita conectar WhatsApp, Telegram ni otro canal.

Revisa la configuración activa

Si un ajuste parece ignorado, comprueba si models.json del agente sobrescribe ese proveedor. Si la autenticación solo falla en el servicio, revisa su entorno. Si el texto funciona pero las herramientas fallan, revisa el modelo y la política actual. No inventes límites de contexto ni costes cero para aceptar la entrada.

Para recuperar la conexión anterior, selecciona el modelo previo y restaura solo los ajustes del proveedor que cambiaste.

Referencias

Temas inspirados en documentación pública; instrucciones y ejemplos adaptados para MandAPI.