페어링 오류
2
작성한 질문수 1
백엔드 쪽에서 포트번호도 일치하고
게이트웨이쪽 , 브라우저쪽 주소가 일치하고
개발자도구 들어가서 사이트 데이터도 날리고 다시 계속 시도해보았지만
장치 페어링이 필요하다며 ui자체가 아예 안뜨는상황입니다

답변 2
0
안녕하세요, 질문 감사합니다.
설명해주신 내용만으로 판단해 보면, 게이트웨이는 떠 있는데 지금 접속하신 브라우저가 아직 “승인된 디바이스”로 등록되지 않아서 계속 “장치 페어링이 필요하다” 화면에 머무는 상태로 보이는데,
아래 순서대로 한 번씩 확인해 보시면 좋겠습니다.
1. pending 상태 디바이스를 직접 승인하기
먼저, 게이트웨이가 현재 브라우저를 어떻게 인식하는지부터 확인해 볼게요.
Docker 기준 예시입니다. (컨테이너 이름은 환경에 따라 다를 수 있습니다.)
디바이스 목록 확인:
docker compose exec openclaw-gateway openclaw devices list
여기서 상태가 pending인 디바이스가 있는지 확인해 주세요.
pending 항목 오른쪽에 Request ID가 하나 보일 거예요.
pending 디바이스 승인:
docker compose exec openclaw-gateway openclaw devices approve <requestID>
승인에 성공한 뒤, 브라우저에서 페이지를 새로고침하면 “장치 페어링이 필요하다” 메시지가 사라지고 OpenClaw 대시보드 UI가 떠야 정상입니다.
먼저 이 단계까지 한 번만 정확히 진행해 보신 뒤, 결과를 봐 주시면 좋겠습니다.
2. 승인했는데도 계속 “페어링 필요”가 뜰 때
위 단계에서 devices approve를 했는데도:
새로고침할 때마다 계속 “장치 페어링이 필요하다”가 뜨고
docker compose openclaw-gateway openclaw devices list를 다시 보면 새로운 pending 디바이스가 또 생겨 있다면, 아래 두 가지를 의심할 수 있습니다.
브라우저 프로필 또는 쿠키 문제
시크릿 모드, 광고 차단/보안 확장 프로그램 등이
쿠키·로컬 스토리지를 막아서 접속할 때마다 새 디바이스로 인식되는 경우가 있습니다.
이럴 때는:
시크릿 모드가 아니라 일반 브라우저 프로필에서 접속해 보시고
광고 차단·보안 관련 확장 프로그램이 있다면 잠시 꺼둔 상태에서
개발자 도구에서 사이트 데이터 삭제 후
브라우저를 완전히 닫았다가 다시 켠 뒤,
위 1번 단계(devices list→devices approve)를 다시 한 번만 반복해 주세요.
게이트웨이 내부 디바이스 상태가 꼬인 경우
일부 버전에서
~/.openclaw/devices안의 상태가 꼬여서
디바이스가 계속 pending으로만 쌓이는 이슈가 보고된 적도 있습니다.이 경우에는 상태를 초기화하고 다시 페어링을 시작해야 하는데,
이 작업은 잘못하면 다른 디바이스도 초기화되기 때문에,
시도 전에는 꼭 현재 환경과devices list출력 내용을 먼저 공유해 주시는 것을 추천드립니다.
3. 환경 정보와 devices 출력 함께 남겨주시면 좋겠습니다
위 1번(디바이스 승인)과 2번(브라우저 프로필/쿠키 확인)까지 진행해 보신 뒤에도 여전히:
로그인 화면에서 “장치 페어링이 필요하다” 메시지에서 넘어가지 않거나
devices list에 pending만 계속 생기는 상황이라면,
아래 정보를 함께 남겨 주시면, 그 기준으로 더 정확하게 도와드릴 수 있습니다.
사용 중인 환경:
예: Windows WSL2 + Docker Desktop / 맥 Docker / 리눅스 서버 등
openclaw devices list실행 결과(터미널 캡처 또는 텍스트)
이 두 가지가 있으면,
지금 브라우저가 게이트웨이 쪽에서 어떻게 보이고 있는지 함께 살펴보면서
추가로 필요한 조치를 자세히 안내해 드리겠습니다.
감사합니다.
0
안녕하세요, 인프런 AI 인턴입니다. ㅇㄹㅇㄹ님.
장치 페어링 관련하여 문제가 발생하고 있는 것에 대해 도와드리겠습니다. 장치 페어링 필요 메시지가 발생하며 대시보드 UI가 뜨지 않는 상황이라면, 몇 가지 점검 사항을 참고해 주세요.
문제 해결을 위한 점검 사항:
WebSocket URL 및 Token 확인:
- 대시보드의 로그인 인터페이스에서 WebSocket URL은
ws://localhost:3000으로 설정되어 있으며, Gateway Token이 정확한지 확인해 주세요.
.env파일에서 설정된 값과 UI에 입력한 값이 일치하는지 다시 한 번 확인해 주세요.
- 대시보드의 로그인 인터페이스에서 WebSocket URL은
네트워크 및 방화벽 설정:
- localhost에서의 포트 접근이 가능한지, 방화벽 설정이나 네트워크 설정에서 해당 포트가 차단되지 않았는지 확인하시기 바랍니다.
- localhost에서의 포트 접근이 가능한지, 방화벽 설정이나 네트워크 설정에서 해당 포트가 차단되지 않았는지 확인하시기 바랍니다.
OpenClaw 설정 파일 확인:
- OpenClaw의 설정 파일에서
gateway.controlUi.allowedOrigins에 정확한 쿼리 주소가 포함되어 있는지도 확인해 보세요. 예를 들어,http://localhost:3000을 허용 목록에 추가해야 할 수도 있습니다.
- OpenClaw의 설정 파일에서
컨테이너 상태 및 로그 확인:
- Docker 컨테이너가 정상적으로 실행 중인지
docker-compose ps명령어로 확인하고, 컨테이너 로그에서 오류 메시지가 있는지docker-compose logs를 통해 확인해 보세요.
- Docker 컨테이너가 정상적으로 실행 중인지
브라우저 캐시 및 세션 초기화:
- 브라우저의 캐시와 쿠키를 삭제하고 재시도해 보세요. 시크릿 모드에서 시도해 볼 수도 있습니다.
- 브라우저의 캐시와 쿠키를 삭제하고 재시도해 보세요. 시크릿 모드에서 시도해 볼 수도 있습니다.
위의 방법들로 문제를 해결하시길 바라며, 다른 유사한 문제 해결 사례로 봉사되는 디바이스 페어링 문의 게시물이 도움이 될 수 있습니다. 이 게시물에서 비슷한 케이스의 문제 해결법이나 팁을 얻으실 수 있습니다.
저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.
강의4 안티그래비티 환경설정을 보고 있습니다.
0
1
0
오류 문의
0
11
2
n8n-mcp 설치해줘 하면 잘안되요
0
16
2
요구사항인터뷰 강의자료 안보임
0
4
2
학습자료는 어디서볼수있나요?
0
4
1
codex의 Skills 목록의 Frontend-Skill이 없어진 거 같아요!
0
12
1
라디오인줄...
0
12
0
AI Voice 인가요?
0
11
0
3주차 3-2 강의 텍스트 파일 다운로드가 안됩니다.
0
13
1
codex cli 나 codex 앱으로도 동일하게 작업가능할까요?
0
14
0
버전에 3.11이랑 3.11.X 랑 차이가 있나요?
0
10
1
디바이스 페어링 문의
0
54
2
섹션 4의 14번 3개의 샘플파일
0
46
2
볼륨 마운트 : PC와 AI 작업실 연결 4분 40초부터
0
78
3
맥 - 권한설정
0
59
2
http://localhost:3000/?token=demo_token_123 입력시 접속이 되지 않습니다.
0
60
2
컨테이너가 10초 정도 간격으로 계속 연결됐다 끊겼다가 합니다.
0
57
2
여러개의 컨테이너 생성하여 각각 오픈클로 설치 가능한가요?
0
139
2
프로젝트 경로 관련
0
42
2
WSL2 우분투 설치 관련 문의
0
46
1
맥/ 도커 설치 관련 문의
0
46
1
auth-profiles.json 내 google_api_key 하드코딩 제거시 오류
0
78
2
docker - WSL 2 distro could not be found 오류
0
93
2
도커 오류발생
0
275
3





