OpenCode-Server

TokenWork läuft auf einem OpenCode-Server auf. Standardmäßig startet es einen für dich, sodass du nichts tun musst. Diese Seite brauchst du nur, wenn du TokenWork auf einen Server zeigen lassen willst, den du bereits betreibst, oder den Server verwalten willst, den es startet.

Wie TokenWork einen Server findet

Wenn TokenWork startet, sucht es in dieser Reihenfolge nach einem Server:

einen Server wiederverwenden, den es bereits gestartet hat
zu einem externen verbinden, wenn du es so angegeben hast (siehe unten)
einen Server am Standard-Port automatisch erkennen (4096)
andernfalls den eigenen starten und verwalten

Wenn nichts konfiguriert ist, geschieht Schritt 4 automatisch und du bist startklar.

Mit einem Server verbinden, den du bereits betreibst

Setze diese Variablen, bevor du TokenWork startest:

OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber

OPENCODE_HOST — die vollständige Adresse deines OpenCode-Servers einschließlich des Ports (ein Wert wie http://localhost:4096). Sie darf am Ende keinen Pfad haben.
OPENCODE_SKIP_START=true — weist TokenWork an, keinen eigenen Server zu starten.

Wenn du nur den Port ändern musst, setze OPENCODE_PORT statt OPENCODE_HOST.

Wenn OPENCODE_HOST keinen Port hat oder einen Pfad enthält, ignoriert TokenWork ihn und fällt darauf zurück, den eigenen Server zu starten. Achte beim Start auf eine [config]-Warnung in den Logs, wenn eine erwartete Verbindung nicht zustande kam.

Den Server über das CLI verwalten

openchamber status
openchamber logs
openchamber restart
openchamber stop

openchamber allein startet den Server im Hintergrund. Füge --foreground hinzu, damit er an dein Terminal gebunden bleibt.

TokenWork beim Anmelden starten

Verwende startup enable, um einen nativen Benutzerdienst zu installieren. TokenWork nutzt launchd auf macOS, systemd --user auf Linux und den Taskplaner auf Windows.

openchamber startup enable
openchamber startup status
openchamber startup disable

Um die UI zu schützen, setze das Passwort beim Aktivieren des Dienstes:

OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable

Für einen headless Server, der sich beim Anmelden startet und für Desktop- oder Mobile-Clients gedacht ist, füge --api-only und einen erreichbaren Host hinzu:

openchamber startup enable --port 3000 --api-only --host 0.0.0.0 --ui-password secret

startup enable speichert deine aktuelle Umgebung als Schnappschuss im Dienst, damit er sich eher so verhält, als würdest du openchamber aus derselben Shell starten. So bleiben Provider-Tokens, PATH, SSH-Agent-Einstellungen und andere CLI-Auth-/Konfigurationsvariablen verfügbar. Verwende --no-env-snapshot, wenn du eine minimale Dienstenumgebung willst.

Der Startup-Dienst merkt sich --port, --host, --ui-password und --api-only. CLI-Neustarts und Update-Neustarts verwenden diese gespeicherten Einstellungen wieder.

Um einen Verbindungslink für eine andere TokenWork-App zu erstellen, verwende:

openchamber connect-url --port 3000 --server http://your-host:3000 --qr

Führe openchamber connect-url --help aus, um alle Link-Optionen zu sehen, einschließlich --name, --lan, --server, --api-only, --ui-password und --qr.

Du kannst Tunnel für diesen laufenden Dienst weiterhin unabhängig verwalten:

openchamber tunnel start --port 3000
openchamber tunnel stop --port 3000

Das Stoppen des Tunnels startet weder den Dienst noch die App neu.

„OpenCode wird neu gestartet“