Canal Nostr de OpenClaw

A diferencia de las plataformas de mensajería centralizadas, Nostr es un protocolo descentralizado donde los mensajes se distribuyen a través de servidores relay independientes. OpenClaw se conecta a uno o más relays vía WebSocket y se suscribe a mensajes directos cifrados con NIP-04 dirigidos a la clave pública del bot. El flujo de mensajes es directo: 1. Un usuario envía un DM cifrado desde cualquier cliente de Nostr (Damus, Amethyst, Primal, etc.) 2. El mensaje se propaga a los relays a los que el usuario publica 3. La suscripción del relay de OpenClaw detecta el evento 4. El Gateway descifra el mensaje, lo procesa a través de tu agente de IA, cifra la respuesta y la publica de vuelta en los relays configurados Dado que Nostr se basa en relays, no existe un punto único de fallo — si un relay se cae, los mensajes pueden seguir fluyendo a través de otros. El bot y sus usuarios no necesitan usar exactamente los mismos relays, ya que los relays suelen intercambiar eventos entre sí.

El canal de Nostr se distribuye como un plugin opcional de OpenClaw en lugar de estar integrado en el Gateway base. Esto mantiene la instalación base ligera mientras te permite añadir soporte para Nostr cuando sea necesario. Existen varios métodos de instalación: • **npm (recomendado):** Ejecuta 'openclaw plugins install @openclaw/nostr' para instalar la versión estable. • **Canal beta:** Usa 'openclaw plugins install @openclaw/nostr@beta' para funciones en versión preliminar. • **Desarrollo local:** Clona el repositorio del plugin y usa 'openclaw plugins install --link /path/to/local/checkout' para vincularlo. • **Configuración interactiva:** Ejecuta 'openclaw onboard' o 'openclaw channels add' y selecciona Nostr de la lista. Después de la instalación, reinicia el Gateway para que el plugin surta efecto.

La identidad en Nostr se basa en criptografía de clave pública. La identidad de tu bot es su par de claves — una clave privada (nsec) utilizada para firmar y descifrar, y una clave pública (npub) utilizada como su dirección. Genera un par de claves usando la herramienta CLI 'nak': 1. Instala nak: 'go install github.com/fiatjaf/nak@latest' (o descárgalo desde las versiones publicadas) 2. Genera: 'nak key generate' — esto genera la clave privada en formato hex 3. Deriva la clave pública: 'nak key public <hex-private-key>' — conviértela a npub si es necesario OpenClaw acepta claves privadas tanto en formato nsec (codificado en Bech32) como en formato hexadecimal de 64 caracteres. Las claves públicas en allowFrom pueden usar formato npub o hexadecimal.

{
  "channels": {
    "nostr": {
      "privateKey": "${NOSTR_PRIVATE_KEY}"
    }
  }
}

Los relays son la columna vertebral de Nostr — almacenan y distribuyen eventos. OpenClaw se conecta a tus relays configurados vía WebSocket para enviar y recibir DMs cifrados. La configuración por defecto usa dos relays públicos conocidos: relay.damus.io y nos.lol. Para uso en producción, deberías personalizar esto según tus necesidades. Consejos para la selección de relays: • Usa 2–3 relays para un buen equilibrio entre redundancia y rendimiento • Demasiados relays aumentan la latencia y el uso de ancho de banda • Los relays de pago (por ejemplo, relay.nostr.band) ofrecen mejor fiabilidad y menos spam • Para desarrollo, ejecuta un relay local (por ejemplo, Strfry vía Docker) en ws://localhost:7777

{
  "channels": {
    "nostr": {
      "relays": [
        "wss://relay.damus.io",
        "wss://nos.lol",
        "wss://relay.nostr.band"
      ]
    }
  }
}

Las políticas de DM (mensaje directo) controlan quién puede interactuar con tu asistente de IA a través de Nostr. Dado que Nostr es abierto por diseño, el control de acceso es especialmente importante para prevenir el uso no autorizado de tu cuota de IA. OpenClaw admite cuatro políticas: • **pairing (por defecto)** — Los remitentes desconocidos reciben un código de emparejamiento. Los apruebas o rechazas mediante 'openclaw pairing approve nostr <code>'. Una vez aprobados, pueden chatear libremente. • **allowlist** — Solo las claves públicas (npub o hexadecimal) listadas en allowFrom pueden enviar mensajes al bot. Todos los demás son ignorados silenciosamente. • **open** — Cualquiera puede enviar mensajes al bot. Requiere allowFrom: ["*"] para habilitarse. Úsalo con precaución. • **disabled** — El bot no responde a ningún DM entrante.

{
  "channels": {
    "nostr": {
      "dmPolicy": "allowlist",
      "allowFrom": [
        "npub1abc...xyz",
        "npub1def...uvw"
      ]
    }
  }
}

Puedes publicar un perfil para tu bot en la red Nostr usando eventos de metadatos kind:0 de NIP-01. Esto hace que tu bot sea descubrible en los clientes de Nostr — los usuarios verán su nombre, avatar, biografía y otros detalles cuando busquen el npub del bot. Los campos de perfil configurables incluyen: • **name** — Nombre de usuario corto (por ejemplo, "openclaw-bot") • **display_name** — Nombre para mostrar completo • **about** — Biografía / descripción • **picture** — URL del avatar (debe ser HTTPS) • **banner** — URL de la imagen de banner (debe ser HTTPS) • **website** — Sitio web del bot o proyecto • **nip05** — Identificador de verificación NIP-05 (por ejemplo, "bot@yourdomain.com") • **lud16** — Dirección Lightning para zaps

{
  "channels": {
    "nostr": {
      "profile": {
        "name": "openclaw-bot",
        "display_name": "OpenClaw AI Assistant",
        "about": "AI-powered assistant on Nostr. DM me!",
        "picture": "https://example.com/bot-avatar.png",
        "nip05": "bot@yourdomain.com"
      }
    }
  }
}

Todos los mensajes directos en la integración de Nostr de OpenClaw utilizan cifrado NIP-04 — los mensajes se cifran con un secreto compartido derivado de los pares de claves del remitente y el destinatario usando ECDH (Elliptic Curve Diffie-Hellman). NIPs actualmente soportados: • **NIP-01** — Protocolo básico: eventos, suscripciones, metadatos (kind:0) • **NIP-04** — Mensajes directos cifrados (kind:4) Soporte futuro planificado: • **NIP-17** — Mensajes privados con envoltura de regalo (privacidad de metadatos mejorada) • **NIP-44** — Cifrado versionado (primitivas criptográficas más robustas) Aunque NIP-04 es ampliamente soportado en todos los clientes de Nostr, tiene fugas de metadatos conocidas (los operadores de relays pueden ver quién está enviando mensajes a quién, aunque no el contenido). NIP-17 y NIP-44 abordarán estas limitaciones una vez que sean adoptados.

Para desarrollo y pruebas, puedes ejecutar un relay de Nostr local en lugar de conectarte a relays públicos. El enfoque recomendado usa Strfry, un relay de alto rendimiento que se ejecuta fácilmente mediante Docker. Pasos de configuración: 1. Ejecuta el relay: 'docker run -p 7777:7777 hoytech/strfry' 2. Configura OpenClaw para usar el relay local: ws://localhost:7777 3. Inicia el Gateway 4. Usa un cliente de Nostr configurado para conectarse a tu relay local para enviar DMs de prueba Esto aísla tus pruebas de la red pública de Nostr y proporciona ciclos de iteración más rápidos.

{
  "channels": {
    "nostr": {
      "relays": ["ws://localhost:7777"],
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}