Saltar a contenido

Integracion OpenAI

Fecha de corte: 2026-06-01

Clasificacion

Estado actual: VERDE

Motivo: existe evidencia real de integracion funcional en el runtime de OpenClaw y no solo una dependencia declarada.

Realidad comprobada

  • openclaw models status devolvio:
  • modelo default openai/gpt-5.5
  • alias GPT -> openai/gpt-5.5
  • Configured models (1): openai/gpt-5.5
  • En la misma salida aparece:
  • profiles=1
  • provider openai
  • api_key=1
  • En el VPS existen estos archivos reales de auth y estado:
  • /opt/stacks/openclaw/config/agents/main/agent/auth-profiles.json
  • /opt/stacks/openclaw/config/agents/main/agent/auth-state.json
  • La documentacion auditada ya habia certificado:
  • openclaw agent --agent main --message "Respondé solamente: OpenClaw OK" --json con respuesta exitosa
  • openclaw models auth list --provider openai --json devolviendo openai:default

Dependencia declarada

  • .env.example del repo declara:
  • OPENCLAW_MODEL_PROVIDER=provider-name
  • OPENCLAW_MODEL_ID=model-id
  • OPENCLAW_API_KEY=replace_me
  • docs/DEPLOYMENT-RUNBOOK.md documenta el procedimiento de login por api-key para el provider openai.

Estas referencias muestran como se pensaba la integracion, pero el estado VERDE no sale de esas declaraciones sino de la evidencia viva del VPS.

Futuro posible

  • cambiar de provider o sumar otros modelos.
  • mover secretos a otro mecanismo.
  • capturar costos y uso por provider de forma mas estructurada.

Nada de eso se documenta como realidad actual porque en esta corrida no quedo comprobado.

Pendientes para validar

  • abrir, si alguna vez hace falta, el detalle interno de openclaw.json sin exponer secretos.
  • definir si se quiere una ficha separada para costo, uso y retencion de usageStats.
  • decidir si la observabilidad futura va a medir consumo OpenAI con una fuente propia o solo con artefactos de OpenClaw.

Evidencia usada

  • openclaw models status ejecutado por SSH dentro de openclaw-openclaw-gateway-1
  • docs/DEPLOYMENT-RUNBOOK.md
  • docs/PROJECT-STATE.md
  • docs/governance/services/svc-openclaw.md
  • presencia real de auth-profiles.json y auth-state.json en /opt/stacks/openclaw/config/agents/main/agent/