TUI

# Snel starten

# 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 wachtwoordverificatie gebruikt.

# Lokale modus

Voer de TUI uit zonder Gateway:

openclaw chat
# or
openclaw tui --local

Opmerkingen:

• openclaw chat en openclaw terminal zijn aliassen voor openclaw tui --local.
• --local kan niet worden gecombineerd met --url, --token of --password.
• Lokale modus gebruikt de ingebedde agentruntime rechtstreeks. De meeste lokale tools werken, maar functies die alleen via de Gateway beschikbaar zijn, zijn niet beschikbaar.
• openclaw en openclaw crestodian gebruiken ook deze TUI-shell, met Crestodian als backend voor de lokale installatie- en reparatiechat.

# Wat je ziet

• Koptekst: verbindings-URL, huidige agent, huidige sessie.
• Chatlogboek: gebruikersberichten, antwoorden van de assistent, systeemmeldingen, toolkaarten.
• Statusregel: verbindings-/uitvoeringsstatus (verbinden, actief, streamen, inactief, fout).
• Voettekst: verbindingsstatus + agent + sessie + model + denken/snel/uitgebreid/trace/reasoning + tokenaantallen + bezorgen.
• Invoer: teksteditor met automatisch aanvullen.

# Mentaal model: agents + sessies

• Agents zijn unieke slugs (bijv. main, research). De Gateway stelt de lijst beschikbaar.
• Sessies horen bij de huidige agent.
• Sessiesleutels worden opgeslagen als agent:<agentId>:<sessionKey>.
  • Als je /session main typt, breidt de TUI dit uit naar 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 global-sessie (de kiezer kan leeg zijn).
• De huidige agent + sessie zijn altijd zichtbaar in de voettekst.
• 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 + bezorging

• Berichten worden naar de Gateway verzonden; bezorging aan providers is standaard uitgeschakeld.
• Schakel bezorging in:
  • /deliver on
  • of het paneel Instellingen
  • of start met openclaw tui --deliver

# Kiezers + overlays

• Modelkiezer: toon beschikbare modellen en stel de sessie-override in.
• Agentkiezer: kies een andere agent.
• Sessiekiezer: toont maximaal 50 sessies voor de huidige agent die in de laatste 7 dagen zijn bijgewerkt. Gebruik /session <key> om naar een oudere bekende sessie te springen.
• Instellingen: schakel bezorgen, uitbreiding van tooluitvoer en zichtbaarheid van denken in of uit.

# Sneltoetsen

• Enter: bericht verzenden
• Esc: actieve uitvoering afbreken
• Ctrl+C: invoer wissen (druk twee keer om af te sluiten)
• Ctrl+D: afsluiten
• Ctrl+L: modelkiezer
• Ctrl+G: agentkiezer
• Ctrl+P: sessiekiezer
• Ctrl+O: uitbreiding van tooluitvoer in-/uitschakelen
• Ctrl+T: zichtbaarheid van denken in-/uitschakelen (laadt geschiedenis opnieuw)

# Slash-opdrachten

Kern:

• /help
• /status
• /agent <id> (of /agents)
• /session <key> (of /sessions)
• /model <provider/model> (of /models)

Sessiebesturing:

• /think <off|minimal|low|medium|high>
• /fast <status|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full>
• /elevated <on|off|ask|full> (alias: /elev)
• /activation <mention|always>
• /deliver <on|off>

Sessielevenscyclus:

• /new of /reset (de sessie resetten)
• /abort (de actieve uitvoering afbreken)
• /settings
• /exit

Alleen lokale modus:

• /auth [provider] opent de verificatie-/loginflow van de provider in de TUI.

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

# Lokale shellopdrachten

• Zet ! aan het begin van een regel om een lokale shellopdracht op de TUI-host uit te voeren.
• De TUI vraagt één keer per sessie om lokale uitvoering toe te staan; als je weigert, blijft ! uitgeschakeld voor de sessie.
• Opdrachten worden uitgevoerd in een nieuwe, niet-interactieve shell in de werkmap van de TUI (geen blijvende cd/env).
• Lokale shellopdrachten krijgen OPENCLAW_SHELL=tui-local in hun omgeving.
• Een losse ! wordt verzonden als een normaal bericht; voorloopspaties activeren geen lokale uitvoering.

# Configs repareren vanuit de lokale TUI

Gebruik lokale modus wanneer de huidige config al valideert en je wilt dat de ingebedde agent deze op dezelfde machine inspecteert, vergelijkt met de docs, en helpt afwijkingen te repareren zonder afhankelijk te zijn van een draaiende Gateway.

Als openclaw config validate al faalt, begin dan eerst met openclaw configure of openclaw doctor --fix. openclaw chat omzeilt de bewaking tegen ongeldige config niet.

Typische lus:

1. Start lokale modus:

openclaw chat

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

Compare my gateway auth config with the docs and suggest the smallest fix.

3. Gebruik lokale shellopdrachten voor exact bewijs en validatie:

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

4. Pas smalle 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, beoordeel die 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 docs-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 ingeklapte/uitgeklapte weergaven.
• Terwijl tools draaien, streamen gedeeltelijke updates naar dezelfde kaart.

# Terminalkleuren

• De TUI houdt de hoofdtekst van de assistent in de standaardvoorgrondkleur van je terminal, zodat donkere en lichte terminals beide leesbaar blijven.
• Als je terminal een lichte achtergrond gebruikt en automatische detectie verkeerd is, stel dan OPENCLAW_THEME=light in voordat je openclaw tui start.
• Als je in plaats daarvan het oorspronkelijke donkere palet wilt afdwingen, stel dan OPENCLAW_THEME=dark in.

# Geschiedenis + streaming

• Bij verbinden laadt de TUI de nieuwste geschiedenis (standaard 200 berichten).
• Streamende antwoorden worden ter plekke bijgewerkt tot ze definitief zijn.
• De TUI luistert ook naar agenttoolgebeurtenissen voor rijkere toolkaarten.

# Verbindingsdetails

• De TUI registreert zich bij de Gateway als mode: "tui".
• Herverbindingen tonen een systeembericht; gaten in events worden zichtbaar gemaakt in het logboek.

# Opties

• --local: uitvoeren tegen de lokale ingebedde agentruntime
• --url <url>: Gateway WebSocket-URL (standaard uit config of ws://127.0.0.1:<port>)
• --token <token>: Gateway-token (indien vereist)
• --password <password>: Gateway-wachtwoord (indien vereist)
• --session <key>: sessiesleutel (standaard: main, of global wanneer het bereik global is)
• --deliver: antwoorden van de assistent bezorgen aan de provider (standaard uit)
• --thinking <level>: denkniveau voor verzendingen overschrijven
• --message <text>: een eerste bericht verzenden na verbinding
• --timeout-ms <ms>: agenttimeout in ms (standaard uit agents.defaults.timeoutSeconds)
• --history-limit <n>: te laden geschiedenisitems (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 draaien: openclaw status en openclaw models status.
• Als je berichten in een chatkanaal verwacht, schakel bezorging in (/deliver on of --deliver).

# Verbindingsproblemen oplossen

• disconnected: zorg dat de Gateway draait en dat je --url/--token/--password correct zijn.
• Geen agents in de kiezer: controleer openclaw agents list en je routeringsconfig.
• Lege sessiekiezer: je bevindt je mogelijk in global bereik of je hebt nog geen sessies.

# Gerelateerd

• Control UI — webgebaseerde besturingsinterface
• Config — openclaw.json inspecteren, valideren en bewerken
• Doctor — begeleide reparatie- en migratiecontroles
• CLI Reference — volledige CLI-opdrachtenreferentie