Integración de OpenClaw: Proceso de Despliegue en 3 Minutos para Principiantes en la Nube de JD en 2026

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

  1. Inicie sesión en la plataforma de servicios de modelos de lenguaje grandes de Alibaba Cloud BaiLian
  2. Ingrese a la consola - Gestión de claves, cree API Key y Access Key Secret
  3. 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

  1. Mensaje openclaw: comando no encontrado

    • Ejecute nuevamente: npm install -g openclaw
    • Cierre y abra nuevamente la terminal
    • Verifique si Node.js está instalado correctamente
  2. 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 logs para ver los registros de errores
  3. 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
  4. Puerto en uso

    Linux/macOS:

    lsof -i:18789
    kill -9 ID_del_proceso
    

    Windows:

    netstat -ano | findstr "18789"
    taskkill /F /PID ID_del_proceso
    

2. Problemas de Instalación y Uso de Skills

  1. El comando skill-manager no está disponible

    • Ejecute: npm install -g skill-manager
  2. 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
  3. El Skill instalado no tiene efecto

    • Reinicie el gateway: openclaw gateway restart
    • Verifique el estado del Skill: openclaw skill list

3. Problemas de Conexión de API del Modelo

  1. 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
  2. La respuesta de IA está vacía

    • Agregue en la configuración del modelo: "reasoning": false
    • Reinicie el servicio
  3. 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

  1. Mensaje de permisos insuficientes en Linux/macOS

    sudo npm install -g openclaw
    
  2. La política de ejecución en Windows prohíbe la ejecución de scripts

    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
    
  3. 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
  1. Inicie el servicio: openclaw gateway start
  2. Abra el navegador e ingrese a la consola
  3. Ingrese instrucciones en lenguaje natural para ejecutar tareas
  4. Extienda funcionalidades a través de Skills
  5. Verifique los registros: openclaw logs --follow

Etiquetas: OpenClaw Node.js Alibaba Cloud BaiLian API Skills

Publicado el 7-27 07:22