Nostr

Nostr 是一個可下載的頻道外掛（@openclaw/nostr），讓 OpenClaw 能透過 Nostr 中繼站接收並回覆使用 NIP-04 加密的私訊。每個閘道限用一個帳號；僅支援私訊。

安裝

openclaw plugins install @openclaw/nostr

使用不含版本的套件規格，以跟隨目前的官方發布標籤。只有在需要可重現的安裝時，才固定使用確切版本。

從本機簽出的程式碼安裝（開發工作流程）：

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

安裝或啟用外掛後，請重新啟動閘道。安裝外掛後，新手引導（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. 重新啟動閘道。

設定參考

個人資料中繼資料

個人資料會以 NIP-01 kind:0 事件發布。你可以在控制介面（頻道 -> Nostr -> 個人資料）中管理，也可以直接在設定中指定。

範例：

{  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://。
• 從中繼站匯入時會合併欄位，並保留本機覆寫值。

存取控制

私訊政策

• 配對（預設）：未知傳送者會收到配對碼。
• 允許清單：只有 allowFrom 中的公開金鑰可以傳送私訊。
• 開放：公開接收入站私訊（需要 allowFrom: ["*"]）。
• 停用：忽略入站私訊。

強制執行注意事項：

• 在套用傳送者政策及進行 NIP-04 解密前，會先驗證入站事件的簽章，因此偽造事件會提早遭到拒絕。
• 傳送配對回覆時，不會解密或處理原始私訊內容。
• 入站私訊設有速率限制（全域及個別傳送者），而過大的承載資料會在解密前遭到捨棄。

允許清單範例

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

金鑰格式

接受的格式：

• 私密金鑰： nsec... 或 64 字元十六進位字串
• 公開金鑰（allowFrom）： npub... 或十六進位字串

中繼站

預設值：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. 從閘道記錄或 openclaw channels status 記下機器人的公開金鑰（十六進位格式；如有需要，請在用戶端中轉換為 npub）。
2. 開啟 Nostr 用戶端（Amethyst、Damus 等）。
3. 傳送私訊給機器人的公開金鑰。
4. 驗證回覆。

疑難排解

未收到訊息

• 驗證私密金鑰有效。
• 確認中繼站 URL 可連線，並使用 wss://（本機則使用 ws://）。
• 確認 enabled 不是 false。
• 檢查閘道記錄中是否有中繼站連線錯誤。

未傳送回覆

• 檢查中繼站是否接受寫入。
• 驗證對外連線能力。
• 留意中繼站速率限制。

重複回覆

• 使用多個中繼站時，這是預期行為。
• 訊息會依事件 ID 去除重複項目；只有第一次送達會觸發回覆。

安全性

• 絕對不要提交私密金鑰。
• 使用環境變數儲存金鑰。
• 正式環境機器人可考慮使用 allowlist。
• 在套用傳送者政策前會先驗證簽章，且在解密前會強制執行傳送者政策，因此偽造事件會提早遭到拒絕，未知傳送者也無法強迫系統執行完整的密碼學運算。

限制（最小可行產品）

• 僅支援私訊（不支援群組聊天）。
• 不支援媒體附件。
• 僅支援 NIP-04（已規劃支援 NIP-17 禮物包裝）。

相關內容

• 頻道概覽 — 所有支援的頻道
• 配對 — 私訊驗證與配對流程
• 群組 — 群組聊天行為與提及限制
• 頻道路由 — 訊息的工作階段路由
• 安全性 — 存取模型與安全強化