Nostr

​

Instalación

openclaw plugins install @openclaw/nostr

openclaw plugins install --link <path-to-local-nostr-plugin>

​

Configuración no interactiva

openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"
openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY" --relay-urls "wss://relay.damus.io,wss://relay.primal.net"

​

Configuración rápida

1. Genere un par de claves de Nostr (si es necesario):

# Mediante nak
nak key generate

2. Añádalo a la configuración:

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

3. Exporte la clave:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Reinicie el gateway.

​

Referencia de configuración

​

Metadatos del perfil

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Bot asistente personal para mensajes directos",
        picture: "https://example.com/avatar.png",
        banner: "https://example.com/banner.png",
        website: "https://example.com",
        nip05: "openclaw@example.com",
        lud16: "openclaw@example.com",
      },
    },
  },
}

• Las URL del perfil deben usar https://.
• Al importar desde relés, se combinan los campos y se conservan las anulaciones locales.

​

Control de acceso

​

Políticas de mensajes directos

• emparejamiento (predeterminado): los remitentes desconocidos reciben un código de emparejamiento.
• lista de permitidos: solo las claves públicas incluidas en allowFrom pueden enviar mensajes directos.
• abierta: mensajes directos entrantes públicos (requiere allowFrom: ["*"]).
• deshabilitada: se ignoran los mensajes directos entrantes.

• Las firmas de los eventos entrantes se verifican antes de aplicar la política de remitentes y descifrar mediante NIP-04, por lo que los eventos falsificados se rechazan de inmediato.
• Las respuestas de emparejamiento se envían sin descifrar ni procesar el cuerpo del mensaje directo original.
• Se limita la frecuencia de los mensajes directos entrantes (globalmente y por remitente), y las cargas útiles demasiado grandes se descartan antes de descifrarlas.

​

Ejemplo de lista de permitidos

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      dmPolicy: "allowlist",
      allowFrom: ["npub1abc...", "npub1xyz..."],
    },
  },
}

​

Formatos de clave

• Clave privada: nsec... o una cadena hexadecimal de 64 caracteres
• Claves públicas (allowFrom): npub... o formato hexadecimal

​

Relés

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      relays: ["wss://relay.damus.io", "wss://relay.primal.net", "wss://nostr.wine"],
    },
  },
}

• Use entre 2 y 3 relés para obtener redundancia.
• Evite usar demasiados relés (latencia y duplicación).
• Los relés de pago pueden mejorar la fiabilidad.
• Los relés locales son adecuados para las pruebas (ws://localhost:7777).

​

Compatibilidad con protocolos

​

Pruebas

​

Relé local

# Iniciar strfry
docker run -p 7777:7777 ghcr.io/hoytech/strfry

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      relays: ["ws://localhost:7777"],
    },
  },
}

​

Prueba manual

1. Anote la clave pública del bot que aparece en los registros del gateway o en openclaw channels status (hexadecimal; conviértala a npub en su cliente si es necesario).
2. Abra un cliente de Nostr (Amethyst, Damus, etc.).
3. Envíe un mensaje directo a la clave pública del bot.
4. Verifique la respuesta.

​

Solución de problemas

​

No se reciben mensajes

• Verifique que la clave privada sea válida.
• Asegúrese de que las URL de los relés sean accesibles y usen wss:// (o ws:// para conexiones locales).
• Confirme que enabled no sea false.
• Compruebe si hay errores de conexión con los relés en los registros del gateway.

​

No se envían respuestas

• Compruebe que el relé acepte escrituras.
• Verifique la conectividad saliente.
• Compruebe si se alcanzan los límites de frecuencia del relé.

​

Respuestas duplicadas

• Es algo esperado cuando se usan varios relés.
• Los mensajes se deduplican mediante el identificador del evento; solo la primera entrega desencadena una respuesta.

​

Seguridad

• Nunca confirme claves privadas en el repositorio.
• Use variables de entorno para las claves.
• Considere allowlist para bots de producción.
• Las firmas se verifican antes de aplicar la política de remitentes, y esta se aplica antes de descifrar, por lo que los eventos falsificados se rechazan de inmediato y los remitentes desconocidos no pueden forzar la ejecución completa de las operaciones criptográficas.

​

Limitaciones (MVP)

• Solo mensajes directos (sin chats grupales).
• Sin archivos multimedia adjuntos.
• Solo NIP-04 (se prevé la envoltura de regalo de NIP-17).

​

Contenido relacionado

• Descripción general de los canales — todos los canales compatibles
• Emparejamiento — autenticación de mensajes directos y flujo de emparejamiento
• Grupos — comportamiento de los chats grupales y restricción mediante menciones
• Enrutamiento de canales — enrutamiento de sesiones para los mensajes
• Seguridad — modelo de acceso y refuerzo de la seguridad