openclaw tui

Gateway에 연결된 터미널 UI를 열거나, 로컬 임베디드 모드에서 실행합니다.

관련 항목:

• TUI 가이드: TUI

옵션

별칭: openclaw chat 및 openclaw terminal은 --local이 암시된 동일한 명령을 호출합니다.

참고:

• chat 및 terminal은 openclaw tui --local의 별칭입니다.
• --local은 --url, --token 또는 --password와 함께 사용할 수 없습니다.
• tui는 가능한 경우 토큰/비밀번호 인증을 위해 구성된 Gateway 인증 SecretRefs를 확인합니다(env/file/exec 제공자).
• 구성된 에이전트 작업 영역 디렉터리 안에서 실행하면, TUI는 세션 키 기본값으로 해당 에이전트를 자동 선택합니다(--session이 명시적으로 agent:<id>:...인 경우 제외).
• 로컬이 아닌 URL 기반 연결의 푸터에 Gateway 호스트 이름을 표시하려면 openclaw config set tui.footer.showRemoteHost true를 실행하세요. 호스트 레이블은 기본적으로 꺼져 있으며 루프백 또는 임베디드 로컬 연결에는 절대 표시되지 않습니다.
• 로컬 모드는 임베디드 에이전트 런타임을 직접 사용합니다. 대부분의 로컬 도구는 작동하지만 Gateway 전용 기능은 사용할 수 없습니다.
• 로컬 모드는 TUI 명령 표면 안에 /auth [provider]를 추가합니다.
• Plugin 승인 게이트는 로컬 모드에서도 계속 적용됩니다. 승인이 필요한 도구는 터미널에서 결정을 요청합니다. Gateway가 관여하지 않는다고 해서 어떤 것도 조용히 자동 승인되지 않습니다.
• 세션 목표는 푸터에 표시되며 /goal로 관리할 수 있습니다.

예시

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"# 에이전트 작업 영역 안에서 실행하면 해당 에이전트를 자동으로 추론합니다openclaw 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 doctor

openclaw config set 또는 openclaw configure로 대상 수정 사항을 적용한 다음 openclaw config validate를 다시 실행하세요. TUI 및 구성을 참조하세요.

관련 항목

• CLI 참조
• TUI
• 목표