TUI
기준일: 2026-07-26
공식 기준: TUI
TUI 문서는 OpenClaw 공식 문서(cli/tui)를 한국어로 정리한 가이드입니다. CLI reference for openclaw tui (Gateway-backed or local embedded terminal UI) 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
CLI reference for openclaw tui (Gateway-backed or local embedded terminal UI)
한국어 가이드 범위: cli/tui 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- 옵션
- 참고
- 예제
- when run inside an agent workspace, infers that agent automatically
- Config repair loop
- 관련 문서
상세 내용
openclaw tui
Open the terminal UI connected to the Gateway, or run it in local embedded mode.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
옵션
Aliases: openclaw chat and openclaw terminal invoke this command with --local implied.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Flag | Default | Description |
|---|---|---|
--local |
false |
Run against the local embedded agent runtime instead of a Gateway. |
--url <url> |
gateway.remote.url from config |
Gateway WebSocket URL. |
--token <token> |
(none) | Gateway token if required. |
--password <pass> |
(none) | Gateway password if required. |
--tls-fingerprint <sha256> |
gateway.remote.tlsFingerprint |
Expected TLS certificate fingerprint for a pinned wss:// Gateway. |
--session <key> |
main (or global when scope is global) |
Session key. Inside an agent workspace it auto-selects that agent unless prefixed. |
--deliver |
false |
Deliver assistant replies through configured channels. |
--thinking <level> |
(model default) | Thinking level override. |
--message <text> |
(none) | Send an initial message after connecting. |
--timeout-ms <ms> |
agents.defaults.timeoutSeconds |
Agent timeout. Invalid values log a warning and are ignored. |
--history-limit <n> |
200 |
History entries to load on attach. |
참고
when possible (env/file/exec providers).
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
--localcannot combine with--url,--token,--password, or--tls-fingerprint.tuiresolves configured Gateway auth SecretRefs for token/password auth- With no explicit URL or port,
tuifollows the active local Gateway port - Launched from inside a configured agent workspace directory, TUI auto-selects
- Local mode uses the embedded agent runtime directly. Most local tools work,
- Local mode adds
/auth [provider]to the TUI command surface. - Plugin approval gates still apply in local mode: tools that require approval
- Session goals appear in the footer and can be managed with
예제
> 위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 `--help`를 확인하세요.
### when run inside an agent workspace, infers that agent automatically
openclaw tui --session bugfix
Config repair loop
Use local mode to have the embedded agent inspect the current config, compare it against the docs, and help repair it from the same terminal.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw chat
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
관련 문서
주요 항목:
- CLI reference
- TUI
- Goal
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/cli/tui - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw chat
openclaw tui --local
openclaw tui
openclaw tui --url ws://127.0.0.1:18789 --token <token>
openclaw tui --session main --deliver
openclaw chat --message "Compare my config to the docs and tell me what to fix"
# when run inside an agent workspace, infers that agent automatically
openclaw tui --session bugfix
openclaw chat
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
관련 링크
- 공식 원문: cli/tui
- OpenClaw 문서 홈
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.