OpenClaw Setup

Diese Anleitung erklärt, wie Sie den OpenClaw-Agenten auf Ihrem RoqueOS-Server installieren und konfigurieren.

---

Voraussetzungen

VORAUSSETZUNGEN

• Installierter und laufender RoqueOS-Server (siehe Installation)
• Docker mit Zugriff auf den Socket (/var/run/docker.sock)
• API-Schlüssel von einem KI-Anbieter (OpenAI oder Anthropic)
• Mindestens 4 GB RAM auf dem Server (8 GB empfohlen)

---

1. Das OpenClaw Image herunterladen

OpenClaw läuft als separater Docker-Container. Laden Sie das offizielle Image herunter:

docker pull roqueribeiro1988/roqueos-openclaw:latest

Das Image beinhaltet:

• Ubuntu 22.04
• XFCE Desktop
• TigerVNC + noVNC
• Chromium Browser
• Node.js 20
• OpenClaw Agent

---

2. Den API-Schlüssel konfigurieren

Fügen Sie in der Datei docker-compose.yml Ihres RoqueOS-Servers die Umgebungsvariablen für Ihren KI-Schlüssel hinzu:

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=America/Sao_Paulo
      - OPENAI_API_KEY=sk-ihr-schluessel-hier

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=America/Sao_Paulo
      - ANTHROPIC_API_KEY=sk-ant-ihr-schluessel-hier

SICHERHEIT

Comitten Sie Ihre API-Schlüssel niemals in öffentliche Repositories. Verwenden Sie eine .env-Datei, um Geheimnisse zu speichern, und referenzieren Sie diese mit env_file: .env in der Compose-Datei.

Beispiel mit .env-Datei:

# .env (nicht in git einchecken!)
OPENAI_API_KEY=sk-ihr-schluessel-hier

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

---

3. Konfiguration überprüfen

Nachdem Sie den Server mit docker compose down && docker compose up -d neu gestartet haben, überprüfen Sie, ob das Agent-Modul erreichbar ist:

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

Erwartete Antwort:

[]

---

4. Zugriff auf den Agenten im Frontend

1. Öffnen Sie RoqueOS und stellen Sie sicher, dass Sie mit dem Server verbunden sind.
2. Suchen Sie im Launchpad nach der App KI-Agent (OpenClaw-Symbol).
3. Die App öffnet sich mit der Chat-Oberfläche und dem Vorschaufenster des Desktops.

---

Verwendete Ports

Port	Protokoll	Beschreibung
27021	HTTP/WS	RoqueOS Server API und WebSocket
5901	VNC	Desktop VNC des OpenClaw-Containers
6080	HTTP	noVNC (Webzugriff auf den Desktop)

Die Ports 5901 und 6080 werden intern vom Server verwaltet und müssen nicht nach außen freigegeben werden.

---

Verfügbare Umgebungsvariablen

Variable	Beschreibung	Standard
OPENAI_API_KEY	OpenAI API-Schlüssel	—
ANTHROPIC_API_KEY	Anthropic API-Schlüssel	—
AGENT_MAX_SESSIONS	Maximale gleichzeitige Sitzungen	3
AGENT_TIMEOUT	Sitzungs-Timeout in Minuten	30

---

Nächste Schritte

• Wie man OpenClaw verwendet — Praktischer Leitfaden und Beispiele