Guía de configuración de OpenClaw 2026: de cero a un agente de IA en 15 minutos

OpenClaw es el agente de IA autónomo de código abierto más popular, con más de 68 000 estrellas en GitHub y un ecosistema de skills con más de 13 000 extensiones. Esta guía te lleva desde una máquina recién instalada hasta un agente de IA completamente configurado y conectado a un canal en 15 minutos.

No se requiere experiencia previa con OpenClaw. Si sabes usar una terminal, puedes seguir esta guía.

Tabla de contenidos

1. Requisitos previos
2. Paso 1: instala OpenClaw
3. Paso 2: ejecuta el asistente de incorporación
4. Paso 3: configura tu proveedor de LLM
5. Paso 4: conecta tu primer canal
6. Paso 5: instala tus primeras skills
7. Paso 6: prueba tu agente
8. Problemas comunes y soluciones
9. Próximos pasos
10. Preguntas frecuentes

Requisitos previos {#prerequisites}

Antes de empezar, asegúrate de tener lo siguiente:

Obligatorio

• Node.js 22 o posterior: OpenClaw requiere Node.js 22+ para su runtime.

  # Check your version
  node --version
  # Should output v22.x.x or higher
  
  # Install via nvm (recommended)
  nvm install 22
  nvm use 22
  
  # Or install via Homebrew (macOS)
  brew install node@22
  

• Una clave de API de LLM: Necesitas una clave de API de al menos un proveedor:

  • Anthropic (Claude) — recomendado
  • OpenAI (GPT-4o)
  • Google AI Studio (Gemini)

Opcional (pero recomendado)

• Un token de bot de Telegram: para conectar tu primer canal (el más fácil de configurar)
• Una clave de API de Inbounter: para capacidades de correo electrónico y SMS — regístrate en inbounter.com

Requisitos del sistema

Paso 1: instala OpenClaw {#step-1}

Abre tu terminal e instala OpenClaw globalmente a través de npm:

npm install -g openclaw@latest

Esto instala el comando openclaw globalmente. Verifica la instalación:

openclaw --version

Deberías ver una salida como:

openclaw v2.4.1

Métodos de instalación alternativos

Con yarn:

yarn global add openclaw@latest

Con pnpm:

pnpm add -g openclaw@latest

Desde el código fuente (para contribuidores):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm link

Paso 2: ejecuta el asistente de incorporación {#step-2}

OpenClaw incluye un asistente de incorporación interactivo que te guía por la configuración inicial:

openclaw onboard --install-daemon

El flag --install-daemon instala el demonio en segundo plano que permite que OpenClaw se ejecute de forma persistente y responda a mensajes en todos los canales incluso cuando cierras tu terminal.

Qué hace el asistente

1. Crea el directorio de configuración: ~/.openclaw/ con archivos de configuración predeterminados
2. Solicita tu proveedor de LLM: selecciona Anthropic, OpenAI, Google o un modelo local
3. Almacena tu clave de API: cifrada en ~/.openclaw/credentials.json
4. Instala el demonio (si usas el flag): registra un servicio del sistema que arranca al iniciar
5. Ejecuta una prueba rápida: envía un prompt simple para verificar que tu clave de API funciona

La salida del asistente se ve más o menos así:

Welcome to OpenClaw! Let's get you set up.

? Select your LLM provider: Anthropic (Claude)
? Enter your Anthropic API key: sk-ant-••••••••••••
? Install background daemon? Yes

✔ Configuration saved to ~/.openclaw/config.yaml
✔ API key verified — Claude is responding
✔ Daemon installed and started

OpenClaw is ready! Try: openclaw run "What can you do?"

Paso 3: configura tu proveedor de LLM {#step-3}

Si quieres cambiar o ajustar tu configuración de LLM después de la incorporación, usa el comando config:

# View current config
openclaw config show

# Change model
openclaw config set model claude-sonnet-4-20250514

# Switch provider
openclaw config set provider openai
openclaw config set api_key sk-your-openai-key
openclaw config set model gpt-4o

Modelos recomendados según el caso de uso

Uso de modelos locales

Para modelos locales, primero instala Ollama:

# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Pull a model
ollama pull llama3.3

# Configure OpenClaw
openclaw config set provider ollama
openclaw config set model llama3.3

Nota: los modelos locales son significativamente menos capaces que los modelos en la nube para tareas agénticas complejas. Úsalos para automatización sencilla y escenarios sensibles a la privacidad.

Paso 4: conecta tu primer canal {#step-4}

Los canales permiten que OpenClaw se comunique a través de plataformas externas. Recomendamos empezar con Telegram porque su configuración es la más sencilla.

Opción A: Telegram (primer canal recomendado)

Crea un bot de Telegram:

1. Abre Telegram y busca @BotFather
2. Envía /newbot
3. Sigue las indicaciones para nombrar tu bot
4. BotFather te da un token como 7123456789:AAF1x2y3z4...

Conéctalo a OpenClaw:

openclaw channels connect telegram --token 7123456789:AAF1x2y3z4...

Pruébalo:

1. Abre tu nuevo bot en Telegram
2. Envíale un mensaje: "Hola, ¿qué puedes hacer?"
3. OpenClaw debería responder en unos segundos

Opción B: Slack

# Requires a Slack Bot Token (starts with xoxb-)
# Create one at https://api.slack.com/apps
openclaw channels connect slack --token xoxb-your-slack-bot-token

Opción C: Discord

# Requires a Discord Bot Token
# Create one at https://discord.com/developers/applications
openclaw channels connect discord --token your-discord-bot-token

Verifica las conexiones

openclaw channels list

Salida:

Connected channels:
  telegram  @YourBotName        ✔ active
  slack     YourWorkspace       ✔ active

Paso 5: instala tus primeras skills {#step-5}

Las skills amplían las capacidades de OpenClaw. De fábrica, OpenClaw puede conversar y razonar. Las skills le permiten actuar: navegar por la web, enviar correos, generar imágenes y miles de cosas más.

Skills iniciales recomendadas

1. Navegación web

openclaw skills install web-browser

Le da a OpenClaw la capacidad de visitar URLs, leer páginas web, hacer clic en enlaces, rellenar formularios y extraer contenido. Esencial para tareas de investigación y recopilación de datos.

2. Gog (búsqueda)

openclaw skills install gog

Añade capacidad de búsqueda web. OpenClaw puede buscar información actual, encontrar documentación, buscar mensajes de error y mucho más.

3. Inbounter (correo electrónico + SMS)

openclaw skills install inbounter-email

Conecta OpenClaw a la API de correo electrónico y SMS de Inbounter. Después de la instalación, configúralo con tu clave de API de Inbounter:

openclaw skills configure inbounter-email --api-key your-inbounter-api-key

Esto le da a OpenClaw la capacidad de:

• Crear buzones de correo de forma programática
• Enviar y recibir correos electrónicos
• Gestionar conversaciones en hilos
• Enviar y recibir mensajes SMS
• Buscar mensajes con lenguaje natural (búsqueda semántica)
• Retener mensajes para revisión humana (cuarentena)

¿Por qué Inbounter para el correo electrónico? Las API de correo tradicionales como Gmail y SendGrid no fueron diseñadas para agentes de IA. Carecen de creación programática de buzones, tienen límites de tasa centrados en humanos y requieren una configuración compleja para webhooks e hilos. Inbounter está creado específicamente para flujos de trabajo de agentes. Consulta nuestro artículo sobre por qué Gmail y SendGrid no funcionan para agentes de IA para un análisis detallado.

Alternativa: conecta Inbounter mediante MCP

Si prefieres la integración con MCP en lugar de la skill de ClawHub:

openclaw config set mcp.servers.inbounter '{"type": "http", "url": "https://mcp.inbounter.com/v1", "headers": {"Authorization": "Bearer your-api-key"}}'

Verifica las skills instaladas

openclaw skills list

Salida:

Installed skills:
  web-browser       v3.1.2    ✔ active
  gog               v2.0.4    ✔ active
  inbounter-email   v1.5.0    ✔ active

Paso 6: prueba tu agente {#step-6}

Ahora que OpenClaw está instalado, configurado, conectado a un canal y equipado con skills, vamos a probarlo de principio a fin.

Prueba 1: chat básico

openclaw run "What's the weather like in San Francisco today?"

Si instalaste las skills web-browser y gog, OpenClaw debería buscar en la web y devolver información meteorológica actual.

Prueba 2: investigación web

openclaw run "Find the top 3 trending GitHub repositories this week and summarize what each one does"

OpenClaw debería usar sus skills de búsqueda y navegación web para investigar y elaborar la respuesta.

Prueba 3: correo electrónico (requiere Inbounter)

openclaw run "Create a new inbox called 'test-agent' and send a test email to myself at your@email.com"

OpenClaw debería usar la skill de Inbounter para crear un buzón y enviar el correo.

Prueba 4: chat interactivo

openclaw chat

Esto abre una sesión de chat interactiva donde puedes mantener una conversación de ida y vuelta:

You: Can you help me draft a professional email to a client about a project delay?

OpenClaw: I'd be happy to help draft that email. Let me ask a few questions:
1. What's the client's name?
2. What project is delayed?
3. How long is the delay?
4. What's the reason for the delay?

You: Client is Acme Corp, the website redesign project, delayed by 2 weeks due to design feedback taking longer than expected.

OpenClaw: Here's a draft:

Subject: Update on Website Redesign Timeline

Dear Acme Corp team,

I wanted to provide you with an update on the website redesign project...
[draft continues]

Shall I send this via email, or would you like to modify it first?

Prueba 5: prueba de canal

Envía un mensaje a tu bot de Telegram (o al canal que hayas conectado):

Can you search for the latest news about AI agents and give me a 3-bullet summary?

OpenClaw debería responder directamente en Telegram en unos segundos.

Problemas comunes y soluciones {#common-issues}

"command not found: openclaw"

Causa: el directorio bin global de npm no está en tu PATH.

Solución:

# Find where npm installs global packages
npm config get prefix

# Add to your PATH (add to ~/.zshrc or ~/.bashrc)
export PATH="$(npm config get prefix)/bin:$PATH"

# Reload shell
source ~/.zshrc

"Error: Could not connect to LLM provider"

Causa: clave de API no válida o problema de red.

Solución:

# Verify your API key
openclaw config show | grep api_key

# Test the key directly
openclaw run "Say hello" --verbose

Si la clave es correcta, comprueba tu conexión de red y la configuración del firewall. Algunas redes corporativas bloquean los endpoints de la API.

"Daemon failed to start"

Causa: conflicto de puerto o problema de permisos.

Solución:

# Check if another process is using the daemon port
lsof -i :3458

# Restart the daemon
openclaw daemon stop
openclaw daemon start --verbose

# If permissions issue on Linux
sudo openclaw daemon install

"Skill installation failed"

Causa: problema de red o versión de Node.js incompatible.

Solución:

# Verify Node.js version
node --version  # Must be 22+

# Clear skill cache and retry
openclaw skills cache clear
openclaw skills install web-browser --verbose

"Telegram bot not responding"

Causa: el demonio no se está ejecutando, o el token del bot no es válido.

Solución:

# Check daemon status
openclaw daemon status

# Check channel connection
openclaw channels list

# Reconnect with verbose output
openclaw channels disconnect telegram
openclaw channels connect telegram --token YOUR_TOKEN --verbose

"Rate limit exceeded" del proveedor de LLM

Causa: demasiadas solicitudes a la API del LLM.

Solución: configura la limitación de tasa en OpenClaw:

openclaw config set rate_limit.requests_per_minute 30
openclaw config set rate_limit.retry_delay_seconds 5

Para Anthropic, consulta tu panel de uso para ver los límites de tu nivel actual.

Próximos pasos {#next-steps}

Enhorabuena. Tienes un agente de IA funcionando. Esto es lo que sigue:

1. Explora ClawHub

Navega por el marketplace de ClawHub en busca de skills que se ajusten a tus casos de uso. Con más de 13 729 skills disponibles, es casi seguro que hay algo relevante para tu flujo de trabajo.

openclaw skills search "your use case here"

2. Conecta más canales

Añade Slack, Discord o WhatsApp para darle a tu agente alcance multicanal. Consulta la documentación de canales para ver guías de configuración de cada plataforma.

3. Configura tareas programadas

Automatiza tareas recurrentes:

# Check email every 5 minutes and summarize new messages
openclaw schedule create --cron "*/5 * * * *" --task "Check my Inbounter inbox and summarize any new emails"

# Daily standup summary at 9 AM
openclaw schedule create --cron "0 9 * * 1-5" --task "Compile yesterday's Slack messages from #engineering and create a standup summary"

4. Configura correo electrónico y SMS con Inbounter

Si aún no lo has hecho, regístrate en Inbounter e instala la skill. El correo electrónico y el SMS están entre las capacidades de mayor impacto para un agente de IA, ya que permiten comunicación con clientes, notificaciones y seguimientos automatizados.

5. Crea una skill personalizada

Si ClawHub no tiene lo que necesitas, créala tú mismo. La guía de desarrollo de skills recorre el proceso paso a paso.

6. Únete a la comunidad

• Discord: discord.gg/openclaw — más de 25 000 miembros
• GitHub: github.com/openclaw/openclaw — dale una estrella al repo, reporta problemas, contribuye
• Foro: community.openclaw.ai — debates y tutoriales más extensos

Referencia de configuración

Aquí tienes una referencia rápida de las opciones de configuración más utilizadas:

# ~/.openclaw/config.yaml

# LLM Settings
provider: anthropic          # anthropic, openai, google, ollama
model: claude-sonnet-4-20250514  # Model identifier
api_key: sk-ant-...          # Stored encrypted

# Daemon Settings
daemon:
  enabled: true
  port: 3458
  auto_start: true

# Rate Limiting
rate_limit:
  requests_per_minute: 60
  retry_delay_seconds: 2

# Permissions
permissions:
  mode: ask_sensitive        # always_ask, ask_sensitive, autonomous
  sensitive_actions:
    - send_email
    - delete_file
    - execute_command

# Logging
logging:
  level: info                # debug, info, warn, error
  file: ~/.openclaw/logs/openclaw.log

# MCP Servers
mcp:
  servers:
    inbounter:
      type: http
      url: https://mcp.inbounter.com/v1

Preguntas frecuentes {#faq}

¿Cuánto tarda la instalación?

Unos 2-3 minutos para la instalación de npm y el asistente de incorporación. Añadir canales y skills lleva otros 5-10 minutos. Total: menos de 15 minutos.

¿Puedo instalar OpenClaw en un servidor?

Sí. OpenClaw funciona en cualquier máquina con Node.js 22+. Para instalaciones en servidor, usa el modo demonio y omite las conexiones de canal que requieren interacción gráfica (como el escaneo del código QR de WhatsApp). Telegram y Slack funcionan sin interfaz gráfica.

¿Necesito un plan de pago de la API de un LLM?

La mayoría de los proveedores ofrecen niveles gratuitos o créditos para cuentas nuevas. Anthropic ofrece 5 USD en créditos gratuitos. OpenAI ofrece créditos gratuitos para cuentas nuevas. La API de Gemini de Google tiene un nivel gratuito generoso. Puedes empezar sin gastar dinero.

¿Puedo usar varios proveedores de LLM?

Sí. Puedes configurar un proveedor principal y proveedores de respaldo:

openclaw config set provider anthropic
openclaw config set fallback_providers openai,google

Si el proveedor principal está caído o limitado por tasa, OpenClaw cambia automáticamente al de respaldo.

¿Mis datos están seguros?

OpenClaw se ejecuta localmente. Tus claves de API se almacenan cifradas en tu máquina. Las conversaciones las procesa el proveedor de LLM que elijas (sujeto a su política de privacidad) pero no las almacena la infraestructura de OpenClaw. Para máxima privacidad, usa un modelo local mediante Ollama.

¿Cómo actualizo OpenClaw?

npm update -g openclaw

O para una instalación limpia:

npm install -g openclaw@latest

¿Puedo ejecutar varias instancias de OpenClaw?

Sí, pero cada instancia necesita su propio directorio de configuración y puerto de demonio. Usa el flag --config-dir:

openclaw --config-dir ~/.openclaw-work onboard
openclaw --config-dir ~/.openclaw-personal onboard

¿Dónde puedo encontrar más documentación?

• Documentación oficial: docs.openclaw.ai
• Guía de freeCodeCamp: busca "OpenClaw tutorial freeCodeCamp" para tutoriales escritos por la comunidad
• Tutorial de DigitalOcean: cubre el despliegue basado en servidor en droplets de DigitalOcean

Artículos relacionados

• ¿Qué es OpenClaw? La guía completa para principiantes
• Por qué Gmail y SendGrid no funcionan para agentes de IA
• Webhooks de correo electrónico para agentes de IA: guía completa para desarrolladores
• Primeros pasos con Inbounter