Canal Nostr do OpenClaw

Diferente das plataformas de mensagens centralizadas, o Nostr e um protocolo descentralizado onde as mensagens sao distribuidas por servidores de relay independentes. O OpenClaw se conecta a um ou mais relays via WebSocket e se inscreve para receber mensagens diretas criptografadas via NIP-04 enderecadas a chave publica do bot. O fluxo de mensagens e direto: 1. Um usuario envia um DM criptografado a partir de qualquer cliente Nostr (Damus, Amethyst, Primal, etc.) 2. A mensagem se propaga para os relays nos quais o usuario publica 3. A inscricao de relay do OpenClaw captura o evento 4. O Gateway descriptografa a mensagem, processa-a pelo seu agente de IA, criptografa a resposta e publica-a de volta nos relays configurados Como o Nostr e baseado em relays, nao ha um ponto unico de falha - se um relay cair, as mensagens ainda podem fluir por outros. O bot e seus usuarios nao precisam usar exatamente os mesmos relays, pois os relays frequentemente trocam eventos entre si.

O canal Nostr e distribuido como um plugin opcional do OpenClaw, em vez de ser integrado ao Gateway principal. Isso mantem a instalacao base leve, permitindo adicionar suporte ao Nostr quando necessario. Existem varios metodos de instalacao: * **npm (recomendado):** Execute 'openclaw plugins install @openclaw/nostr' para instalar a versao estavel. * **Canal beta:** Use 'openclaw plugins install @openclaw/nostr@beta' para recursos em pre-lancamento. * **Desenvolvimento local:** Clone o repositorio do plugin e use 'openclaw plugins install --link /caminho/para/checkout/local' para vincula-lo. * **Configuracao interativa:** Execute 'openclaw onboard' ou 'openclaw channels add' e selecione Nostr na lista. Apos a instalacao, reinicie o Gateway para que o plugin entre em vigor.

A identidade no Nostr e baseada em criptografia de chave publica. A identidade do seu bot e seu par de chaves - uma chave privada (nsec) usada para assinar e descriptografar, e uma chave publica (npub) usada como seu endereco. Gere um par de chaves usando a ferramenta CLI 'nak': 1. Instale o nak: 'go install github.com/fiatjaf/nak@latest' (ou baixe dos releases) 2. Gere: 'nak key generate' - isso retorna a chave privada no formato hex 3. Derive a chave publica: 'nak key public <hex-private-key>' - converta para npub se necessario O OpenClaw aceita chaves privadas nos formatos nsec (codificado em Bech32) e hex de 64 caracteres. Chaves publicas em allowFrom podem usar o formato npub ou hex.

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

Os relays sao a espinha dorsal do Nostr - eles armazenam e distribuem eventos. O OpenClaw se conecta aos relays configurados via WebSocket para enviar e receber DMs criptografados. A configuracao padrao usa dois relays publicos conhecidos: relay.damus.io e nos.lol. Para uso em producao, voce deve personalizar isso de acordo com suas necessidades. Dicas para selecao de relays: * Use 2-3 relays para um bom equilibrio entre redundancia e desempenho * Muitos relays aumentam a latencia e o uso de largura de banda * Relays pagos (ex.: relay.nostr.band) oferecem maior confiabilidade e menos spam * Para desenvolvimento, execute um relay local (ex.: Strfry via Docker) em ws://localhost:7777

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

As politicas de DM (Mensagem Direta) controlam quem pode interagir com seu assistente de IA pelo Nostr. Como o Nostr e aberto por design, o controle de acesso e especialmente importante para evitar o uso nao autorizado da sua cota de IA. O OpenClaw suporta quatro politicas: * **pairing (padrao)** - Remetentes desconhecidos recebem um codigo de pareamento. Voce aprova ou recusa via 'openclaw pairing approve nostr <code>'. Uma vez aprovados, eles podem conversar livremente. * **allowlist** - Apenas chaves publicas (npub ou hex) listadas em allowFrom podem enviar mensagens ao bot. Todos os outros sao ignorados silenciosamente. * **open** - Qualquer pessoa pode enviar mensagens ao bot. Requer allowFrom: ["*"] para habilitar. Use com cautela. * **disabled** - O bot nao responde a nenhum DM recebido.

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

Voce pode publicar um perfil para seu bot na rede Nostr usando eventos de metadados kind:0 do NIP-01. Isso torna seu bot descobrivel em clientes Nostr - os usuarios verao seu nome, avatar, biografia e outros detalhes ao consultar o npub do bot. Campos de perfil configuraveis incluem: * **name** - Nome de usuario curto (ex.: "openclaw-bot") * **display_name** - Nome de exibicao completo * **about** - Biografia / descricao * **picture** - URL do avatar (deve ser HTTPS) * **banner** - URL da imagem de banner (deve ser HTTPS) * **website** - Site do bot ou projeto * **nip05** - Identificador de verificacao NIP-05 (ex.: "bot@yourdomain.com") * **lud16** - Endereco 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"
      }
    }
  }
}

Todas as mensagens diretas na integracao Nostr do OpenClaw usam criptografia NIP-04 - as mensagens sao criptografadas com um segredo compartilhado derivado dos pares de chaves do remetente e do destinatario usando ECDH (Elliptic Curve Diffie-Hellman). NIPs atualmente suportados: * **NIP-01** - Protocolo basico: eventos, inscricoes, metadados (kind:0) * **NIP-04** - Mensagens diretas criptografadas (kind:4) Suporte futuro planejado: * **NIP-17** - Mensagens privadas com encapsulamento (privacidade de metadados aprimorada) * **NIP-44** - Criptografia versionada (primitivas criptograficas mais robustas) Embora o NIP-04 seja amplamente suportado em todos os clientes Nostr, ele possui vazamentos de metadados conhecidos (operadores de relay podem ver quem esta enviando mensagens para quem, embora nao o conteudo). O NIP-17 e o NIP-44 resolverao essas limitacoes assim que forem adotados.

Para desenvolvimento e testes, voce pode executar um relay Nostr local em vez de se conectar a relays publicos. A abordagem recomendada usa o Strfry, um relay de alto desempenho que pode ser executado facilmente via Docker. Passos de configuracao: 1. Execute o relay: 'docker run -p 7777:7777 hoytech/strfry' 2. Configure o OpenClaw para usar o relay local: ws://localhost:7777 3. Inicie o Gateway 4. Use um cliente Nostr configurado para conectar ao seu relay local para enviar DMs de teste Isso isola seus testes da rede publica Nostr e proporciona ciclos de iteracao mais rapidos.

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