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 sudo o 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.
WhatsApp 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_URL y OPENAI_BASE_URL. El script añadirá un proveedor custom al archivo JSON.
  • Memoria y Acceso a Archivos – Por defecto, enable_shell_commands y enable_file_access son false. Puedes habilitarlos en la sección security para permitir que el asistente ejecute comandos de shell o lea/escriba archivos.
  • Modo Sandbox – Establece sandbox_mode: true para 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!

Artículo original: Ver original

Compartir este artículo