대시보드 (Control UI)
Gateway 대시보드는 기본적으로 /에서 제공되는 브라우저 Control UI입니다 (gateway.controlUi.basePath로 재정의).
빠른 열기 (로컬 Gateway):
주요 참조:
- 사용법 및 UI 기능은 Control UI를 참조하세요.
- Serve/Funnel 자동화는 Tailscale을 참조하세요.
- 바인드 모드 및 보안 참고 사항은 Web surfaces를 참조하세요.
인증은 connect.params.auth를 통해 WebSocket 핸드셰이크에서 시행됩니다 (토큰 또는 비밀번호). Gateway configuration의 gateway.auth를 참조하세요.
보안 참고: Control UI는 관리 표면입니다 (채팅, 구성, exec 승인). 공개적으로 노출하지 마세요. UI는 첫 로드 후 localStorage에 토큰을 저장합니다. localhost, Tailscale Serve 또는 SSH 터널을 선호합니다.
빠른 경로 (권장)
- 온보딩 후 CLI는 이제 토큰과 함께 대시보드를 자동으로 열고 동일한 토큰화된 링크를 인쇄합니다.
- 언제든지 다시 열기: openclaw dashboard (링크 복사, 가능한 경우 브라우저 열기, 헤드리스인 경우 SSH 힌트 표시).
- 토큰은 로컬로 유지됩니다 (쿼리 매개변수만); UI는 첫 로드 후 제거하고 localStorage에 저장합니다.
토큰 기본 사항 (로컬 vs 원격)
- Localhost: http://127.0.0.1:18789/를 엽니다. "unauthorized"가 표시되면 openclaw dashboard를 실행하고 토큰화된 링크 (?token=...)를 사용합니다.
- 토큰 소스: gateway.auth.token (또는 OPENCLAW_GATEWAY_TOKEN); UI는 첫 로드 후 저장합니다.
- localhost가 아님: Tailscale Serve (gateway.auth.allowTailscale: true인 경우 토큰 없음), 토큰이 있는 tailnet 바인드 또는 SSH 터널을 사용합니다. Web surfaces를 참조하세요.
"unauthorized" / 1008이 표시되는 경우
- openclaw dashboard를 실행하여 새로운 토큰화된 링크를 받습니다.
- Gateway에 연결할 수 있는지 확인합니다 (로컬: openclaw status; 원격: SSH 터널 ssh -N -L 18789:127.0.0.1:18789 user@host 후 http://127.0.0.1:18789/?token=... 열기).
- 대시보드 설정에서 gateway.auth.token (또는 OPENCLAW_GATEWAY_TOKEN)에 구성한 동일한 토큰을 붙여넣습니다.