Configuración de OpenClaw

Esta guía explica cómo instalar y configurar el agente OpenClaw en tu Servidor RoqueOS.

---

Requisitos Previos

REQUISITOS PREVIOS

• Servidor RoqueOS instalado y en funcionamiento (ver instalación)
• Docker con acceso al socket (/var/run/docker.sock)
• Clave API de un proveedor de IA (OpenAI o Anthropic)
• Mínimo de 4 GB de RAM en el servidor (se recomiendan 8 GB)

---

1. Descargar la Imagen de OpenClaw

OpenClaw se ejecuta como un contenedor Docker independiente. Descarga la imagen oficial:

docker pull roqueribeiro1988/roqueos-openclaw:latest

La imagen incluye:

• Ubuntu 22.04
• Escritorio XFCE
• TigerVNC + noVNC
• Navegador Chromium
• Node.js 20
• Agente OpenClaw

---

2. Configurar la Clave API

En el archivo docker-compose.yml de tu Servidor RoqueOS, añade las variables de entorno para tu clave de IA:

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=America/Sao_Paulo
      - OPENAI_API_KEY=sk-tu-clave-aqui

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=America/Sao_Paulo
      - ANTHROPIC_API_KEY=sk-ant-tu-clave-aqui

SEGURIDAD

Nunca subas tus claves API a repositorios públicos. Usa un archivo .env para almacenar secretos y referéncialo con env_file: .env en el archivo compose.

Ejemplo con archivo .env:

# .env (¡no subir a git!)
OPENAI_API_KEY=sk-tu-clave-aqui

# docker-compose.yml
services:
  roqueos-server:
    env_file:
      - .env

---

3. Verificar Configuración

Después de reiniciar el servidor con docker compose down && docker compose up -d, verifica que el módulo del agente es accesible:

curl http://localhost:27021/agent/sessions

Respuesta esperada:

[]

---

4. Acceder al Agente en el Frontend

1. Abre RoqueOS y asegúrate de estar conectado al servidor.
2. En el Launchpad, busca la aplicación Agente de IA (icono de OpenClaw).
3. La aplicación se abrirá con la interfaz de chat y el panel de vista previa del escritorio.

---

Puertos Utilizados

Puerto	Protocolo	Descripción
27021	HTTP/WS	API y WebSocket del Servidor RoqueOS
5901	VNC	VNC del escritorio del contenedor OpenClaw
6080	HTTP	noVNC (acceso web al escritorio)

Los puertos 5901 y 6080 son gestionados internamente por el servidor y no necesitan ser expuestos externamente.

---

Variables de Entorno Disponibles

Variable	Descripción	Predeterminado
OPENAI_API_KEY	Clave API de OpenAI	—
ANTHROPIC_API_KEY	Clave API de Anthropic	—
AGENT_MAX_SESSIONS	Máximo de sesiones simultáneas	3
AGENT_TIMEOUT	Tiempo de espera de sesión en minutos	30

---

Próximos Pasos

• Cómo Usar OpenClaw — Guía práctica y ejemplos