Nostr

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Plugin incluido

​

Instalaciones antiguas/personalizadas

• La incorporación (openclaw onboard) y openclaw channels add siguen mostrando Nostr desde el catálogo compartido de canales.
• Si tu compilación excluye Nostr incluido, instala el paquete npm directamente.

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 URL de perfil deben usar https://.
• Importar desde relés combina campos y conserva las anulaciones locales.

​

Control de acceso

​

Políticas de DM

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

• Las firmas de eventos entrantes se verifican antes de la política de remitente y del descifrado NIP-04, por lo que los eventos falsificados se rechazan pronto.
• Las respuestas de emparejamiento se envían sin procesar el cuerpo del DM original.
• Los DM entrantes tienen límite de tasa 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 fiabilidad.
• Los relés locales son adecuados para pruebas (ws://localhost:7777).

​

Compatibilidad 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 (npub) desde los registros.
2. Abre un cliente de Nostr (Damus, Amethyst, etc.).
3. Envía un DM a la pubkey del bot.
4. Verifica la respuesta.

​

Solución de problemas

​

No se reciben mensajes

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

​

No se envían respuestas

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

​

Respuestas duplicadas

• Es esperado cuando se usan varios relés.
• Los mensajes se deduplican por ID de evento; solo la primera entrega activa una respuesta.

​

Seguridad

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

​

Limitaciones (MVP)

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

​

Relacionado

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