Guía oficial

Empieza con OpenClaw

Tu camino hacia la autonomía de IA empieza aquí. Sigue estos pasos para instalar tu agente personal.

Ir a:

1

Requisitos previos

Before you invite a space lobster into your machine, ensure you have:

Hardware

  • Mac (M1 or newer recommended)
  • Windows (WSL2 recommended)
  • Linux (Ubuntu 22.04+)
  • 8GB RAM minimum (16GB preferred)

Software

  • Node.js v20+
  • Docker (optional but recommended)
  • Git
2

Instalación

La forma mas sencilla de instalar OpenClaw es con la CLI.

bash
npx openclaw@latest init

Este comando hara lo siguiente:

  • Comprobar la compatibilidad de tu sistema
  • Descargar el motor principal de OpenClaw
  • Crear una carpeta de configuracion ~/.openclaw
  • Pedirte que elijas tu proveedor de LLM (Anthropic, OpenAI o Local)
ℹ️
Nota para usuarios de Windows: recomendamos ejecutarlo dentro de WSL2 (Ubuntu) para evitar problemas de permisos de archivos.
3

Configuracion

Una vez instalado, puedes hablar con tu agente desde la terminal:

...
bash
openclaw chat

Conectar apps de chat

Para que tu agente sea util, conectalo donde sueles estar. Ejecuta:

...
bash
openclaw connect telegram

Sigue las instrucciones para introducir tu Bot Token (lo obtienes desde BotFather en Telegram). Puedes repetirlo para Discord, Slack o WhatsApp.

4

Seguridad

⚠️
Advertencia critica: OpenClaw tiene acceso real a tu sistema.
Lee el analisis completo de riesgos de seguridad antes de continuar.
Verifica primero
Comprobacion local
Por defecto, OpenClaw usa el modo de “Pedir permiso”. Preguntará antes de ejecutar comandos o modificar archivos. No desactives esto hasta que conozcas su comportamiento.
Tus claves API se guardan en ~/.openclaw/config.yaml. Asegúrate de no compartir este archivo ni subirlo a control de versiones público.

🛠️ Resolución de problemas

Clave API inválida

Asegúrate de que tus claves (Anthropic, OpenAI, etc.) estén completas e incluyan los prefijos necesarios. Revisa ~/.openclaw/config.yaml o el .env del proyecto.

Permiso denegado (macOS)

OpenClaw necesita permisos específicos para tareas en segundo plano. Si un agente falla al ejecutar un comando, revisa Ajustes del Sistema > Privacidad y seguridad y otorga “Full Disk Access” a tu terminal.

Conflicto de versión de Node.js

El framework requiere Node.js 18+. Si ves “Module not found” o errores de sintaxis, verifica tu versión con node -v y actualiza si es necesario.

Conflictos de puerto (5173)

Si el dashboard no arranca, asegúrate de que el puerto 5173 no esté en uso por otra app Vite. Puedes forzar otro puerto en vite.config.js.