Domina OpenClaw AI desde cero.
Ya seas un principiante curioso o un desarrollador experimentado, esta guía interactiva te llevará paso a paso para instalar, configurar y desplegar agentes autónomos. Descubre cómo potenciar tu IA con Skills y automatizar tu trabajo.
¿Qué es OpenClaw AI?
OpenClaw AI es un framework de código abierto diseñado para crear, gestionar y desplegar agentes de inteligencia artificial autónomos.
A diferencia de chatbots como ChatGPT o Claude, OpenClaw tiene "garras" (claws): puede interactuar directamente con tu computadora — abrir el navegador, hacer clics, escribir código, guardarlo y ejecutarlo.
La diferencia clave
Chatbot normal: "Aquí tienes el código." (Tú debes copiarlo, guardarlo y ejecutarlo).
OpenClaw AI: "He creado el script, lo guardé, lo ejecuté, encontré el error, lo corregí, y aquí tienes el resultado final."
Navegación Autónoma
Interactúa con el navegador, hace clics, llena formularios y extrae datos de cualquier sitio.
Ejecución de Código
Escribe, depura y ejecuta scripts en Python, Node.js y Bash directamente.
Agnóstico de Modelos
Usa Gemini, OpenAI, Anthropic o modelos locales gratuitos en tu PC.
Conceptos Básicos para Principiantes
Si es tu primera vez trabajando con herramientas de desarrollo o IA avanzada, aquí tienes un glosario rápido.
Terminal / Consola
Una pantalla donde escribes comandos de texto. En Windows se llama PowerShell; en Mac/Linux, Terminal.
API Key (Clave API)
Una contraseña secreta que te dan empresas como Google o OpenAI para que OpenClaw se conecte a sus modelos de IA.
¡Nunca compartas tu API Key con nadie!
Variables de Entorno (.env)
Archivo oculto donde guardas configuraciones secretas como tu API Key. OpenClaw lo lee al iniciarse.
Docker (Contenedores)
Una "caja fuerte" virtual dentro de tu PC. Si la IA comete un error en Docker, no afecta tu sistema real.
Riesgos y Seguridad
OpenClaw AI no es un simple generador de texto; es un agente con capacidad de acción real en tu sistema. Lee esto antes de instalarlo.
Ejecución de Código Arbitrario
El agente puede ejecutar comandos de terminal, crear, modificar o borrar archivos.
Solución: Nunca lo ejecutes con permisos de administrador (root). Usa Docker o una Máquina Virtual.
Exposición de Claves Privadas
Con acceso al sistema de archivos raíz, el agente podría leer tus archivos .env o claves bancarias.
Solución: Ejecuta OpenClaw solo en carpetas específicas (Workspaces) y usa el archivo .clawignore.
Costos de API Inesperados
Los agentes pueden entrar en bucles infinitos, consumiendo tokens rápidamente.
Solución: Configura MAX_STEPS=15 en tu .env para que se detenga automáticamente.
Guía de Instalación
Sigue estos pasos para tener OpenClaw AI corriendo en tu máquina en menos de 5 minutos.
Requisitos Previos
- Motor que ejecuta el código principal de OpenClaw.
- Necesario para scripts de análisis de datos.
- Para descargar el código fuente desde GitHub.
- Recomendamos Google Gemini (gratis para empezar).
1 Clonar e Instalar
Abre tu terminal y copia los comandos según tu sistema operativo.
# 1. Instalar Homebrew (si no lo tienes)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. Instalar dependencias
brew install python node git
# 3. Clonar el repositorio
git clone https://github.com/openclaw/openclaw.ai.git
cd openclaw.ai
# 4. Instalar paquetes de Node
npm install
# 5. Configurar variables de entorno
cp .env.example .env2 Configuración de Entorno (.env)
El paso anterior creó un archivo .env. Ábrelo con tu editor y añade tu API Key.
# Archivo: .env
# Pega aquí tu clave de Google AI Studio (Gemini)
GEMINI_API_KEY="AIzaSyTuClaveSecretaAqui..."
# Opcional: Si prefieres usar OpenAI (ChatGPT)
# OPENAI_API_KEY="sk-proj-TuClaveSecretaAqui..."
# Carpeta donde el agente guardará sus archivos
WORKSPACE_DIR="./workspace"
# Número máximo de intentos antes de rendirse
MAX_STEPS=15
# Permite que el agente ejecute comandos en la terminal
ALLOW_SHELL_EXECUTION=true3 Iniciar el Agente
Vuelve a tu terminal y ejecuta el comando de inicio.
npm run start¡Felicidades! Si ves el logo de OpenClaw en tu terminal, ya puedes escribirle tareas. Prueba con: Crea un archivo llamado hola.txt que diga 'Hola Mundo'
Skills (Habilidades)
La verdadera magia de OpenClaw radica en sus Skills — herramientas o "superpoderes" que le añades al agente.
¿Cómo funcionan las Skills?
Una Skill es un archivo de código en la carpeta /skills que define una función específica. El agente revisa su "caja de herramientas" y decide cuál usar.
Skills preinstaladas:
Creando tu propia Skill
Por ejemplo, si quieres que el agente envíe mensajes por Slack:
export const SlackSkill = {
name: "send_slack_message",
description: "Envía un mensaje a un canal de Slack",
parameters: {
channel: "string (ej: #general)",
message: "string"
},
execute: async (args) => {
await slackClient.chat.postMessage({
channel: args.channel,
text: args.message
});
return "Mensaje enviado con éxito";
}
};Ejemplos de Uso (Prompts)
¿No sabes qué pedirle? Aquí tienes ejemplos desde lo más básico hasta flujos avanzados.
Básico (Gestión de Archivos)
"Crea una carpeta llamada "proyecto_web". Dentro, crea un index.html con estructura HTML5 y un styles.css con fondo oscuro."
"Lee el archivo "lista_compra.txt", ordénalo alfabéticamente y guárdalo como "lista_ordenada.txt"."
Intermedio (Investigación y Análisis)
"Busca en internet las últimas 5 noticias sobre Inteligencia Artificial, haz un resumen de cada una y guárdalo en noticias_ia.md"
"Crea un script en Python que lea datos.csv, genere un gráfico de barras con matplotlib y guarde la imagen como grafico.png."
Avanzado (Desarrollo y DevOps)
"Revisa todos los archivos .js en /src, elimina funciones no utilizadas, ejecuta npm test y si pasan haz un commit con el mensaje "Limpieza de código"."
"Tengo un error "CORS policy" en Express.js. Revisa server.js, instala cors si es necesario, arregla el código y reinicia el servidor."
Consejos Pro y Optimización
Para dominar OpenClaw AI, aplica estas estrategias utilizadas por desarrolladores expertos.
1. System Prompts (Perfiles)
El "System Prompt" es la instrucción base. Crea perfiles específicos en la carpeta /prompts para diferentes tareas (scraping, análisis, etc.).
{
"role": "Senior Scraper",
"rules": [
"No usar regex para HTML",
"Respetar robots.txt",
"Devolver JSON"
]
}2. Human-in-the-Loop (HITL)
Activa REQUIRE_APPROVAL=true en tu .env. Esto pausa la ejecución antes de comandos destructivos como "git push" o "rm -rf" y espera tu confirmación.
3. Ventana de Contexto
La IA tiene memoria limitada. Si le pides leer 50 archivos a la vez, se "olvidará" del objetivo. Usa el comando /clear periódicamente para empezar limpio.
4. Modelos Locales (Gratis y Privados)
Para código confidencial, conecta OpenClaw a modelos locales usando Ollama o LM Studio. Solo cambia la URL de la API en .env.
Preguntas Frecuentes
Nota: Google AI Studio ofrece una capa gratuita muy generosa para desarrolladores.