Este artículo está dirigido a usuarios sin experiencia previa, explicando en detalle el proceso de despliegue de OpenClaw (Clawdbot) en servidores ligeros y sistemas locales Windows 11, macOS y Linux. Incluye configuración de entorno, inicio de servicios, integración de Skills, API de Alibaba Cloud BaiLian y métodos de acceso a modelos de lenguaje grandes gratuitos, además de proporcionar respuestas unificadas a preguntas comunes durante el despliegue y uso. Todas las operaciones son directamente reproducibles.
OpenClaw (anteriormente conocido como Clawdbot) es un marco de trabajo de agente inteligente que puede implementarse localmente, soporta la ejecución de tareas, tiene capacidades de memoria y un mecanismo de extensión mediante plugins. Los usuarios pueden dar instrucciones en lenguaje natural y el sistema completará operaciones prácticas como gestión de archivos, recuperación de información, procesamiento de contenido y automatización de flujos de trabajo. A través de Skills, se pueden extender más funcionalidades. Su funcionamiento depende del entorno Node.js, admite ejecución continua en servidores en la nube y sin conexión en dispositivos locales, y los datos pueden almacenarse preferiblemente localmente, ofreciendo buen control y privacidad.
Requisitos de Dependencias Comunes
- Sistema operativo: Windows 11, macOS 12 o superior, Linux (Ubuntu/Debian/CentOS, etc.)
- Entorno de ejecución: Node.js 22.x o versiones posteriores
- Herramientas: Terminal o PowerShell, editor de texto
- Red: Acceso normal a redes externas para instalación de dependencias y descarga del programa
Comandos de Verificación del Entorno
node -v
npm -v
Si se muestra un número de versión, el entorno está disponible. Si aparece un mensaje de "comando no encontrado", primero debe completarse la instalación de Node.js.
En esta sección, se utiliza como ejemplo el servidor de aplicaciones ligero de Alibaba Cloud con el sistema Alibaba Cloud Linux 3, proporcionando pasos de despliegue directamente copiables.
1. Configuración Básica del Servidor
- Especificación de instancia: 1 núcleo con 2 GB de memoria o superior, disco del sistema de 40 GB o más
- Puertos permitidos en el grupo de seguridad: 18789 (puerto predeterminado de la consola web)
- Método de inicio de sesión: Terminal web o herramienta SSH
- Cuenta de Alibaba Cloud: Registre una cuenta en Alibaba Cloud y complete la verificación de identidad
- Selección de modelo de lenguaje: Suscríbase al plan de codificación de Alibaba Cloud BaiLian
Guía Paso a Paso para Usuarios sin Experiencia en Alibaba Cloud
Paso 1: Abra la página temática de despliegue con un clic de OpenClaw en Alibaba Cloud y busque y haga clic en 【**Comprar y Desplegar con un Clic**】.
Paso 2: Abra la selección del servidor de aplicaciones ligero de Alibaba Cloud con la siguiente configuración de referencia:
- Imagen: Imagen OpenClaw (Moltbot) (los usuarios que ya han comprado servidores pueden restablecer el sistema para seleccionar la imagen)
- Instancia: La memoria debe ser de 2 GiB o superior.
- Región: Predeterminado en Virginia (EE.UU.). Actualmente, los servidores de aplicaciones ligeras en regiones de China continental (excepto Hong Kong) tienen funcionalidades de búsqueda en línea limitadas.
- Duración: Elija según sus necesidades y presupuesto.
Paso 3: Abra la consola de modelos de lenguaje grandes de Alibaba Cloud BaiLian, busque la gestión de claves y haga clic en Crear API-Key.
Vaya a la consola del servidor de aplicaciones ligero, encuentre la instancia con OpenClaw instalada, ingrese a 'Detalles de la aplicación', permita el puerto 18789, configure la API-Key de BaiLian y ejecute comandos para generar el token de acceso a OpenClaw.
- Permitir puerto: Es necesario permitir el firewall del puerto correspondiente, haga clic en Permitir con un clic.
- Configurar API-Key de BaiLian: haga clic en Configurar con un clic, ingrese la API-Key de BaiLian. Haga clic en ejecutar comando para escribir la API-Key.
- Configurar OpenClaw: haga clic en ejecutar comando para generar el token de acceso a OpenClaw.
- Acceder a la página de control: haga clic en Abrir página web para ingresar a la página de diálogo de OpenClaw.
2. Actualización del Sistema e Instalación de Dependencias
sudo yum update -y
sudo yum install -y curl git
3. Instalación de Node.js 22
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local
sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node
sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm
4. Configuración del Mirror de npm
npm config set registry https://registry.npmmirror.com
5. Instalación de OpenClaw
npm install -g openclaw
6. Inicialización de Configuración
openclaw onboard
Complete la inicialización según las indicaciones: acepte el acuerdo, elija inicio rápido, omita temporalmente la configuración del modelo, habilite todos los canales.
7. Configuración de Acceso Público a Internet
openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.port 18789
8. Inicio del Servicio
openclaw gateway start
9. Acceso a la Consola Web
Abra el navegador en:
http://IP_pública_del_servidor:18789
10. Configuración de Inicio Automático al Arrancar
echo "/usr/bin/openclaw gateway start" | sudo tee -a /etc/rc.local
sudo chmod +x /etc/rc.local
1. Flujo de Despliegue en macOS
# Instalar Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Instalar Node.js
brew install node
# Configurar mirror
npm config set registry https://registry.npmmirror.com
# Instalar OpenClaw
npm install -g openclaw
# Inicializar
openclaw onboard
# Iniciar servicio
openclaw gateway start
Dirección de acceso: http://127.0.0.1:18789
2. Flujo de Despliegue en Linux (Ubuntu/Debian)
sudo apt update
sudo apt install -y curl git nodejs npm
sudo npm install -g n
sudo n stable
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start
3. Flujo de Despliegue en Windows 11
Abra PowerShell como administrador:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# Instalar Node.js
winget install OpenJS.NodeJS --version 22.0.0
# Configurar mirror
npm config set registry https://registry.npmmirror.com
# Instalar OpenClaw
npm install -g openclaw
# Inicializar
openclaw onboard
# Iniciar servicio
openclaw gateway start
Dirección de acceso: http://127.0.0.1:18789
Los Skills son módulos de extensión de funcionalidad de OpenClaw, utilizados para lograr capacidades extendidas como búsqueda, operación de navegador, resumen de contenido, gestión de archivos, automatización, etc. Los usuarios sin experiencia pueden seguir los siguientes pasos para instalar y habilitar.
1. Instalación de la Herramienta de Gestión de Skills
npm install -g skill-manager
2. Comandos de Instalación de Skills Comunes
# Búsqueda en línea
skill-manager install web-search
# Operación de navegador
skill-manager install browser-controller
# Resumen de contenido
skill-manager install content-summarizer
# Auditoría de seguridad
skill-manager install security-checker
# Recordatorios activos
skill-manager install notification-assistant
# Gestión de base de conocimiento
skill-manager install knowledge-manager
3. Formato General de Instalación de Skills
skill-manager install <nombre_del_skill></nombre_del_skill>
4. Verificación de Skills Instalados
openclaw skill list
5. Inicio/Reinicio de Skills
openclaw skill start <nombre_del_skill>
openclaw skill restart <nombre_del_skill></nombre_del_skill></nombre_del_skill>
6. Verificación del Estado de Skills
openclaw skill status <nombre_del_skill></nombre_del_skill>
7. Carga Efectiva de Skills
Después de instalar todos los Skills, reinicie el servicio de gateway para cargar:
openclaw gateway restart
OpenClaw necesita conectarse a la API de un modelo de lenguaje grande para completar tareas de comprensión y generación. En esta sección se proporcionan métodos de acceso al plan de codificación de Alibaba Cloud BaiLian y modelos gratuitos generales.
1. Configuración de API del Plan de Codificación de BaiLian de Alibaba Cloud
(1) Obtención de Claves
- Inicie sesión en la plataforma de servicios de modelos de lenguaje grandes de Alibaba Cloud BaiLian
- Ingrese a la consola - Gestión de claves, cree API Key y Access Key Secret
- Verifique el límite de llamadas gratuito
(2) Modificación del Archivo de Configuración
Ruta del archivo de configuración:
- macOS/Linux: ~/.openclaw/config.json
- Windows: C:\\Users\\nombre_de_usuario\\.openclaw\\config.json
Escriba la configuración:
"model": {
"type": "aliyun-bailian",
"api_key": "su_APIKey",
"secret": "su_SecretAccessKey",
"model_name": "qwen-7b-chat",
"max_tokens": 2048,
"temperature": 0.7,
"timeout": 30,
"reasoning": false
}
(3) Reinicio del Servicio
openclaw gateway restart
2. Configuración de Modelos de Lenguaje Grandes Gratuitos Generales
"model": {
"type": "openai",
"api_key": "API_Key_Gratuito",
"base_url": "URL_de_la_Interfaz_Gratuita",
"model_name": "gpt-3.5-turbo",
"max_tokens": 2048,
"temperature": 0.7
}
La modificación surte efecto después de reiniciar el servicio.
1. Problemas de Despliegue e Inicio
-
Mensaje
openclaw: comando no encontrado- Ejecute nuevamente:
npm install -g openclaw - Cierre y abra nuevamente la terminal
- Verifique si Node.js está instalado correctamente
- Ejecute nuevamente:
-
El servicio se cierra automáticamente después de iniciar
- Memoria insuficiente, se recomienda ≥2GB para servidores, cierre programas que consumen recursos en local
- Ejecute
openclaw logspara ver los registros de errores
-
No se puede acceder a la consola web
- Verifique si el servicio está iniciado:
openclaw gateway status - El servidor debe permitir el puerto 18789 en el grupo de seguridad
- Acceso local: http://127.0.0.1:18789
- Reinicie el servicio:
openclaw gateway restart
- Verifique si el servicio está iniciado:
-
Puerto en uso
Linux/macOS:
lsof -i:18789 kill -9 ID_del_procesoWindows:
netstat -ano | findstr "18789" taskkill /F /PID ID_del_proceso
2. Problemas de Instalación y Uso de Skills
-
El comando
skill-managerno está disponible- Ejecute:
npm install -g skill-manager
- Ejecute:
-
Fallo en la instalación del Skill
- Cambie el mirror de npm:
npm config set registry https://registry.npmmirror.com - Ejecute nuevamente el comando de instalación
- Cambie el mirror de npm:
-
El Skill instalado no tiene efecto
- Reinicie el gateway:
openclaw gateway restart - Verifique el estado del Skill:
openclaw skill list
- Reinicie el gateway:
3. Problemas de Conexión de API del Modelo
-
Fallo en la llamada al modelo, permisos insuficientes
- Verifique si la API Key es correcta
- Confirme que la cuenta ha completado la verificación de identidad
- Confirme que el límite de llamadas es suficiente
- El nombre del modelo está escrito correctamente
-
La respuesta de IA está vacía
- Agregue en la configuración del modelo:
"reasoning": false - Reinicie el servicio
- Agregue en la configuración del modelo:
-
Tiempo de espera en la respuesta
- Aumente el valor de timeout: 30→60
- Disminuya max_tokens: 2048→1024
- Verifique la conectividad de la red
4. Problemas de Sistema y Permisos
-
Mensaje de permisos insuficientes en Linux/macOS
sudo npm install -g openclaw -
La política de ejecución en Windows prohíbe la ejecución de scripts
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -
No se puede escribir en el archivo de configuración
- Verifique los permisos de lectura y escritura del directorio para el usuario actual
- Reinicialice:
openclaw onboard --reset
- Inicie el servicio:
openclaw gateway start - Abra el navegador e ingrese a la consola
- Ingrese instrucciones en lenguaje natural para ejecutar tareas
- Extienda funcionalidades a través de Skills
- Verifique los registros:
openclaw logs --follow