Nostr

​

Instalação

openclaw plugins install @openclaw/nostr

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

​

Configuração não interativa

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"

​

Configuração rápida

1. Gere um par de chaves Nostr (se necessário):

# Usando nak
nak key generate

2. Adicione à configuração:

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

3. Exporte a chave:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Reinicie o Gateway.

​

Referência de configuração

​

Metadados do perfil

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Bot de mensagens diretas que atua como assistente pessoal",
        picture: "https://example.com/avatar.png",
        banner: "https://example.com/banner.png",
        website: "https://example.com",
        nip05: "openclaw@example.com",
        lud16: "openclaw@example.com",
      },
    },
  },
}

• As URLs do perfil devem usar https://.
• A importação de relays mescla os campos e preserva as substituições locais.

​

Controle de acesso

​

Políticas de mensagens diretas

• pairing (padrão): remetentes desconhecidos recebem um código de pareamento.
• allowlist: somente chaves públicas em allowFrom podem enviar mensagens diretas.
• open: mensagens diretas públicas de entrada (requer allowFrom: ["*"]).
• disabled: ignora mensagens diretas de entrada.

• As assinaturas dos eventos de entrada são verificadas antes da política de remetentes e da descriptografia NIP-04; assim, eventos falsificados são rejeitados antecipadamente.
• As respostas de pareamento são enviadas sem descriptografar nem processar o conteúdo da mensagem direta original.
• As mensagens diretas de entrada têm limitação de taxa (global e por remetente), e conteúdos grandes demais são descartados antes da descriptografia.

​

Exemplo de lista de permissões

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

​

Formatos de chave

• Chave privada: nsec... ou hexadecimal com 64 caracteres
• Chaves públicas (allowFrom): npub... ou hexadecimal

​

Relays

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

• Use de 2 a 3 relays para redundância.
• Evite relays demais (latência e duplicação).
• Relays pagos podem aumentar a confiabilidade.
• Relays locais são adequados para testes (ws://localhost:7777).

​

Compatibilidade com protocolos

​

Testes

​

Relay local

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

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

​

Teste manual

1. Anote a chave pública do bot nos logs do Gateway ou em openclaw channels status (hexadecimal; converta para npub no seu cliente, se necessário).
2. Abra um cliente Nostr (Amethyst, Damus etc.).
3. Envie uma mensagem direta para a chave pública do bot.
4. Verifique a resposta.

​

Solução de problemas

​

Mensagens não são recebidas

• Verifique se a chave privada é válida.
• Certifique-se de que as URLs dos relays estejam acessíveis e usem wss:// (ou ws:// para um relay local).
• Confirme que enabled não seja false.
• Verifique os logs do Gateway em busca de erros de conexão com relays.

​

Respostas não são enviadas

• Verifique se o relay aceita gravações.
• Verifique a conectividade de saída.
• Observe possíveis limites de taxa dos relays.

​

Respostas duplicadas

• Isso é esperado ao usar vários relays.
• As mensagens são desduplicadas pelo ID do evento; somente a primeira entrega aciona uma resposta.

​

Segurança

• Nunca faça commit de chaves privadas.
• Use variáveis de ambiente para as chaves.
• Considere usar allowlist para bots em produção.
• As assinaturas são verificadas antes da política de remetentes, e essa política é aplicada antes da descriptografia; assim, eventos falsificados são rejeitados antecipadamente e remetentes desconhecidos não podem forçar a execução de todo o processamento criptográfico.

​

Limitações (MVP)

• Somente mensagens diretas (sem conversas em grupo).
• Sem anexos de mídia.
• Somente NIP-04 (encapsulamento NIP-17 planejado).

​

Conteúdo relacionado

• Visão geral dos canais — todos os canais compatíveis
• Pareamento — autenticação de mensagens diretas e fluxo de pareamento
• Grupos — comportamento de conversas em grupo e controle por menções
• Roteamento de canais — roteamento de sessões para mensagens
• Segurança — modelo de acesso e proteção