Cómo Desplegar OpenClaw: Configuración del Asistente IA de Un Solo Clic
Despliegue de OpenClaw – La Guía Definitiva de Asistente AI de Un Solo Clic
OpenAI, Anthropic, Google Gemini, Groq, Mistral, Ollama – todos los grandes LLM ahora pueden comunicarse contigo a través de la misma puerta de enlace ligera. OpenClaw, un proyecto de código abierto lanzado bajo la licencia MIT, incluye la puerta de enlace, una interfaz de línea de comandos rica y un gestor de escritorio opcional impulsado por Tauri. El repositorio OpenClawInstaller en GitHub te ofrece un script listo para ejecutar que detecta tu SO, instala dependencias, descarga los binarios más recientes de OpenClaw, conecta tu modelo y canales de chat preferidos, y lanza el servicio.
¿Por qué OpenClaw? * Instalación de CLI con un solo clic en macOS, Linux e incluso Windows vía WSL * Soporte plug‑and‑play para Telegram, Discord, WhatsApp, WeChat, Slack, Feishu, iMessage – no se requiere código del lado del servidor * Ejecuta casi cualquier LLM importante, localmente con Ollama o a través de API, con soporte de proxy personalizado * Memoria persistente a largo plazo, tareas programadas, ejecución remota de comandos y extensiones basadas en habilidades escritas en Markdown * Compatible con Docker para que puedas contenerizar la puerta de enlace y lograr aislamiento y escalabilidad
A continuación, encontrarás una guía paso a paso, desde los requisitos previos hasta la configuración avanzada.
1. Requisitos Previos
| Requisito | Mínimo | Recomendado |
|---|---|---|
| SO | macOS 12+, Ubuntu 20.04, Debian 11, CentOS 8 | — |
| Node.js | v22+ | — |
| RAM | 2 GB | 4 GB+ |
| Espacio en disco | 1 GB | — |
| Red | HTTPS/HTTP | — |
Consejo: Si empleas una instancia de nube gestionada, considera una VM con 2‑CPU, 4 GB RAM. Docker añade ~500 MB de sobrecarga.
2. Instalación de CLI con Un Solo Clic
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
El script hará lo siguiente: 1. Detecta tu SO e instala los paquetes necesarios (Node, Docker si corresponde). 2. Descarga los binarios pre‑compilados de la última versión de OpenClaw. 3. Ejecuta el asistente config‑menu.sh para guiarte a través de: * Selección del proveedor y modelo LLM * Provisión de claves API o elección de un modelo local (Ollama) * Configuración de tus canales de mensajería 4. Opcionalmente lanza la puerta de enlace como servicio en segundo plano.
Nota de seguridad: Si te encuentras con errores de permisos en macOS, intenta ejecutar
sudoo concede acceso completo al terminal.
3. Clonar Manualmente y Configurar
Si prefieres revisar el código fuente o usar un Docker Compose personalizado, sigue estos comandos:
# Clonar el repositorio
git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller
# Hacer los scripts ejecutables
chmod +x install.sh config-menu.sh
# Ejecutar el instalador
./install.sh
Despliegue Docker opcional:
docker compose up -d
La imagen Docker descarga el binario openclaw y expone el puerto 8000 para la API de la puerta de enlace.
4. Configuración Rápida
Tras la instalación, el instalador generalmente pregunta si deseas iniciar la puerta de enlace inmediatamente. Si respondes afirmativamente, verás una página de estado: openclaw gateway status. Si no, arráncala manualmente con:
# En primer plano (para depuración)
openclaw gateway
# O como demonio
openclaw gateway start
Configuración de Canales de Mensajería
El asistente (config‑menu.sh) expone un menú bajo Canales de Mensajería:
| Canal | Pasos de Configuración |
|---|---|
| Telegram | Crea un bot mediante @BotFather, copia el token, obtiene el ID de usuario con @userinfobot; ingresa el token y el ID en OpenClaw. |
| Discord | Crea un bot, habilita Intención de Contenido Mensajes, invita al bot al servidor; copia el token y el ID del canal. |
| Escanea el código QR en el terminal – no se requiere la API de Business. | |
| WeChat / iMessage | Utiliza la app de escritorio Tauri en macOS o el terminal. |
| Slack / Feishu | Proporciona tokens de aplicación o claves secretas. |
Tras la configuración, reinicia la puerta de enlace:
openclaw gateway restart
5. Configuraciones Avanzadas
La configuración global de OpenClaw reside en ~/.openclaw/openclaw.json y ~/.openclaw/env. Para la mayoría de los usuarios, el asistente lo maneja automáticamente. Si deseas afinar el comportamiento:
- Puntos finales LLM personalizados – Para proxys Anthropic o OpenAI, configura
ANALPHA_BASE_URLyOPENAI_BASE_URL. El script añadirá un proveedorcustomal archivo JSON. - Memoria y Acceso a Archivos – Por defecto,
enable_shell_commandsyenable_file_accesssonfalse. Puedes habilitarlos en la secciónsecuritypara permitir que el asistente ejecute comandos de shell o lea/escriba archivos. - Modo Sandbox – Establece
sandbox_mode: truepara aislar todas las llamadas externas.
Ajusta con la herramienta de línea de comandos:
openclaw config set security.enable_shell_commands true
openclaw config set sandbox_mode true
6. Gestión de Datos y Copias de Seguridad
# Exportar historial de chat a JSON
openclaw export --format json > conversations.json
# Limpiar memoria a largo plazo
openclaw memory clear
# Respaldar configuración y logs completos
openclaw backup
Las copias de seguridad se guardan en ~/.openclaw/backups/. También puedes controlarlas con Git si deseas un historial.
7. Desinstalación
Si necesitas limpiar:
# Detener el servicio
openclaw gateway stop
# Desinstalar el paquete npm global
npm uninstall -g openclaw
# Eliminar archivos de configuración
rm -rf ~/.openclaw
8. Checklist de Solución de Problemas
| Síntoma | Causa Probable | Solución |
|---|---|---|
| Node.js demasiado antiguo | node -v < 22 |
Instala Node 22 vía nvm o gestor de paquetes |
| La puerta de enlace no se conecta a la API | Clave API incorrecta o URL de base custom | Verifica las claves y la URL; ejecuta openclaw doctor |
| Bot de mensajería silencioso | Token del bot mal escrito o no autorizado | Re‑ejecuta la configuración del canal, asegúrate de que el bot esté invitado al servidor |
| El contenedor Docker falla | Límites de recursos demasiado bajos | Asigna más RAM o limita con -m |
| “Permiso denegado” durante la instalación | Gatekeeper de macOS | Concede acceso completo al terminal o usa sudo |
9. Recapitulación
OpenClawInstaller convierte una máquina física o una VM con Docker en un asistente AI completo en solo unos minutos. Con una instalación de un solo clic, una configuración guiada y soporte para casi todos los LLM y canales, puedes sustituir plataformas de bot externas y mantener el control total sobre tus datos y rendimiento.
Próximos pasos – Explora la aplicación de escritorio OpenClaw Manager para una vista GUI o sumérgete en el sistema de habilidades de OpenClaw añadiendo archivos Markdown personalizados en
~/.openclaw/skills/.
¡Feliz hacking y disfruta de tu asistente AI personal!