Agent Runtime

Die ProcessCube Agent Runtime ist ein generisches OpenClaw-Runtime-Image. Ein Entwickler aktiviert darin in ca. 15 Minuten ein AI-Backend per Subscription und kann anschließend aus ProcessCube® LowCode den Agenten main aufrufen — ohne eigenen API-Key, ohne lokale Installation.

In Entwicklung. Die Agent Runtime ist Teil der Preview-Phase (1.1.0-develop.x). Schnittstellen, Image-Tags und Verhalten können sich vor dem ersten Stable-Release noch ändern.

Die Coding-Agenten bauen auf genau diesem Runtime-Image auf (Dockerfile.agents) — die Runtime ist also die Grundlage, nicht ein separates Produkt.

Quick Start

`.env` anlegen


cp .env.example .env
# OPENCLAW_GATEWAY_TOKEN auf einen ausreichend langen Zufallswert setzen

Container starten


docker compose up -d

Runtime einrichten


docker compose exec openclaw-runtime bash
pc-runtime setup     # AI-Backend wählen und einloggen
pc-runtime doctor    # Zustand prüfen

Danach lässt sich aus LowCode per openclaw-message-send gegen Agent main an ws://<host>:18789 eine Antwort abrufen — mit demselben OPENCLAW_GATEWAY_TOKEN als Connect-Token.

Die Gateway bindet ans LAN und erzwingt Token-Auth (OpenClaw-Sicherheitsvorgabe). Ohne OPENCLAW_GATEWAY_TOKEN in der .env startet der Container nicht.

`pc-runtime`-Befehle

Befehl	Zweck
`pc-runtime setup`	AI-Backend wählen (Claude / Codex / Hybrid), Logins durchführen, Status zeigen
`pc-runtime doctor`	Runtime diagnostizieren (Gateway, Backend, Workspace, Volumes, Agent `main`)
`pc-runtime version`	Versionen aller enthaltenen Werkzeuge

Konfiguration

Env-Variable	Pflicht	Beschreibung
`OPENCLAW_GATEWAY_TOKEN`	ja	Connect-Token der Gateway; denselben Wert gibt LowCode beim Connect mit
`OPENAI_API_KEY`	nein	API-Key-Fallback (Subscription bleibt der Primärweg)
`ANTHROPIC_API_KEY`	nein	API-Key-Fallback (Subscription bleibt der Primärweg)

Enthaltene Werkzeuge

OpenClaw (fester Release-Tag), Bun, Node, Git, GitHub CLI (gh), Claude Code, OpenAI Codex, ProcessCube CLI (pc), Python und uv.

Persistente Volumes

Subscription-Logins und OpenClaw-State bleiben über Neustarts erhalten — Secrets liegen ausschließlich in den Volumes, nie im Image:


/home/node/.openclaw   /home/node/.claude   /home/node/.codex
/home/node/.config/gh  /workspace

Anbindung aus einem eigenen Compose-Projekt

Eine ProcessCube-Engine in einem separaten Compose-Stack erreicht die Runtime auf zwei Wegen:

über den veröffentlichten Port (18789), oder
über ein gemeinsames Docker-Netz pc-shared (ws://openclaw-runtime:18789):


docker network create pc-shared
# im docker-compose.yml der Runtime und der Engine das Netz pc-shared eintragen

Wie der Aufruf aus einem LowCode-Flow konkret aussieht (Gateway-Config, Token, openclaw-message-send), zeigt der Blog-Beitrag OpenClaw-Agenten aus ProcessCube® LowCode ansprechen.