openclaw tui
Gateway에 연결된 터미널 UI를 열거나 로컬 임베디드 모드로 실행합니다.
관련 가이드: TUI
옵션
별칭:
openclaw chat과 openclaw terminal은 --local이 암시적으로 적용된 상태로 이 명령을 호출합니다.
참고 사항
--local은--url,--token,--password또는--tls-fingerprint와 함께 사용할 수 없습니다.- 가능한 경우
tui는 토큰/비밀번호 인증을 위해 구성된 Gateway 인증 SecretRef를 확인합니다(env/file/exec제공자). - URL이나 포트를 명시하지 않으면
tui는 실행 중인 Gateway가 기록한 활성 로컬 Gateway 포트를 따릅니다. 명시적인--url,OPENCLAW_GATEWAY_URL,OPENCLAW_GATEWAY_PORT및 원격 Gateway 구성이 우선합니다. - 구성된 에이전트 작업 공간 디렉터리 내에서 실행하면 TUI는 세션 키 기본값으로 해당 에이전트를 자동 선택합니다(
--session이 명시적으로agent:<id>:...인 경우 제외). - 로컬이 아닌 URL 기반 연결의 바닥글에 Gateway 호스트 이름을 표시하려면
openclaw config set tui.footer.showRemoteHost true를 실행합니다. 기본적으로 꺼져 있으며 local loopback 또는 임베디드 로컬 연결에서는 표시되지 않습니다. - 로컬 모드는 임베디드 에이전트 런타임을 직접 사용합니다. 대부분의 로컬 도구는 작동하지만 Gateway 전용 기능은 사용할 수 없습니다.
- 로컬 모드는 TUI 명령 표면에
/auth [provider]를 추가합니다. - 로컬 모드에서도 Plugin 승인 게이트가 적용됩니다. 승인이 필요한 도구는 터미널에서 결정을 요청하며, 어떤 것도 자동으로 암묵적 승인되지 않습니다.
- 세션 목표는 바닥글에 표시되며
/goal로 관리할 수 있습니다.
예시
구성 복구 루프
로컬 모드를 사용하면 임베디드 에이전트가 현재 구성을 검사하고 문서와 비교하여 동일한 터미널에서 구성을 복구하도록 지원할 수 있습니다.openclaw config validate가 이미 실패하고 있다면 먼저 openclaw configure 또는 openclaw doctor --fix를 실행하세요. openclaw chat은 잘못된 구성 보호 장치를 우회하지 않습니다.
openclaw config set 또는 openclaw configure로 필요한 부분을 수정한 다음 openclaw config validate를 다시 실행합니다. TUI 및 구성을 참조하세요.