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-символьный hex
• Открытые ключи (allowFrom): npub... или hex

​

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

{
  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 (hex; при необходимости преобразуйте его в npub в своем клиенте).
2. Откройте клиент Nostr (Amethyst, Damus и т. п.).
3. Отправьте личное сообщение на открытый ключ бота.
4. Убедитесь, что получен ответ.

​

Устранение неполадок

​

Сообщения не поступают

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

​

Ответы не отправляются

• Убедитесь, что ретранслятор принимает запись.
• Проверьте исходящее подключение.
• Проверьте, не применяет ли ретранслятор ограничения частоты запросов.

​

Дублирующиеся ответы

• Это ожидаемо при использовании нескольких ретрансляторов.
• Сообщения дедуплицируются по идентификатору события; ответ формируется только при первой доставке.

​

Безопасность

• Никогда не добавляйте закрытые ключи в репозиторий.
• Используйте переменные окружения для ключей.
• Для рабочих ботов рассмотрите возможность использования allowlist.
• Подписи проверяются до применения политики отправителей, а политика отправителей применяется до расшифровки, поэтому поддельные события отклоняются на раннем этапе, а неизвестные отправители не могут принудительно запустить полный набор криптографических операций.

​

Ограничения (MVP)

• Только личные сообщения (без групповых чатов).
• Медиавложения не поддерживаются.
• Поддерживается только NIP-04 (поддержка подарочной упаковки NIP-17 запланирована).

​

Связанные материалы

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