Nodo

Ejecutar un host de nodo headless que se conecta al WebSocket del gateway y expone

''system.run'' / ''system.which'' en la máquina local.

Usa un host de nodo cuando quieres que los agentes ejecuten comandos en otras computadoras en tu

red sin instalar la app companion completa de macOS allí.

Casos de uso comunes:

- Ejecutar comandos en máquinas remotas Linux/Windows (servidores de build, máquinas de lab, NAS).

- Mantener la ejecución sandboxed en el gateway pero delegar ejecuciones aprobadas a otros hosts.

- Proporcionar un objetivo de ejecución ligero y headless para automatización o nodos CI.

La ejecución permanece protegida por aprobaciones de ejecución y listas permitidas por agente en el

host del nodo, para que puedas mantener el acceso a comandos acotado y explícito.

Si ''browser.enabled'' no está, el host del nodo automáticamente anuncia proxy de navegador

deshabilitado en el nodo. Esto permite a los agentes usar automatización de navegador en ese nodo

sin configuración extra.

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

openclaw node run --host <gateway-host> --port 18789

Opciones:

- ''--host <host>'': Host WebSocket del Gateway (por defecto: ''127.0.0.1'')

- ''--port <puerto>'': Puerto WebSocket del Gateway (por defecto: ''18789'')

- ''--tls'': Usar TLS para conexión al gateway

- ''--tls-fingerprint <sha256>'': Huella del certificado TLS esperada (sha256)

- ''--node-id <id>'': Sobrescribir ID del nodo (limpia token de emparejamiento)

Instalar host de nodo headless como servicio de usuario.

openclaw node install --host <gateway-host> --port 18789

Opciones:

- ''--host <host>'': Host WebSocket del Gateway (por defecto: ''127.0.0.1'')

- ''--port <puerto>'': Puerto WebSocket del Gateway (por defecto: ''18789'')

- ''--tls'': Usar TLS para conexión al gateway

- ''--tls-fingerprint <sha256>'': Huella del certificado TLS esperada (sha256)

- ''--node-id <id>'': Sobrescribir ID del nodo (limpia token de emparejamiento)

- ''--display-name <nombre>'': Sobrescribir nombre visible del nodo

- ''--runtime <runtime>'': Runtime del servicio (''node'' o ''bun'')

- ''--force'': Reinstalar/sobrescribir (si ya está instalado)

Gestionar servicio:

openclaw node status
openclaw node stop
openclaw node restart
openclaw node uninstall

Usar ''openclaw node run'' como host de nodo en primer plano (sin servicio).

Los comandos de servicio aceptan ''--json'' para salida legible por máquina.

La primera conexión crea una solicitud de emparejamiento de nodo pendiente en el gateway.

Aprobar vía:

openclaw nodes pending
openclaw nodes approve <requestId>

El host del nodo almacena su ID de nodo, token, nombre visible e información de conexión al gateway en

''~/.openclaw/node.json''.

''system.run'' es aprobado por aprobador de ejecución local:

- ''~/.openclaw/exec-approvals.json''

- ''Aprobaciones de ejecución''

- ''openclaw approvals --node <id|nombre|ip>'' (editar desde gateway)