OpenClaw en Kubernetes

Un punto de partida mínimo para ejecutar OpenClaw en Kubernetes — no es un despliegue listo para producción. Cubre los recursos principales y está pensado para adaptarse a tu entorno.

¿Por qué no Helm?

OpenClaw es un solo contenedor con algunos archivos de configuración. La personalización interesante está en el contenido del agente (archivos markdown, skills, sobrecargas de config), no en la plantilla de infraestructura. Kustomize maneja overlays sin la sobrecarga de un chart de Helm. Si tu despliegue crece en complejidad, un chart de Helm puede añadirse sobre estos manifiestos.

Qué necesitas

  • Un clúster Kubernetes en ejecución (AKS, EKS, GKE, k3s, kind, OpenShift, etc.)
  • kubectl conectado a tu clúster
  • Una API key de al menos un proveedor de modelos

Inicio rápido

# Reemplaza con tu proveedor: ANTHROPIC, GEMINI, OPENAI, or OPENROUTER
export <PROVIDER>_API_KEY="..."
./scripts/k8s/deploy.sh

kubectl port-forward svc/openclaw 18789:18789 -n openclaw
open http://localhost:18789

Obtén el token del gateway y pégalo en el Control UI:

kubectl get secret openclaw-secrets -n openclaw -o jsonpath='{.data.OPENCLAW_GATEWAY_TOKEN}' | base64 -d

Para depuración local, ./scripts/k8s/deploy.sh --show-token imprime el token después del despliegue.

Para el contenido técnico completo incluyendo personalización, re-despliegue, teardown y notas de arquitectura, consulta la versión en inglés.