Nostr

Nostr — это загружаемый плагин канала (@openclaw/nostr), который позволяет OpenClaw получать зашифрованные личные сообщения NIP-04 через ретрансляторы Nostr и отвечать на них. Одна учетная запись на Gateway; только личные сообщения.

Установка

openclaw plugins install @openclaw/nostr

Используйте спецификацию пакета без версии, чтобы получать текущий официальный тег выпуска. Закрепляйте точную версию, только если необходима воспроизводимая установка.

Из локальной рабочей копии (для процессов разработки):

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

После установки или включения плагинов перезапустите Gateway. Первоначальная настройка (openclaw onboard) и openclaw channels add отображают Nostr из общего каталога каналов после установки плагина.

Неинтерактивная настройка

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"

Используйте --use-env, чтобы хранить NOSTR_PRIVATE_KEY в окружении, а не сохранять ключ в конфигурации (только для учетной записи по умолчанию).

Быстрая настройка

1. Создайте пару ключей Nostr (если необходимо):

# С помощью naknak key generate

2. Добавьте в конфигурацию:

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

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

export NOSTR_PRIVATE_KEY="nsec1..."

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

Справочник по конфигурации

Метаданные профиля

Данные профиля публикуются как событие NIP-01 kind:0. Управлять ими можно в Control UI (Channels -> Nostr -> Profile) или непосредственно в конфигурации.

Пример:

{  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

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

Значения по умолчанию: relay.damus.io и nos.lol.

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

Рекомендации:

• Используйте 2–3 ретранслятора для резервирования.
• Избегайте слишком большого количества ретрансляторов из-за задержек и дублирования.
• Платные ретрансляторы могут повысить надежность.
• Локальные ретрансляторы подходят для тестирования (ws://localhost:7777).

Поддержка протоколов

Тестирование

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

# Запустите strfrydocker 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 запланирована).

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

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