Hoppa till huvudinnehåll

​
TUI (Terminal-UI)

​
Snabbstart

  1. Starta Gateway.
openclaw gateway
  1. Öppna TUI.
openclaw tui
  1. Skriv ett meddelande och tryck Enter.
Fjärr-Gateway: 
openclaw tui --url ws://<host>:<port> --token <gateway-token>
Använd --password om din Gateway använder lösenordsautentisering.

​
Vad du ser

  • Sidhuvud: anslutnings-URL, aktuell agent, aktuell session.
  • Chattlogg: användarmeddelanden, assistentsvar, systemmeddelanden, verktygskort.
  • Statusrad: anslutnings-/körstatus (ansluter, kör, strömmar, inaktiv, fel).
  • Sidfot: anslutningsstatus + agent + session + modell + think/verbose/reasoning + tokenantal + leverans.
  • Inmatning: textredigerare med autokomplettering.

​
Mental modell: agenter + sessioner

  • Agenter är unika sniglar (t.ex. main, research). Gateway exponerar listan.
  • Sessioner tillhör den aktuella agenten.
  • Sessionsnycklar lagras som agent:<agentId>:<sessionKey>.
    • Om du skriver /session main expanderar TUI det till agent:<currentAgent>:main.
    • Om du skriver /session agent:other:main växlar du uttryckligen till den agentsessionen.
  • Sessionsomfång:
    • per-sender (standard): varje agent har många sessioner.
    • global: TUI använder alltid sessionen global (väljaren kan vara tom).
  • Aktuell agent + session visas alltid i sidfoten.

​
Skicka + leverans

  • Meddelanden skickas till Gateway; leverans till leverantörer är avstängd som standard.
  • Slå på leverans:
    • /deliver on
    • eller panelen Inställningar
    • eller starta med openclaw tui --deliver

​
Väljare + överlägg

  • Modellväljare: listar tillgängliga modeller och sätter sessionsöverskrivning.
  • Agentväljare: välj en annan agent.
  • Sessionsväljare: visar endast sessioner för den aktuella agenten.
  • Inställningar: växla leverans, expansion av verktygsutdata och synlighet för tänkande.

​
Tangentbordsgenvägar

  • Enter: skicka meddelande
  • Esc: avbryt aktiv körning
  • Ctrl+C: rensa inmatning (tryck två gånger för att avsluta)
  • Ctrl+D: avsluta
  • Ctrl+L: modellväljare
  • Ctrl+G: agentväljare
  • Ctrl+P: sessionsväljare
  • Ctrl+O: växla expansion av verktygsutdata
  • Ctrl+T: växla synlighet för tänkande (läser in historik igen)

​
Slash-kommandon

Kärna:
  • /help
  • /status
  • /agent <id> (eller /agents)
  • /session <key> (eller /sessions)
  • /model <provider/model> (eller /models)
Sessionskontroller:
  • /think <off|minimal|low|medium|high>
  • /verbose <on|full|off>
  • /reasoning <on|off|stream>
  • /usage <off|tokens|full>
  • /elevated <on|off|ask|full> (alias: /elev)
  • /activation <mention|always>
  • /deliver <on|off>
Sessionslivscykel:
  • /new eller /reset (återställ sessionen)
  • /abort (avbryt den aktiva körningen)
  • /settings
  • /exit
Andra snedstreckskommandon (till exempel /context) vidarebefordras till Gateway och visas som systemutgång. Se Slash kommandon.

​
Lokala skal-kommandon

  • Prefixa en rad med ! för att köra ett lokalt skal-kommando på TUI-värden.
  • TUI frågar en gång per session om att tillåta lokal exekvering; om du nekar hålls ! inaktiverat för sessionen.
  • Kommandon körs i ett nytt, icke-interaktivt skal i TUI:s arbetskatalog (ingen bestående cd/env).
  • Ett ensamt ! skickas som ett vanligt meddelande; inledande mellanslag triggar inte lokal exekvering.

​
Verktygsutdata

  • Verktygsanrop visas som kort med argument + resultat.
  • Ctrl+O växlar mellan hopfällda/expanderade vyer.
  • Medan verktyg körs strömmas partiella uppdateringar in i samma kort.

​
Historik + strömning

  • Vid anslutning läser TUI in den senaste historiken (standard 200 meddelanden).
  • Strömmande svar uppdateras på plats tills de slutförs.
  • TUI lyssnar även på agentens verktygshändelser för rikare verktygskort.

​
Anslutningsdetaljer

  • TUI registrerar sig hos Gateway som mode: "tui".
  • Återanslutningar visar ett systemmeddelande; händelseglapp exponeras i loggen.

​
Alternativ

  • --url <url>: Gateway WebSocket-URL (standard enligt konfig eller ws://127.0.0.1:<port>)
  • --token <token>: Gateway-token (om krävs)
  • --password <password>: Gateway-lösenord (om krävs)
  • --session <key>: Sessionsnyckel (standard: main, eller global när omfånget är globalt)
  • --deliver: Leverera assistentsvar till leverantören (standard av)
  • --thinking <level>: Åsidosätt tänkenivå för sändningar
  • --timeout-ms <ms>: Agent-timeout i ms (standard agents.defaults.timeoutSeconds)
Obs: När du anger --url, faller TUI inte tillbaka till config eller miljö uppgifter. Passera --token eller --lösenord explicit. Saknar explicita referenser är ett fel.

​
Felsökning

Ingen utdata efter att ha skickat ett meddelande:
  • Kör /status i TUI för att bekräfta att Gateway är ansluten och inaktiv/upptagen.
  • Kontrollera Gateway-loggarna: openclaw logs --follow.
  • Bekräfta att agenten kan köra: openclaw status och openclaw models status.
  • Om du förväntar dig meddelanden i en chattkanal, aktivera leverans (/deliver on eller --deliver).
  • --history-limit <n>: Historikposter att läsa in (standard 200)

​
Felsökning av anslutning

  • disconnected: säkerställ att Gateway körs och att dina --url/--token/--password är korrekta.
  • Inga agenter i väljaren: kontrollera openclaw agents list och din routningskonfig.
  • Tom sessionsväljare: du kan vara i globalt omfång eller sakna sessioner ännu.