OpenClaw Pairing: 내 봇과 기기를 안전하게 연결하기

봇을 배포하고 나서 모르는 사람들에게 메시지가 쏟아지거나, 보안 설정 없이 새로운 기기를 연결하는 게 불안했던 적이 있나요? 권한 관리와 보안은 늘 번거롭지만 가장 중요한 작업이에요. OpenClaw는 ‘Pairing’이라는 명시적인 소유자 승인 단계를 통해 이 문제를 해결해요.

필요한 것

OpenClaw Gateway
지원되는 채널 (Telegram, WhatsApp, Signal, iMessage, Discord, Slack)
연결할 Node 기기 (iOS, Android, macOS, headless 중 하나)

빠른 시작

1. DM pairing (채팅 접근 권한)

채널의 DM policy가 pairing으로 설정되어 있다면, 모르는 사용자가 메시지를 보냈을 때 8자리의 인증 코드가 발급돼요. 승인 전까지는 메시지가 처리되지 않아요.

먼저 대기 중인 요청을 확인하세요.

openclaw pairing list telegram

확인한 코드를 사용해 승인하세요.

openclaw pairing approve telegram <CODE>

2. Node device pairing (기기 연결)

iOS나 Android 같은 Node를 Gateway에 연결할 때 필요한 단계예요. Telegram을 사용하는 방법이 가장 편해요.

Telegram에서 봇에게 /pair 메시지를 보내세요.
봇이 보내준 setup code를 복사하세요.
OpenClaw iOS 앱의 Settings → Gateway 메뉴로 이동하세요.
복사한 코드를 붙여넣고 연결하세요.
다시 Telegram으로 돌아와 /pair approve를 입력하면 끝이에요.

CLI를 직접 사용하고 싶다면 아래 명령어를 활용하세요.

openclaw devices list
openclaw devices approve <requestId>

문제 해결

코드가 작동하지 않나요? 페어링 코드는 생성 후 1시간 동안만 유효해요. 시간이 지났다면 봇이 새로운 코드를 보낼 때까지 기다려야 해요.
새로운 요청이 무시되나요? 채널당 대기 중인 DM 페어링 요청은 최대 3개로 제한돼요. 기존 요청이 만료되거나 승인되어야 새로운 요청을 받을 수 있어요.
상태를 초기화하고 싶나요? 페어링 데이터는 ~/.openclaw/credentials/와 ~/.openclaw/devices/ 디렉토리에 JSON 파일로 저장되어 있어요. 이 파일들은 민감한 정보를 담고 있으니 주의해서 관리하세요.

AI Setup Assistant

다음 단계

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.