# openclaw tui

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

관련:

• TUI 가이드: TUI

참고:

• chat과 terminal은 openclaw tui --local의 별칭입니다.
• --local은 --url, --token, 또는 --password와 함께 사용할 수 없습니다.
• tui는 가능하면 토큰/비밀번호 인증에 대해 구성된 Gateway 인증 SecretRef를 확인합니다(env/file/exec provider).
• 구성된 에이전트 워크스페이스 디렉터리 내부에서 실행하면 TUI는 세션 키 기본값으로 해당 에이전트를 자동 선택합니다(--session이 명시적으로 agent:<id>:...인 경우 제외).
• 로컬 모드는 임베디드 에이전트 런타임을 직접 사용합니다. 대부분의 로컬 도구는 작동하지만 Gateway 전용 기능은 사용할 수 없습니다.
• 로컬 모드는 TUI 명령 표면에 /auth [provider]를 추가합니다.
• 로컬 모드에서도 Plugin 승인 게이트가 계속 적용됩니다. 승인이 필요한 도구는 터미널에서 결정 프롬프트를 표시하며, 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 "내 구성을 문서와 비교하고 무엇을 수정해야 하는지 알려줘"
# 에이전트 워크스페이스 안에서 실행하면 해당 에이전트를 자동으로 추론
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