메인 콘텐츠로 건너뛰기

​
페어링

‘페어링’은 OpenClaw의 명시적인 소유자 승인 단계입니다. 다음 두 가지 경우에 사용됩니다:
  1. DM 페어링 (봇과 대화할 수 있는 사용자)
  2. 노드 페어링 (Gateway(게이트웨이) 네트워크에 참여할 수 있는 디바이스/노드)
보안 맥락: Security

​
1. 다이렉트 메시지 페어링 (인바운드 채팅 액세스)

채널이 DM 정책 pairing로 구성된 경우, 알 수 없는 발신자는 짧은 코드를 받으며 승인될 때까지 메시지가 처리되지 않습니다. 기본 DM 정책은 다음 문서에 설명되어 있습니다: Security 페어링 코드:
  • 8자, 대문자, 혼동될 수 있는 문자는 제외 (0O1I).
  • 1시간 후 만료됩니다. 봇은 새로운 요청이 생성될 때만 페어링 메시지를 전송합니다 (대략 발신자당 시간당 1회).
  • 대기 중인 다이렉트 메시지 페어링 요청은 기본적으로 채널당 3개로 제한되며, 하나가 만료되거나 승인될 때까지 추가 요청은 무시됩니다.

​
발신자 승인

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
지원되는 채널: telegram, whatsapp, signal, imessage, discord, slack.

​
Where the state lives

~/.openclaw/credentials/ 아래에 저장됩니다:
  • 대기 중 요청: <channel>-pairing.json
  • 승인된 허용 목록 저장소: <channel>-allowFrom.json
이 항목들은 민감하게 취급하십시오 (어시스턴트에 대한 액세스를 제어합니다).

​
2. 노드 디바이스 페어링 (iOS/Android/macOS/헤드리스 노드)

노드는 role: node을(를) 사용하는 디바이스로서 Gateway(게이트웨이)에 연결됩니다. Gateway(게이트웨이)는 승인되어야 하는 디바이스 페어링 요청을 생성합니다.

​
Telegram을 통한 페어링 (iOS에 권장)

device-pair 플러그인을 사용하는 경우, Telegram에서 처음 기기 페어링을 전부 진행할 수 있습니다:
  1. Telegram에서 봇에게 메시지를 보냅니다: /pair
  2. 봇이 두 개의 메시지로 응답합니다: 안내 메시지와 별도의 설정 코드 메시지(텔레그램에서 쉽게 복사/붙여넣기 가능).
  3. 휴대폰에서 OpenClaw iOS 앱을 열고 → Settings → Gateway로 이동합니다.
  4. 설정 코드를 붙여넣고 연결합니다.
  5. Telegram으로 돌아가서: /pair approve
설정 코드는 다음을 포함하는 base64로 인코딩된 JSON 페이로드입니다:
  • url: the Gateway WebSocket URL (ws://... or wss://...)
  • token: a short-lived pairing token
Treat the setup code like a password while it is valid.

​
노드 디바이스 승인

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

​
노드 페어링 상태 저장소

~/.openclaw/devices/ 아래에 저장됩니다:
  • pending.json (단기; 대기 중 요청은 만료됨)
  • paired.json (페어링된 디바이스 + 토큰)

​
참고

  • 레거시 node.pair.* API (CLI: openclaw nodes pending/approve)는 Gateway(게이트웨이) 소유의 별도 페어링 저장소입니다. WS 노드는 여전히 디바이스 페어링이 필요합니다.

​
관련 문서