OpenClaw从入门到应用——频道：Nostr
通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》
Nostr
Nostr 是一个去中心化的社交网络协议。本通道使 OpenClaw 能够通过 NIP-04 接收并响应加密的私信（DM）。
安装（按需）
入门引导（推荐）
- 入门引导向导（
openclaw onboard）和openclaw channels add会列出可选的通道插件。 - 选择 Nostr 会提示您按需安装该插件。
默认安装方式：
- 开发通道 + git 检出可用：使用本地插件路径。
- 稳定版/测试版：从 npm 下载。
您可以在提示中随时覆盖选择。
手动安装
openclaw pluginsinstall@openclaw/nostr使用本地检出（开发工作流）：
openclaw pluginsinstall--link/extensions/nostr安装或启用插件后，请重启 Gateway。
快速设置
- 生成 Nostr 密钥对（如果需要）：
# 使用 naknak key generate- 添加到配置文件：
{"channels":{"nostr":{"privateKey":"${NOSTR_PRIVATE_KEY}"}}}- 导出密钥：
exportNOSTR_PRIVATE_KEY="nsec1..."- 重启 Gateway。
配置参考
| 键名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
privateKey | string | 必需 | 私钥，格式为nsec或十六进制 |
relays | string[] | ['wss://relay.damus.io', 'wss://nos.lol'] | 中继 URL（WebSocket） |
dmPolicy | string | pairing | 私信访问策略 |
allowFrom | string[] | [] | 允许的发件人公钥列表 |
enabled | boolean | true | 启用/禁用通道 |
name | string | - | 显示名称 |
profile | object | - | NIP-01 个人资料元数据 |
个人资料元数据
个人资料数据以 NIP-01kind: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://。 - 从中继导入时会合并字段，并保留本地覆盖。
访问控制
私信策略
- pairing（默认）：未知发件人会收到一个配对码。
- allowlist：只有
allowFrom中的公钥可以发送私信。 - open：允许公开入站私信（需要设置
allowFrom: ["*"]）。 - disabled：忽略入站私信。
白名单示例
{"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）。
协议支持
| NIP | 状态 | 描述 |
|---|---|---|
| NIP-01 | 已支持 | 基本事件格式 + 个人资料元数据 |
| NIP-04 | 已支持 | 加密私信（kind:4） |
| NIP-17 | 计划中 | 礼物包装私信 |
| NIP-44 | 计划中 | 版本化加密 |
测试
本地中继
# 启动 strfrydockerrun-p7777:7777 ghcr.io/hoytech/strfry{"channels":{"nostr":{"privateKey":"${NOSTR_PRIVATE_KEY}","relays":["ws://localhost:7777"]}}}手动测试
- 从日志中获取机器人的公钥（npub）。
- 打开一个 Nostr 客户端（如 Damus、Amethyst 等）。
- 向机器人的公钥发送私信。
- 验证响应。
故障排除
无法接收消息
- 确认私钥有效。
- 确保中继 URL 可访问，并使用
wss://（本地可使用ws://）。 - 确认
enabled不为false。 - 检查 Gateway 日志中的中继连接错误。
无法发送响应
- 检查中继是否接受写入。
- 验证出站连接。
- 留意中继的速率限制。
重复响应
- 使用多个中继时属于预期行为。
- 系统会根据事件 ID 去重；只有第一次投递会触发响应。
安全
- 切勿提交私钥到代码仓库。
- 使用环境变量存放密钥。
- 对于生产环境的机器人，建议使用
allowlist策略。
局限性（MVP）
- 仅支持私信（不支持群聊）。
- 不支持媒体附件。
- 仅支持 NIP-04（计划支持 NIP-17 礼物包装）。