OpenClaw 페어링이란? 낯선 DM·새 기기를 승인하기 전에 확인할 점

AI 에이전트를 메신저나 휴대폰과 연결할 때는 로그인과 누가 접근할 수 있는지 승인하는 일을 구분해야 합니다. OpenClaw 공식 문서에서 말하는 페어링(pairing)은 이 두 번째 경계를 분명히 하는 절차입니다.

이 글은 OpenClaw 공식 Pairing 문서를 바탕으로, 처음 설정하는 사람이 확인할 핵심을 한국어로 풀어 쓴 안내입니다. 실제 지원 채널과 화면은 버전에 따라 달라질 수 있으므로 연결 직전에는 공식 문서를 함께 확인하세요.

페어링은 두 종류로 나뉩니다

공식 문서는 페어링을 두 곳에 사용한다고 설명합니다. 하나는 DM 페어링으로, 봇에게 개인 메시지를 보낼 수 있는 사람을 승인하는 과정입니다. 다른 하나는 노드 기기 페어링으로, iOS·Android·macOS 같은 새 기기가 Gateway 네트워크에 참여하도록 승인하는 과정입니다.

둘 다 연결해도 될지를 묻지만 대상은 다릅니다. DM 페어링은 사람의 대화 접근을, 기기 페어링은 장치의 Gateway 접근을 다룹니다. 한쪽을 승인했다고 다른 쪽까지 자동으로 허용되는 것은 아닙니다.

낯선 DM은 바로 처리하지 않도록 만들 수 있습니다

채널의 DM 정책을 pairing으로 설정하면, 처음 연락한 발신자에게 짧은 페어링 코드가 전달되고 승인 전 메시지는 처리되지 않습니다. 공식 문서 기준 코드는 대문자 8자리이며, 혼동하기 쉬운 0·O·1·I는 쓰지 않고 1시간 뒤 만료됩니다.

관리 화면에서는 Settings → Channels → DM access requests에서 채널별 대기 요청과 발신자 정보를 보고 승인할 수 있습니다. 명령줄을 쓰는 환경에서는 채널별 대기 목록을 확인한 뒤 해당 코드만 승인합니다. 코드나 발신자 식별자를 공개 글·스크린샷에 그대로 올리지 않는 점도 중요합니다.

DM 승인과 그룹 권한은 별개입니다

개인 메시지를 허용했다고 해서 그 사람이 그룹에서 명령을 실행할 수 있게 되는 것은 아닙니다. 공식 문서는 그룹 허용 목록, 그룹별 설정, 명령 소유자 설정을 별도의 경계로 설명합니다. 팀 채팅에 에이전트를 넣을 때는 누가 DM을 보낼 수 있는지와 어느 그룹에서 어떤 사람이 호출할 수 있는지를 따로 점검하는 편이 안전합니다.

여러 채널에서 같은 신뢰할 수 있는 사람 목록을 써야 한다면, 문서의 accessGroups처럼 공통 발신자 그룹을 참조하는 구조도 검토할 수 있습니다. 다만 편리하다는 이유로 넓은 허용 목록을 만들기보다 실제 운영자 범위부터 작게 시작하는 것이 좋습니다.

새 휴대폰을 연결할 때는 승인할 범위를 봅니다

기기 페어링은 Control UI의 Settings → Devices에서 새 기기용 설정 코드를 만들고, 모바일 앱의 Gateway 설정에서 QR 코드 또는 설정 코드를 사용해 연결하는 흐름입니다. 문서는 Full access와 Limited access를 구분하며, 제한된 접근은 관리 권한 일부를 빼는 선택지라고 설명합니다.

대기 중인 기기가 보이면 단순히 기기 이름만 보고 승인하지 말고 역할과 범위를 확인하세요. 이미 연결된 기기가 더 넓은 역할이나 범위를 요청해 다시 연결하는 경우에도, 기존 승인 범위가 저절로 넓어지지 않고 새 승인 요청으로 다뤄집니다.

설정 코드는 비밀번호처럼 취급합니다

공식 문서에 따르면 기기 연결용 설정 코드에는 처음 연결을 위한 일회성 부트스트랩 정보가 들어가며 유효 기간도 제한됩니다. 이 코드는 유효한 동안 비밀번호처럼 다뤄야 합니다. 메신저 공개방, 블로그, 영상 화면에 복사해 넣지 말고 연결이 끝난 뒤에는 사용하지 않은 코드를 정리하는 습관이 좋습니다.

외부 네트워크에서 기기를 연결할 때는 보안 연결 경로도 중요합니다. 문서는 보안 wss:// 또는 관리되는 Tailscale 경로를 권장하며, 평문 연결에서는 권한이 제한될 수 있다고 안내합니다. 연결된다는 사실만으로 충분하다고 보지 말고 어떤 경로와 권한으로 연결됐는지 확인해야 합니다.

처음 설정할 때의 짧은 점검표

1. 개인 메시지는 기본적으로 누구에게 열려 있는지 확인합니다.
2. 처음 보는 DM 요청은 발신자와 맥락을 확인한 뒤 승인합니다.
3. DM 허용 목록과 그룹 권한을 따로 검토합니다.
4. 새 기기는 역할과 권한 범위를 확인하고, 필요하면 제한된 접근부터 사용합니다.
5. 설정 코드·페어링 코드·토큰·발신자 식별자는 공개하지 않습니다.

마무리

OpenClaw의 페어링은 누가 대화할 수 있는가와 어느 기기가 관리망에 들어오는가를 분리해 확인하게 하는 안전장치입니다. 채널을 고르기 전 구조가 궁금하다면 OpenClaw 채널을 고르기 전에 확인할 점도 함께 읽어 보세요.

출처: OpenClaw 공식 문서 — Pairing (확인일: 2026-09-15). 이 글은 공식 문서를 요약·해설한 글이며, 개인 사용 경험이나 보안 보증을 의미하지 않습니다.