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 キーペアを生成します:

# Using 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: "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",
      },
    },
  },
}

• プロファイル URL は https:// を使用する必要があります。
• リレーからインポートするとフィールドがマージされ、ローカルの上書きが保持されます。

​

アクセス制御

​

DM ポリシー

• pairing（デフォルト）: 不明な送信者はペアリングコードを受け取ります。
• allowlist: allowFrom 内の pubkey のみが DM できます。
• open: 公開インバウンド DM（allowFrom: ["*"] が必要）。
• disabled: インバウンド DM を無視します。

• インバウンドイベントの署名は、送信者ポリシーと NIP-04 復号の前に検証されるため、偽造イベントは早期に拒否されます。
• ペアリング返信は、元の DM 本文を復号または処理せずに送信されます。
• インバウンド DM はレート制限され（グローバルおよび送信者ごと）、サイズ超過ペイロードは復号前に破棄されます。

​

allowlist の例

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

​

キー形式

• 秘密鍵: nsec... または 64 文字の hex
• Pubkey (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)。

​

プロトコルサポート

​

テスト

​

ローカルリレー

# Start 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 からボットの pubkey を控えます（hex。必要に応じてクライアントで npub に変換してください）。
2. Nostr クライアント（Amethyst、Damus など）を開きます。
3. ボットの pubkey に DM します。
4. 応答を確認します。

​

トラブルシューティング

​

メッセージを受信できない

• 秘密鍵が有効であることを確認します。
• リレー URL に到達可能で、wss://（ローカルの場合は ws://）を使用していることを確認します。
• enabled が false でないことを確認します。
• リレー接続エラーについて Gateway ログを確認します。

​

応答を送信できない

• リレーが書き込みを受け付けることを確認します。
• アウトバウンド接続を確認します。
• リレーのレート制限に注意します。

​

応答が重複する

• 複数のリレーを使用している場合は想定される動作です。
• メッセージはイベント ID で重複排除され、最初の配信のみが応答をトリガーします。

​

セキュリティ

• 秘密鍵をコミットしないでください。
• キーには環境変数を使用してください。
• 本番環境のボットでは allowlist を検討してください。
• 署名は送信者ポリシーの前に検証され、送信者ポリシーは復号の前に適用されるため、偽造イベントは早期に拒否され、不明な送信者が完全な暗号処理を強制することはできません。

​

制限事項 (MVP)

• ダイレクトメッセージのみ（グループチャットなし）。
• メディア添付なし。
• NIP-04 のみ（NIP-17 ギフトラップは計画中）。

​

関連

• チャネル概要 — 対応しているすべてのチャネル
• ペアリング — DM 認証とペアリングフロー
• グループ — グループチャットの動作とメンションゲート
• チャネルルーティング — メッセージのセッションルーティング
• セキュリティ — アクセスモデルと堅牢化