Pareamento¶
“Pareamento” é a etapa explícita de aprovação do proprietário do OpenClaw. Ela é usada em dois lugares:
- Pareamento de DM (quem tem permissão para falar com o bot)
- Pareamento de nós (quais dispositivos/nós podem entrar na rede do gateway)
Contexto de segurança: Security
1. Pareamento de DM (acesso a chat de entrada)¶
Quando um canal é configurado com a política de DM pairing, remetentes desconhecidos recebem um código curto e a mensagem não é processada até que você aprove.
As políticas padrão de DM estão documentadas em: Security
Códigos de pareamento:
- 8 caracteres, maiúsculos, sem caracteres ambíguos (
0O1I). - Expiram após 1 hora. O bot só envia a mensagem de pareamento quando uma nova solicitação é criada (aproximadamente uma vez por hora por remetente).
- Solicitações de pareamento de DM pendentes são limitadas a 3 por canal por padrão; solicitações adicionais são ignoradas até que uma expire ou seja aprovada.
Aprovar um remetente¶
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
Canais suportados: telegram, whatsapp, signal, imessage, discord, slack.
Onde o estado fica armazenado¶
Armazenado em ~/.openclaw/credentials/:
- Solicitações pendentes:
<channel>-pairing.json - Armazenamento da lista de permissões aprovada:
<channel>-allowFrom.json
Trate-os como sensíveis (eles controlam o acesso ao seu assistente).
2. Pareamento de dispositivos de nó (iOS/Android/macOS/nós headless)¶
Os nós se conectam ao Gateway como dispositivos com role: node. O Gateway
cria uma solicitação de pareamento de dispositivo que deve ser aprovada.
Pareamento via Telegram (recomendado para iOS)¶
Se você usa o plugin device-pair, pode fazer o pareamento inicial do dispositivo totalmente pelo Telegram:
- No Telegram, envie uma mensagem para o seu bot:
/pair - O bot responde com duas mensagens: uma mensagem de instruções e uma mensagem separada com o código de configuração (fácil de copiar/colar no Telegram).
- No seu celular, abra o app OpenClaw para iOS → Settings → Gateway.
- Cole o código de configuração e conecte-se.
- De volta ao Telegram:
/pair approve
O código de configuração é um payload JSON codificado em base64 que contém:
url: a URL WebSocket do Gateway (ws://...ouwss://...)token: um token de pareamento de curta duração
Treat the setup code like a password while it is valid.
Aprovar um dispositivo de nó¶
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
Armazenamento do estado de pareamento de nós¶
Armazenado em ~/.openclaw/devices/:
pending.json(curta duração; solicitações pendentes expiram)paired.json(dispositivos pareados + tokens)
Notas¶
- A API legada
node.pair.*(CLI:openclaw nodes pending/approve) é um armazenamento de pareamento separado, de propriedade do gateway. Nós WS ainda exigem pareamento de dispositivo.