CLI commands
TUI
openclaw tui
Gateway에 연결된 터미널 UI를 열거나 로컬 임베디드 모드에서 실행합니다.
관련 항목:
- TUI 가이드: TUI
옵션
| 플래그 | 기본값 | 설명 |
|---|---|---|
--local |
false |
Gateway 대신 로컬 임베디드 에이전트 런타임을 대상으로 실행합니다. |
--url <url> |
config의 gateway.remote.url |
Gateway WebSocket URL. |
--token <token> |
(없음) | 필요한 경우 Gateway 토큰입니다. |
--password <pass> |
(없음) | 필요한 경우 Gateway 비밀번호입니다. |
--session <key> |
main (또는 범위가 전역이면 global) |
세션 키입니다. 에이전트 작업 영역 안에서는 접두사가 없으면 해당 에이전트를 자동 선택합니다. |
--deliver |
false |
구성된 채널을 통해 어시스턴트 응답을 전달합니다. |
--thinking <level> |
(모델 기본값) | 사고 수준 재정의입니다. |
--message <text> |
(없음) | 연결 후 초기 메시지를 보냅니다. |
--timeout-ms <ms> |
agents.defaults.timeoutSeconds |
에이전트 타임아웃입니다. 잘못된 값은 경고를 기록하고 무시됩니다. |
--history-limit <n> |
200 |
연결 시 불러올 히스토리 항목 수입니다. |
별칭: openclaw chat 및 openclaw terminal은 --local이 암시된 동일한 명령을 호출합니다.
참고:
chat및terminal은openclaw tui --local의 별칭입니다.--local은--url,--token또는--password와 함께 사용할 수 없습니다.tui는 가능한 경우 토큰/비밀번호 인증을 위해 구성된 Gateway 인증 SecretRef를 해석합니다(env/file/exec제공자).- 구성된 에이전트 작업 영역 디렉터리 안에서 시작하면, TUI는 세션 키 기본값으로 해당 에이전트를 자동 선택합니다(
--session이 명시적으로agent:<id>:...인 경우 제외). - 로컬 모드는 임베디드 에이전트 런타임을 직접 사용합니다. 대부분의 로컬 도구는 작동하지만 Gateway 전용 기능은 사용할 수 없습니다.
- 로컬 모드는 TUI 명령 표면 안에
/auth [provider]를 추가합니다. - Plugin 승인 게이트는 로컬 모드에서도 계속 적용됩니다. 승인이 필요한 도구는 터미널에서 결정을 요청하며, Gateway가 관여하지 않는다는 이유로 조용히 자동 승인되지 않습니다.
예시
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyopenclaw tui --session bugfix구성 복구 루프
현재 구성이 이미 검증을 통과하고, 임베디드 에이전트가 이를 검사하고 문서와 비교하며 같은 터미널에서 복구를 도와주기를 원할 때 로컬 모드를 사용하세요.
openclaw config validate가 이미 실패하고 있다면 먼저 openclaw configure 또는 openclaw doctor --fix를 사용하세요. openclaw chat은 잘못된 구성 보호 장치를 우회하지 않습니다.
openclaw chat그런 다음 TUI 안에서:
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctoropenclaw config set 또는 openclaw configure로 대상 수정 사항을 적용한 다음 openclaw config validate를 다시 실행하세요. TUI 및 Config를 참조하세요.