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.

​

Paketlenmiş Plugin

​

Eski/özel kurulumlar

• Onboarding (openclaw onboard) ve openclaw channels add, Nostr’u paylaşılan kanal kataloğundan göstermeye devam eder.
• Derlemeniz paketlenmiş Nostr’u hariç tutuyorsa npm paketini doğrudan kurun.

openclaw plugins install @openclaw/nostr

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

​

Etkileşimsiz kurulum

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"

​

Hızlı kurulum

1. Bir Nostr anahtar çifti oluşturun (gerekiyorsa):

# Using nak
nak key generate

2. Yapılandırmaya ekleyin:

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

3. Anahtarı dışa aktarın:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Gateway’i yeniden başlatın.

​

Yapılandırma başvurusu

​

Profil meta verileri

{
  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",
      },
    },
  },
}

• Profil URL’leri https:// kullanmalıdır.
• Relay’lerden içe aktarma alanları birleştirir ve yerel geçersiz kılmaları korur.

​

Erişim denetimi

​

DM ilkeleri

• pairing (varsayılan): bilinmeyen gönderenler bir eşleştirme kodu alır.
• allowlist: yalnızca allowFrom içindeki pubkey’ler DM gönderebilir.
• open: herkese açık gelen DM’ler (allowFrom: ["*"] gerektirir).
• disabled: gelen DM’leri yok sayar.

• Gelen olay imzaları, gönderen ilkesi ve NIP-04 şifre çözümünden önce doğrulanır; böylece sahte olaylar erken reddedilir.
• Eşleştirme yanıtları, özgün DM gövdesi işlenmeden gönderilir.
• Gelen DM’ler hız sınırlamasına tabidir ve aşırı büyük yükler şifre çözmeden önce düşürülür.

​

Allowlist örneği

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

​

Anahtar biçimleri

• Özel anahtar: nsec... veya 64 karakterlik hex
• Pubkey’ler (allowFrom): npub... veya hex

​

Relay’ler

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

• Yedeklilik için 2-3 relay kullanın.
• Çok fazla relay’den kaçının (gecikme, çoğaltma).
• Ücretli relay’ler güvenilirliği artırabilir.
• Yerel relay’ler test için uygundur (ws://localhost:7777).

​

Protokol desteği

​

Test etme

​

Yerel relay

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

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

​

Manuel test

1. Günlüklerden bot pubkey’ini (npub) not edin.
2. Bir Nostr istemcisi açın (Damus, Amethyst vb.).
3. Bot pubkey’ine DM gönderin.
4. Yanıtı doğrulayın.

​

Sorun giderme

​

Mesajlar alınmıyor

• Özel anahtarın geçerli olduğunu doğrulayın.
• Relay URL’lerinin erişilebilir olduğundan ve wss:// (veya yerel için ws://) kullandığından emin olun.
• enabled değerinin false olmadığını doğrulayın.
• Relay bağlantı hataları için Gateway günlüklerini kontrol edin.

​

Yanıtlar gönderilmiyor

• Relay’in yazmaları kabul ettiğini kontrol edin.
• Giden bağlantıyı doğrulayın.
• Relay hız sınırlarını izleyin.

​

Yinelenen yanıtlar

• Birden fazla relay kullanırken beklenir.
• Mesajlar olay kimliğine göre tekilleştirilir; yalnızca ilk teslimat bir yanıt tetikler.

​

Güvenlik

• Özel anahtarları asla commit etmeyin.
• Anahtarlar için ortam değişkenleri kullanın.
• Üretim botları için allowlist kullanmayı değerlendirin.
• İmzalar gönderen ilkesinden önce doğrulanır ve gönderen ilkesi şifre çözmeden önce uygulanır; böylece sahte olaylar erken reddedilir ve bilinmeyen gönderenler tam kripto çalışmasını zorlayamaz.

​

Sınırlamalar (MVP)

• Yalnızca doğrudan mesajlar (grup sohbeti yok).
• Medya ekleri yok.
• Yalnızca NIP-04 (NIP-17 hediye paketleme planlandı).

​

İlgili

• Kanallara Genel Bakış — desteklenen tüm kanallar
• Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar — grup sohbeti davranışı ve bahsetme kapısı
• Kanal Yönlendirme — mesajlar için oturum yönlendirmesi
• Güvenlik — erişim modeli ve sıkılaştırma