Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
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 config validate가 이미 실패하고 있다면 먼저 openclaw configure 또는 openclaw doctor --fix를 사용하세요. openclaw chat은 잘못된 구성 보호 장치를 우회하지 않습니다.
openclaw config set 또는 openclaw configure로 대상 수정 사항을 적용한 다음 openclaw config validate를 다시 실행하세요. TUI 및 Config를 참조하세요.