Emparejamiento¶
“El emparejamiento” es el paso explícito de aprobación del propietario de OpenClaw. Se utiliza en dos lugares:
- Emparejamiento de mensajes directos (DM) (quién tiene permitido hablar con el bot)
- Emparejamiento de nodos (qué dispositivos/nodos tienen permitido unirse a la red del Gateway)
Contexto de seguridad: Security
1. Emparejamiento de mensajes directos (acceso entrante al chat)¶
Cuando un canal se configura con la política de mensajes directos pairing, los remitentes desconocidos reciben un código corto y su mensaje no se procesa hasta que usted apruebe.
Las políticas predeterminadas de mensajes directos están documentadas en: Security
Códigos de emparejamiento:
- 8 caracteres, en mayúsculas, sin caracteres ambiguos (
0O1I). - Expiran después de 1 hora. El bot solo envía el mensaje de emparejamiento cuando se crea una nueva solicitud (aproximadamente una vez por hora por remitente).
- Las solicitudes pendientes de emparejamiento de mensajes directos están limitadas a 3 por canal de forma predeterminada; las solicitudes adicionales se ignoran hasta que una expire o sea aprobada.
Aprobar un remitente¶
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
Canales compatibles: telegram, whatsapp, signal, imessage, discord, slack.
Dónde vive el estado¶
Almacenado bajo ~/.openclaw/credentials/:
- Solicitudes pendientes:
<channel>-pairing.json - Almacén de lista de permitidos aprobados:
<channel>-allowFrom.json
Trate estos elementos como sensibles (controlan el acceso a su asistente).
2. Emparejamiento de dispositivos de nodo (nodos iOS/Android/macOS/headless)¶
Los nodos se conectan al Gateway como dispositivos con role: node. El Gateway
crea una solicitud de emparejamiento de dispositivo que debe ser aprobada.
Emparejar vía Telegram (recomendado para iOS)¶
Si usas el plugin device-pair, puedes realizar el emparejamiento inicial del dispositivo completamente desde Telegram:
- En Telegram, envía un mensaje a tu bot:
/pair - El bot responde con dos mensajes: un mensaje de instrucciones y un código de configuración separado (fácil de copiar/pegar en Telegram).
- En tu teléfono, abre la app de OpenClaw en iOS → Settings → Gateway.
- Pega el código de configuración y conéctate.
- De vuelta en Telegram:
/pair approve
El código de configuración es una carga útil JSON codificada en base64 que contiene:
url: the Gateway WebSocket URL (ws://...orwss://...)token: a short-lived pairing token
Treat the setup code like a password while it is valid.
Aprobar un dispositivo de nodo¶
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
Almacenamiento del estado de emparejamiento de nodos¶
Almacenado bajo ~/.openclaw/devices/:
pending.json(de corta duración; las solicitudes pendientes expiran)paired.json(dispositivos emparejados + tokens)
Notas¶
- La API heredada
node.pair.*(CLI:openclaw nodes pending/approve) es un almacén de emparejamiento independiente propiedad del Gateway. Los nodos WS aún requieren emparejamiento de dispositivos.