TUI

Snel aan de slag

Gateway-modus

1. Start de Gateway.

openclaw gateway

2. Open de TUI.

openclaw tui

3. Typ een bericht en druk op Enter.

Externe Gateway:

openclaw tui --url ws://<host>:<port> --token <gateway-token>

Gebruik --password als je Gateway wachtwoordauthenticatie gebruikt.

Lokale modus

Voer de TUI uit zonder Gateway:

openclaw chat# ofopenclaw tui --local

• openclaw chat en openclaw terminal zijn aliassen voor openclaw tui --local.
• --local kan niet worden gecombineerd met --url, --token of --password.
• De lokale modus gebruikt rechtstreeks de ingebouwde agentruntime. De meeste lokale tools werken, maar functies die alleen via de Gateway beschikbaar zijn, zijn niet beschikbaar.
• Een kale openclaw (zonder subopdracht) kiest automatisch een doel: bij een niet-geconfigureerde installatie wordt de onboarding voor inferentie uitgevoerd; bij een ongeldige configuratie wordt de klassieke Doctor-begeleiding geopend; bij een bereikbare, geconfigureerde Gateway wordt deze TUI-shell in Gateway-modus geopend; anders wordt deze voor een geconfigureerd lokaal model in lokale modus geopend.

Wat je ziet

• Koptekst: verbindings-URL, huidige agent, huidige sessie.
• Chatlogboek: gebruikersberichten, antwoorden van de assistent, systeemmeldingen, toolkaarten.
• Statusregel: verbindings-/uitvoeringsstatus (verbinden, uitvoeren, streamen, inactief, fout).
• Voettekst: agent + sessie + model + doelstatus + denken/snel/uitgebreid/traceren/redeneren + aantallen tokens + afleveren.
• Invoer: teksteditor met automatisch aanvullen.

Mentaal model: agents + sessies

• Agents hebben unieke slugs (bijv. main, research). De Gateway stelt de lijst beschikbaar.
• Sessies behoren tot de huidige agent.
• Sessiesleutels worden opgeslagen als agent:<agentId>:<sessionKey>.
  • Als je /session main typt, breidt de TUI dit uit tot agent:<currentAgent>:main.
  • Als je /session agent:other:main typt, schakel je expliciet over naar die agentsessie.
• Sessiebereik:
  • per-sender (standaard): elke agent heeft meerdere sessies.
  • global: de TUI gebruikt altijd de sessie global (de keuzelijst kan leeg zijn).
• De huidige agent + sessie zijn altijd zichtbaar in de voettekst.
• Als de sessie een doel heeft, toont de voettekst de compacte status ervan: Pursuing goal, Goal paused (/goal resume), Goal blocked (/goal resume) of Goal achieved.
• Wanneer de TUI in Gateway-modus zonder --session wordt gestart, hervat deze de laatst geselecteerde sessie voor dezelfde Gateway, agent en hetzelfde sessiebereik als die sessie nog bestaat. Het doorgeven van --session, /session, /new of /reset blijft expliciet.

Verzenden + afleveren

• Berichten gaan altijd naar de Gateway (of de ingebouwde runtime in lokale modus); het antwoord van de assistent terugsturen naar een chatprovider is een afzonderlijke stap die standaard is uitgeschakeld.
• De TUI is een interne broninterface zoals WebChat, geen generiek uitgaand kanaal. Testharnassen die tools.message vereisen voor zichtbare antwoorden, kunnen de actieve TUI-beurt afhandelen met een doelloze message.send; expliciete aflevering via een provider gebruikt nog steeds de normaal geconfigureerde kanalen en valt nooit terug op lastChannel.
• Aflevering wordt bij het starten vastgelegd voor de volledige TUI-sessie: start met openclaw tui --deliver om dit in te schakelen. Er is geen slash-opdracht /deliver of schakelaar in Settings om dit tijdens de sessie te wijzigen; start de TUI opnieuw om dit te veranderen.

Keuzelijsten + overlays

• Modelkeuzelijst: geeft beschikbare modellen weer en stelt de sessie-override in.
• Agentkeuzelijst: kies een andere agent.
• Sessiekeuzelijst: toont maximaal 50 sessies voor de huidige agent die in de afgelopen 7 dagen zijn bijgewerkt. Gebruik /session <key> om naar een oudere bekende sessie te gaan.
• Settings (/settings): schakel het uitvouwen van tooluitvoer en de zichtbaarheid van denkstappen in of uit. Dit paneel regelt de aflevering niet.

Sneltoetsen

• Enter: bericht verzenden
• Esc: actieve uitvoering afbreken
• Ctrl+C: invoer wissen (druk tweemaal om af te sluiten)
• Ctrl+D: afsluiten
• Ctrl+L: modelkeuzelijst
• Ctrl+G: agentkeuzelijst
• Ctrl+P: sessiekeuzelijst
• Ctrl+O: uitvouwen van tooluitvoer in- of uitschakelen
• Ctrl+T: zichtbaarheid van denkstappen in- of uitschakelen (laadt de geschiedenis opnieuw)

Slash-opdrachten

Kern:

• /help
• /status (doorgestuurd naar de Gateway; toont een samenvatting van sessie/model)
• /gateway-status (alias /gwstatus; toont rechtstreeks de verbindingsstatus van de Gateway)
• /agent <id> (of /agents)
• /session <key> (of /sessions)
• /model <provider/model> (of /models)

Sessiebesturing:

• /think <off|minimal|low|medium|high> (hogere niveaus kunnen afhankelijk van het model niveaus zoals xhigh/max toevoegen)
• /fast <status|auto|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full|reset> (reset/inherit/clear/default wist de sessie-override)
• /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full> (alias: /elev)
• /activation <mention|always>
• /queue <steer|followup|collect|interrupt> [debounce:<duration>] [cap:<n>] [drop:<summarize|old|new>]
• /queue default (of /queue reset) wist de sessie-override

Levenscyclus van sessies:

• /new (maakt een nieuwe, geïsoleerde sessie onder een nieuwe sleutel; heeft geen invloed op andere TUI-clients in de oude sessie)
• /reset (stelt de huidige sessiesleutel ter plaatse opnieuw in)
• /abort (breekt de actieve uitvoering af)
• /settings
• /exit (of /quit)

Alleen lokale modus:

• /auth [provider] opent de authenticatie-/aanmeldingsflow van de provider binnen de TUI.

De lokale modus implementeert dezelfde wachtrijmodi in de ingebouwde runtime. Een prompt tijdens een uitvoering volgt het /queue-beleid van de sessie: steer voegt deze in wanneer de runtime deze kan accepteren, followup wacht op een afzonderlijke beurt, collect combineert wachtende prompts en interrupt stopt de huidige uitvoering voordat de nieuwe wordt gestart. Expliciete /steer <message> is alleen voor de Gateway; gebruik /queue steer plus een normaal bericht in de lokale modus.

OpenClaw:

• /openclaw [request] keert vanuit de normale agent-TUI terug naar de OpenClaw-chat voor installatie/reparatie en stuurt desgewenst één verzoek door.

Andere slash-opdrachten van de Gateway (bijvoorbeeld /context) worden doorgestuurd naar de Gateway en weergegeven als systeemuitvoer. Zie Slash-opdrachten.

Lokale shellopdrachten

• Plaats ! voor een regel om een lokale shellopdracht op de TUI-host uit te voeren.
• De TUI vraagt eenmaal per sessie toestemming voor lokale uitvoering; bij weigering blijft ! voor de sessie uitgeschakeld.
• Opdrachten worden uitgevoerd in een nieuwe, niet-interactieve shell in de werkmap van de TUI (geen permanente cd/omgeving).
• Lokale shellopdrachten ontvangen OPENCLAW_SHELL=tui-local in hun omgeving.
• Een losse ! wordt als normaal bericht verzonden; voorafgaande spaties activeren geen lokale uitvoering.

OpenClaw-helper voor installatie en reparatie

OpenClaw is de installatie-/reparatieassistent van ring zero, beschikbaar als openclaw setup nadat het geconfigureerde standaardmodel een live inferentiecontrole heeft doorstaan. Als inferentie niet beschikbaar is, keert een interactieve aanroep terug naar de onboarding voor inferentie en mislukt automatisering met reparatie-instructies. De assistent wordt uitgevoerd binnen dezelfde lokale TUI-shell als openclaw tui --local, ondersteund door een AI-agent die beperkt is tot getypeerde bewerkingen van OpenClaw waarvoor goedkeuring vereist is:

openclaw setup                       # interactief startenopenclaw setup -m "status"           # één verzoek uitvoeren en afsluitenopenclaw setup -m "set default model openai/gpt-5.2" --yes   # een configuratiewijziging toepassen

• Permanente configuratiewijzigingen vereisen goedkeuring: bevestig ze interactief of geef --yes door.
• --json geeft het opstartoverzicht als JSON weer in plaats van de chat te starten.
• Vanuit OpenClaw sluit een open-tui-verzoek (bijvoorbeeld een verzoek om met een normale agent te praten) OpenClaw af en opent het de reguliere agent-TUI; gebruik daar /openclaw om terug te keren.

Gebruik de lokale modus wanneer de huidige configuratie al geldig is en je wilt dat de ingebouwde agent deze op dezelfde machine inspecteert, met de documentatie vergelijkt en helpt afwijkingen te herstellen zonder afhankelijk te zijn van een actieve Gateway.

Als openclaw config validate al mislukt, begin dan eerst met openclaw configure of openclaw doctor --fix; openclaw chat heeft nog steeds een laadbare configuratie nodig om te starten.

Gebruikelijke cyclus:

1. Start de lokale modus:

openclaw chat

2. Vraag de agent wat je wilt laten controleren, bijvoorbeeld:

Vergelijk mijn configuratie voor Gateway-authenticatie met de documentatie en stel de kleinste oplossing voor.

3. Gebruik lokale shellopdrachten voor exact bewijsmateriaal en validatie:

!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

4. Pas gerichte wijzigingen toe met openclaw config set of openclaw configure en voer daarna !openclaw config validate opnieuw uit.
5. Als Doctor een automatische migratie of reparatie aanbeveelt, controleer deze dan en voer !openclaw doctor --fix uit.

Tips:

• Geef de voorkeur aan openclaw config set of openclaw configure boven het handmatig bewerken van openclaw.json.
• openclaw docs "<query>" doorzoekt de live documentatie-index vanaf dezelfde machine.
• openclaw config validate --json is nuttig wanneer je gestructureerde schema- en SecretRef-/oplosbaarheidsfouten wilt.

Tooluitvoer

• Toolaanroepen worden weergegeven als kaarten met argumenten + resultaten.
• Ctrl+O schakelt tussen samengevouwen en uitgevouwen weergaven.
• Terwijl tools worden uitgevoerd, worden gedeeltelijke updates naar dezelfde kaart gestreamd.

Terminalkleuren

• De TUI houdt de hoofdtekst van de assistent in de standaardvoorgrondkleur van je terminal, zodat zowel donkere als lichte terminals leesbaar blijven.
• Als je terminal een lichte achtergrond gebruikt en de automatische detectie onjuist is, stel dan OPENCLAW_THEME=light in voordat je openclaw tui start.
• Stel in plaats daarvan OPENCLAW_THEME=dark in om het oorspronkelijke donkere kleurenpalet af te dwingen.

Geschiedenis + streaming

• Bij verbinding laadt de TUI de meest recente geschiedenis (standaard 200 berichten).
• Streamingantwoorden worden ter plaatse bijgewerkt totdat ze definitief zijn.
• De TUI luistert ook naar toolgebeurtenissen van agents voor uitgebreidere toolkaarten.

Verbindingsgegevens

• De TUI maakt verbinding met client-id openclaw-tui in de globale clientmodus ui (dezelfde modus die Control UI en WebChat gebruiken voor Gateway-beleid).
• Bij opnieuw verbinden wordt een systeembericht weergegeven; hiaten in gebeurtenissen worden zichtbaar gemaakt in het logboek.

Opties

• --local: Uitvoeren met de lokale ingebedde agentruntime
• --url <url>: WebSocket-URL van de Gateway (standaard gateway.remote.url uit de configuratie, of ws://127.0.0.1:<port> op loopback)
• --token <token>: Gateway-token (indien vereist)
• --password <password>: Gateway-wachtwoord (indien vereist)
• --tls-fingerprint <sha256>: Verwachte vingerafdruk van het TLS-certificaat voor een vastgezette wss:// Gateway
• --session <key>: Sessiesleutel (standaard: main, of global wanneer het bereik globaal is)
• --deliver: Antwoorden van de assistent bij de provider afleveren (standaard uitgeschakeld)
• --thinking <level>: Denkniveau voor verzendingen overschrijven
• --message <text>: Na het verbinden een eerste bericht verzenden
• --timeout-ms <ms>: Time-out van de agent in ms (standaard agents.defaults.timeoutSeconds)
• --history-limit <n>: Aantal geschiedenisitems om te laden (standaard 200)

Problemen oplossen

Geen uitvoer na het verzenden van een bericht:

• Voer /status uit in de TUI om te bevestigen dat de Gateway verbonden en inactief/bezig is.
• Controleer de Gateway-logboeken: openclaw logs --follow.
• Bevestig dat de agent kan worden uitgevoerd: openclaw status en openclaw models status.
• Als je berichten in een chatkanaal verwacht, controleer dan of de TUI is gestart met --deliver (dit kan later niet worden ingeschakeld zonder opnieuw te starten).

Verbindingsproblemen oplossen

• disconnected: zorg dat de Gateway actief is en je --url/--token/--password correct zijn.
• Geen agents in de kiezer: controleer openclaw agents list en je routeringsconfiguratie.
• Lege sessiekiezer: mogelijk gebruik je het globale bereik of heb je nog geen sessies.

Gerelateerd

• Bedieningsinterface — webgebaseerde bedieningsinterface
• Configuratie — openclaw.json inspecteren, valideren en bewerken
• Doctor — begeleide reparatie- en migratiecontroles
• CLI-referentie — volledige referentie voor CLI-opdrachten