Nostr

​

Instalar

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. Genera un par de claves de Nostr (si es necesario):

# Using nak
nak key generate

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

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

3. Exporta la clave:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Reinicia el Gateway.

​

Referencia de configuración

​

Metadatos de perfil

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Personal assistant DM bot",
        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 URLs de perfil deben usar https://.
• Importar desde relés fusiona campos y conserva las anulaciones locales.

​

Control de acceso

​

Políticas de mensajes directos

• pairing (predeterminada): los remitentes desconocidos reciben un código de emparejamiento.
• allowlist: solo las pubkeys en allowFrom pueden enviar mensajes directos.
• open: mensajes directos entrantes públicos (requiere allowFrom: ["*"]).
• disabled: ignorar mensajes directos entrantes.

• Las firmas de eventos entrantes se verifican antes de la política de remitentes y del descifrado NIP-04, por lo que los eventos falsificados se rechazan temprano.
• Las respuestas de emparejamiento se envían sin descifrar ni procesar el cuerpo del mensaje directo original.
• Los mensajes directos entrantes tienen límite de tasa (global y por remitente), y las cargas sobredimensionadas se descartan antes del descifrado.

​

Ejemplo de allowlist

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

​

Formatos de clave

• Clave privada: nsec... o hexadecimal de 64 caracteres
• Pubkeys (allowFrom): npub... o hexadecimal

​

Relés

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

• Usa 2-3 relés para redundancia.
• Evita demasiados relés (latencia, duplicación).
• Los relés de pago pueden mejorar la confiabilidad.
• Los relés locales sirven para pruebas (ws://localhost:7777).

​

Soporte de protocolo

​

Pruebas

​

Relé local

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

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

​

Prueba manual

1. Anota la pubkey del bot desde los registros del Gateway o openclaw channels status (hexadecimal; conviértela a npub en tu cliente si es necesario).
2. Abre un cliente de Nostr (Amethyst, Damus, etc.).
3. Envía un mensaje directo a la pubkey del bot.
4. Verifica la respuesta.

​

Solución de problemas

​

No recibe mensajes

• Verifica que la clave privada sea válida.
• Asegúrate de que las URLs de relés sean accesibles y usen wss:// (o ws:// para local).
• Confirma que enabled no sea false.
• Revisa los registros del Gateway en busca de errores de conexión con relés.

​

No envía respuestas

• Comprueba que el relé acepte escrituras.
• Verifica la conectividad saliente.
• Vigila los límites de tasa del relé.

​

Respuestas duplicadas

• Es esperable al usar varios relés.
• Los mensajes se deduplican por ID de evento; solo la primera entrega desencadena una respuesta.

​

Seguridad

• Nunca confirmes claves privadas en el repositorio.
• Usa variables de entorno para las claves.
• Considera allowlist para bots de producción.
• Las firmas se verifican antes de la política de remitentes, y la política de remitentes se aplica antes del descifrado, por lo que los eventos falsificados se rechazan temprano y los remitentes desconocidos no pueden forzar trabajo criptográfico completo.

​

Limitaciones (MVP)

• Solo mensajes directos (sin chats grupales).
• Sin adjuntos multimedia.
• Solo NIP-04 (envoltorio tipo regalo de NIP-17 planificado).

​

Relacionado

• Descripción general de canales — todos los canales compatibles
• Emparejamiento — autenticación de mensajes directos y flujo de emparejamiento
• Grupos — comportamiento de chats grupales y control por menciones
• Enrutamiento de canales — enrutamiento de sesiones para mensajes
• Seguridad — modelo de acceso y endurecimiento