CLI commands
페어링
openclaw pairing
페어링을 지원하는 채널의 DM 페어링 요청을 승인하거나 확인합니다(채팅 DM만 해당하며, Node/기기 페어링에는 openclaw devices를 사용합니다).
관련 문서: 페어링 흐름
명령어
openclaw pairing list telegramopenclaw pairing list --channel telegram --account workopenclaw pairing list telegram --json openclaw pairing approve <code>openclaw pairing approve telegram <code>openclaw pairing approve --channel telegram --account work <code> --notifypairing list
한 채널의 대기 중인 페어링 요청을 나열합니다.
| 옵션 | 설명 |
|---|---|
[channel] |
위치 인수로 지정하는 채널 ID |
--channel <channel> |
명시적으로 지정하는 채널 ID |
--account <accountId> |
다중 계정 채널의 계정 ID |
--json |
기계가 읽을 수 있는 형식으로 출력 |
페어링을 지원하는 채널이 여러 개 구성되어 있으면 채널을 위치 인수 또는 --channel로 전달합니다. 채널 ID가 유효하면 확장 채널에서도 사용할 수 있습니다.
pairing approve
대기 중인 페어링 코드를 승인하고 해당 발신자를 허용합니다.
사용법:
openclaw pairing approve <channel> <code>openclaw pairing approve --channel <channel> <code>- 페어링을 지원하는 채널이 정확히 하나 구성된 경우
openclaw pairing approve <code>
옵션: --channel <channel>, --account <accountId>, --notify(동일한 채널에서 요청자에게 확인 메시지를 보냅니다).
소유자 초기 설정
페어링 코드를 승인할 때 commands.ownerAllowFrom이 비어 있으면 OpenClaw는 승인된 발신자를 명령 소유자로도 기록하며, telegram:123456789와 같은 채널 범위 항목을 사용합니다. 이 동작은 첫 번째 소유자만 초기 설정합니다. 이후의 페어링 승인은 commands.ownerAllowFrom을 대체하거나 확장하지 않습니다.
명령 소유자는 소유자 전용 명령을 실행하고 /diagnostics, /export-trajectory, /config, 실행 승인과 같은 위험한 작업을 승인할 수 있는 인간 운영자 계정입니다. 페어링은 발신자가 에이전트와 대화할 수 있게 할 뿐이며, 이 일회성 초기 설정 외에는 그 자체로 소유자 권한을 부여하지 않습니다.
이 초기 설정 기능이 도입되기 전에 발신자를 승인했다면 openclaw doctor를 실행하세요. 명령 소유자가 구성되지 않은 경우 경고하고, 이를 수정하기 위한 정확한 openclaw config set commands.ownerAllowFrom ... 명령을 표시합니다.
