Nostr

​

Встановлення

openclaw plugins install @openclaw/nostr

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

​

Неінтерактивне налаштування

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"

​

Швидке налаштування

1. Створіть пару ключів Nostr (за потреби):

# За допомогою nak
nak key generate

2. Додайте до конфігурації:

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

3. Експортуйте ключ:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Перезапустіть Gateway.

​

Довідник із конфігурації

​

Метадані профілю

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Персональний бот-помічник для особистих повідомлень",
        picture: "https://example.com/avatar.png",
        banner: "https://example.com/banner.png",
        website: "https://example.com",
        nip05: "openclaw@example.com",
        lud16: "openclaw@example.com",
      },
    },
  },
}

• URL-адреси профілю мають використовувати https://.
• Під час імпорту з ретрансляторів поля об’єднуються, а локальні перевизначення зберігаються.

​

Керування доступом

​

Політики особистих повідомлень

• pairing (за замовчуванням): невідомі відправники отримують код сполучення.
• allowlist: надсилати особисті повідомлення можуть лише відкриті ключі з allowFrom.
• open: загальнодоступні вхідні особисті повідомлення (потрібне allowFrom: ["*"]).
• disabled: ігнорувати вхідні особисті повідомлення.

• Підписи вхідних подій перевіряються до застосування політики відправника й розшифрування NIP-04, тому підроблені події відхиляються на ранньому етапі.
• Відповіді для сполучення надсилаються без розшифрування чи обробки початкового вмісту особистого повідомлення.
• Частота вхідних особистих повідомлень обмежується глобально й окремо для кожного відправника, а завеликі корисні навантаження відкидаються до розшифрування.

​

Приклад списку дозволених

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

​

Формати ключів

• Закритий ключ: nsec... або 64-символьне шістнадцяткове значення
• Відкриті ключі (allowFrom): npub... або шістнадцяткове значення

​

Ретранслятори

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

• Для резервування використовуйте 2–3 ретранслятори.
• Уникайте надмірної кількості ретрансляторів через затримки й дублювання.
• Платні ретранслятори можуть підвищити надійність.
• Локальні ретранслятори підходять для тестування (ws://localhost:7777).

​

Підтримка протоколів

​

Тестування

​

Локальний ретранслятор

# Запустіть strfry
docker run -p 7777:7777 ghcr.io/hoytech/strfry

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

​

Ручна перевірка

1. Знайдіть відкритий ключ бота в журналах Gateway або за допомогою openclaw channels status (у шістнадцятковому форматі; за потреби перетворіть його на npub у своєму клієнті).
2. Відкрийте клієнт Nostr (Amethyst, Damus тощо).
3. Надішліть особисте повідомлення на відкритий ключ бота.
4. Перевірте відповідь.

​

Усунення несправностей

​

Повідомлення не надходять

• Переконайтеся, що закритий ключ дійсний.
• Переконайтеся, що URL-адреси ретрансляторів доступні та використовують wss:// (або ws:// для локальних ретрансляторів).
• Переконайтеся, що enabled не має значення false.
• Перевірте журнали Gateway на наявність помилок підключення до ретрансляторів.

​

Відповіді не надсилаються

• Перевірте, чи приймає ретранслятор операції запису.
• Перевірте вихідне підключення.
• Зважайте на обмеження частоти запитів ретранслятора.

​

Дубльовані відповіді

• Це очікувана поведінка під час використання кількох ретрансляторів.
• Повідомлення дедуплікуються за ідентифікатором події; відповідь спричиняє лише перше доставлення.

​

Безпека

• Ніколи не фіксуйте закриті ключі в репозиторії.
• Використовуйте змінні середовища для ключів.
• Для робочих ботів варто використовувати allowlist.
• Підписи перевіряються до застосування політики відправника, а політика відправника застосовується до розшифрування, тому підроблені події відхиляються на ранньому етапі, а невідомі відправники не можуть примусово запустити повний обсяг криптографічних обчислень.

​

Обмеження (MVP)

• Лише особисті повідомлення (без групових чатів).
• Без медіавкладень.
• Лише NIP-04 (подарункову обгортку NIP-17 заплановано).

​

Пов’язані матеріали

• Огляд каналів — усі підтримувані канали
• Сполучення — автентифікація особистих повідомлень і процес сполучення
• Групи — поведінка групових чатів і обмеження за згадуваннями
• Маршрутизація каналів — маршрутизація сеансів для повідомлень
• Безпека — модель доступу та посилення захисту