Gestión de nodos con Gateway-owned pairing

Gestionar qué dispositivos pueden conectarse a tu infraestructura suele ser frustrante. A veces necesitas una forma sencilla de ver quién está intentando entrar y decidir en el momento si les das acceso o no, sin complicaciones innecesarias ni configuraciones manuales pesadas.

Con el sistema de Gateway-owned pairing, el Gateway actúa como la única fuente de verdad. Tú decides qué nodos entran y cuáles no desde una interfaz o la CLI.

What You’ll Need

• Gateway activo.
• CLI de OpenClaw instalado.
• Nodos compatibles con WebSockets (WS).

Quick Start

En este flujo, el Gateway decide quién es miembro. Sigue estos pasos para emparejar un nodo:

1. Solicitud: El nodo se conecta al Gateway WS y pide emparejarse. Esto crea una pending request.
2. Verificación: Revisa las solicitudes que esperan aprobación:

   openclaw nodes pending

3. Aprobación: Aprueba la solicitud usando su ID:

   openclaw nodes approve <requestId>

4. Conexión: El Gateway genera un token nuevo. El nodo se reconecta usándolo y queda marcado como “paired”.

Recuerda que las solicitudes pendientes expiran automáticamente tras 5 minutos.

Flujo de trabajo en CLI

Si trabajas en entornos headless, la CLI es tu mejor herramienta. Aquí tienes los comandos principales:

openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes reject <requestId>
openclaw nodes status
openclaw nodes rename --node &lt;id|name|ip&gt; --name "Living Room iPad"

El comando nodes status te permite ver qué nodos están conectados y qué capacidades tienen.

Detalles de la API y Almacenamiento

Si estás construyendo tu propia integración, el Gateway expone eventos y métodos específicos:

• Eventos: Escucha node.pair.requested para nuevas peticiones o node.pair.resolved para saber si fueron aprobadas, rechazadas o si expiraron.
• Métodos: Usa node.pair.list para ver el estado o node.pair.verify para validar la combinación de { nodeId, token }.

El estado del pairing se guarda localmente en el directorio de estado del Gateway (por defecto ~/.openclaw):

• ~/.openclaw/nodes/paired.json
• ~/.openclaw/nodes/pending.json

Trata el archivo paired.json con cuidado, ya que contiene los tokens de acceso que son secretos.

Troubleshooting

• La solicitud de pairing ha caducado: Las peticiones solo duran 5 minutos. Si el tiempo pasa, el nodo debe iniciar una nueva solicitud.
• El token ya no funciona: Si apruebas un nodo que ya estaba emparejado, el Gateway genera un token nuevo y el anterior queda invalidado. Necesitarás actualizar el nodo con la nueva credencial.

Para resolver dudas específicas sobre tu configuración, consulta el AI Setup Assistant.

What’s Next

• Configuración de la app de macOS y silent approval.
• Gestión de variables de entorno con OPENCLAW_STATE_DIR.