inflearn logo
강의

Khóa học

Chia sẻ kiến thức

[Phần 1: Cơ bản] OpenClaw.AI Master Class: Tự tạo Agent AI tự hành với Gemini và Docker

[Thực hành] Hello OpenClaw! Khởi động lần đầu và kiểm tra hệ thống

페어링 오류

3

paran20374740

1 câu hỏi đã được viết

0

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

image.png


docker 업무-생산성 gemini ai-agent openclaw

Câu trả lời 2

0

Kevin

안녕하세요, 질문 감사합니다.


설명해주신 내용만으로 판단해 보면, 게이트웨이는 떠 있는데 지금 접속하신 브라우저가 아직 “승인된 디바이스”로 등록되지 않아서 계속 “장치 페어링이 필요하다” 화면에 머무는 상태로 보이는데,

아래 순서대로 한 번씩 확인해 보시면 좋겠습니다.


1. pending 상태 디바이스를 직접 승인하기

먼저, 게이트웨이가 현재 브라우저를 어떻게 인식하는지부터 확인해 볼게요.

Docker 기준 예시입니다. (컨테이너 이름은 환경에 따라 다를 수 있습니다.)

 

  1. 디바이스 목록 확인:

docker compose exec openclaw-gateway openclaw devices list

 

  • 여기서 상태가 pending인 디바이스가 있는지 확인해 주세요.

  • pending 항목 오른쪽에 Request ID가 하나 보일 거예요.

  1. pending 디바이스 승인:

docker compose exec openclaw-gateway openclaw devices approve <requestID>

 

  • 승인에 성공한 뒤, 브라우저에서 페이지를 새로고침하면 “장치 페어링이 필요하다” 메시지가 사라지고 OpenClaw 대시보드 UI가 떠야 정상입니다.

먼저 이 단계까지 한 번만 정확히 진행해 보신 뒤, 결과를 봐 주시면 좋겠습니다.


2. 승인했는데도 계속 “페어링 필요”가 뜰 때

위 단계에서 devices approve를 했는데도:

  • 새로고침할 때마다 계속 “장치 페어링이 필요하다”가 뜨고

  • docker compose openclaw-gateway openclaw devices list를 다시 보면 새로운 pending 디바이스가 또 생겨 있다면, 아래 두 가지를 의심할 수 있습니다.

  1. 브라우저 프로필 또는 쿠키 문제

  • 시크릿 모드, 광고 차단/보안 확장 프로그램 등이
    쿠키·로컬 스토리지를 막아서 접속할 때마다 새 디바이스로 인식되는 경우가 있습니다.

이럴 때는:

  • 시크릿 모드가 아니라 일반 브라우저 프로필에서 접속해 보시고

  • 광고 차단·보안 관련 확장 프로그램이 있다면 잠시 꺼둔 상태에서

  • 개발자 도구에서 사이트 데이터 삭제 후
    브라우저를 완전히 닫았다가 다시 켠 뒤,
    위 1번 단계(devices listdevices approve)를 다시 한 번만 반복해 주세요.

  1. 게이트웨이 내부 디바이스 상태가 꼬인 경우

  • 일부 버전에서 ~/.openclaw/devices 안의 상태가 꼬여서
    디바이스가 계속 pending으로만 쌓이는 이슈가 보고된 적도 있습니다.

  • 이 경우에는 상태를 초기화하고 다시 페어링을 시작해야 하는데,
    이 작업은 잘못하면 다른 디바이스도 초기화되기 때문에,
    시도 전에는 꼭 현재 환경과 devices list 출력 내용을 먼저 공유해 주시는 것을 추천드립니다.


3. 환경 정보와 devices 출력 함께 남겨주시면 좋겠습니다

위 1번(디바이스 승인)과 2번(브라우저 프로필/쿠키 확인)까지 진행해 보신 뒤에도 여전히:

  • 로그인 화면에서 “장치 페어링이 필요하다” 메시지에서 넘어가지 않거나

  • devices list에 pending만 계속 생기는 상황이라면,

아래 정보를 함께 남겨 주시면, 그 기준으로 더 정확하게 도와드릴 수 있습니다.

  • 사용 중인 환경:

    • 예: Windows WSL2 + Docker Desktop / 맥 Docker / 리눅스 서버 등

  • openclaw devices list 실행 결과(터미널 캡처 또는 텍스트)

이 두 가지가 있으면,
지금 브라우저가 게이트웨이 쪽에서 어떻게 보이고 있는지 함께 살펴보면서
추가로 필요한 조치를 자세히 안내해 드리겠습니다.

감사합니다.

0

communityai8509

안녕하세요, 인프런 AI 인턴입니다. ㅇㄹㅇㄹ님.

장치 페어링 관련하여 문제가 발생하고 있는 것에 대해 도와드리겠습니다. 장치 페어링 필요 메시지가 발생하며 대시보드 UI가 뜨지 않는 상황이라면, 몇 가지 점검 사항을 참고해 주세요.

문제 해결을 위한 점검 사항:

  1. WebSocket URL 및 Token 확인:

    • 대시보드의 로그인 인터페이스에서 WebSocket URL은 ws://localhost:3000으로 설정되어 있으며, Gateway Token이 정확한지 확인해 주세요.
    • .env 파일에서 설정된 값과 UI에 입력한 값이 일치하는지 다시 한 번 확인해 주세요.
  2. 네트워크 및 방화벽 설정:

    • localhost에서의 포트 접근이 가능한지, 방화벽 설정이나 네트워크 설정에서 해당 포트가 차단되지 않았는지 확인하시기 바랍니다.
  3. OpenClaw 설정 파일 확인:

    • OpenClaw의 설정 파일에서 gateway.controlUi.allowedOrigins에 정확한 쿼리 주소가 포함되어 있는지도 확인해 보세요. 예를 들어, http://localhost:3000을 허용 목록에 추가해야 할 수도 있습니다.
  4. 컨테이너 상태 및 로그 확인:

    • Docker 컨테이너가 정상적으로 실행 중인지 docker-compose ps 명령어로 확인하고, 컨테이너 로그에서 오류 메시지가 있는지 docker-compose logs를 통해 확인해 보세요.
  5. 브라우저 캐시 및 세션 초기화:

    • 브라우저의 캐시와 쿠키를 삭제하고 재시도해 보세요. 시크릿 모드에서 시도해 볼 수도 있습니다.

위의 방법들로 문제를 해결하시길 바라며, 다른 유사한 문제 해결 사례로 봉사되는 디바이스 페어링 문의 게시물이 도움이 될 수 있습니다. 이 게시물에서 비슷한 케이스의 문제 해결법이나 팁을 얻으실 수 있습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.

[13. Volume - 실습] hostpath 파일 확인 부분

0

2

0

강의4 안티그래비티 환경설정을 보고 있습니다.

0

2

0

오류 문의

0

13

2

n8n-mcp 설치해줘 하면 잘안되요

0

19

2

요구사항인터뷰 강의자료 안보임

0

6

2

학습자료는 어디서볼수있나요?

0

5

1

codex의 Skills 목록의 Frontend-Skill이 없어진 거 같아요!

0

13

1

라디오인줄...

0

13

0

AI Voice 인가요?

0

12

0

3주차 3-2 강의 텍스트 파일 다운로드가 안됩니다.

0

14

1

codex cli 나 codex 앱으로도 동일하게 작업가능할까요?

0

14

0

디바이스 페어링 문의

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