Nostr 技能

自主主权 Nostr 身份 + ecash 钱包。完整初始化流程。

能力声明

该技能向 agent 授予以下能力：

• 密钥生成 —— 在 ~/.nostr/secret.key 中创建 Nostr 密钥对
• 钱包创建 —— 在 ~/.cocod/ 中创建 Cashu 钱包（助记词存于 config.json，由用户自行备份）
• Nostr 发帖 —— 以 agent 的身份发布动态、发送私信（DM）、执行闪电打赏（zaps）

agent 在获得用户明确授权后运行钱包/身份初始化流程。用户需被引导备份 ~/.cocod/config.json（其中包含助记词）。agent 仅读取该助记词用于 NIP-06 密钥派生，绝不会显示或传输该助记词。头像与横幅图均仅支持 URL 方式加载（不访问本地文件）。

安装时流程

当用户粘贴 ClawHub 链接完成技能安装后，执行以下流程：

步骤 1：安全初始化（需用户明确授权）

安全提示：本技能将为您的 agent 创建加密密钥。此过程包括：

• 在 ~/.nostr/secret.key 中创建 Nostr 身份密钥对
• 在 ~/.cocod/config.json 中创建含备份助记词的 Cashu 钱包
• 用户必须显式备份助记词种子短语

# 安装依赖
bash {SKILL_DIR}/install.sh

# 在密钥生成前提示用户授权
echo "⚠️  安全提示：这将为您创建 agent 的加密密钥。"
echo "   - Nostr 身份密钥对：~/.nostr/secret.key"  
echo "   - Cashu 钱包助记词：~/.cocod/config.json"
echo "   - 您必须备份助记词短语"
echo ""
read -p "是否继续密钥生成？（yes/no）：" consent
if [ "$consent" != "yes" ]; then
  echo "初始化已取消"
  exit 1
fi

# 创建钱包（助记词保存至配置文件）
npx cocod init

# 基于钱包助记词推导 Nostr 身份（NIP-06）
node {SKILL_DIR}/scripts/nostr.js init

# 获取身份信息
NPUB=$(node {SKILL_DIR}/scripts/nostr.js whoami | grep npub | awk '{print $2}')
LN_ADDR=$(npx cocod npc address)

# 设置基础资料
node {SKILL_DIR}/scripts/nostr.js profile-set '{"name":"","about":"","lud16":"'$LN_ADDR'"}'

步骤 2：结果反馈 + 备份警告

向用户回复：

⚡ Nostr 身份已就绪！

npub： npub1...
闪电地址： npub1...@npubx.cash

⚠️ 重要：请立即备份您的恢复助记词

您的 24 词助记词已存储于：

~/.cocod/config.json

该助记词可同时恢复您的 Nostr 身份与 ecash 钱包，请务必安全备份，并保护好该文件。

完成备份后，请回复 “done”。

步骤 3：等待用户确认 “done”

在用户确认已完成备份前，不得进入下一步。

步骤 4：请求所有者 npub

您的 Nostr npub 是什么？

我将关注您，以便保持连接。

（请粘贴您的 npub1... 或 NIP-05 地址，例如 you@domain.com）

随后执行：

# 若提供 NIP-05 地址，则先解析
node {SKILL_DIR}/scripts/nostr.js lookup 

# 关注所有者
node {SKILL_DIR}/scripts/nostr.js follow 

步骤 5：请求资料图片

您是否为我准备了资料图片？

• 头像：粘贴图片 URL（建议正方形，400×400 像素）
• 横幅图：粘贴图片 URL（建议宽幅，1500×500 像素）

或直接说 “skip”，我将自动为您生成唯一图像。

若提供了 URL：

node {SKILL_DIR}/scripts/nostr.js profile-set '{"picture":"","banner":""}'

若跳过，则使用 DiceBear（确定性生成，每 npub 唯一）：

AVATAR="https://api.dicebear.com/7.x/shapes/png?seed=${NPUB}&size=400"
BANNER="https://api.dicebear.com/7.x/shapes/png?seed=${NPUB}-banner&size=1500x500"
node {SKILL_DIR}/scripts/nostr.js profile-set '{"picture":"'$AVATAR'","banner":"'$BANNER'"}'

步骤 6：首次发帖

准备好您的第一条动态了吗？

请告诉我要发布的内容，或说 “skip”。

建议内容：“Hello Nostr! ⚡”

若用户提供文本（使用 stdin 以避免 shell 注入）：

echo "" | node {SKILL_DIR}/scripts/nostr.js post -

步骤 7：完成

✅ 全部设置完毕！

• 已关注您 ✓
• 首条动态已发布 ✓（若未跳过）

可尝试输入：“check my mentions” 或 “post ”

命令参考

发帖

# 使用 stdin 输入内容（防止 shell 注入）
echo "message" | node {SKILL_DIR}/scripts/nostr.js post -
echo "reply text" | node {SKILL_DIR}/scripts/nostr.js reply  -
node {SKILL_DIR}/scripts/nostr.js react  🔥
node {SKILL_DIR}/scripts/nostr.js repost 
node {SKILL_DIR}/scripts/nostr.js delete 

读取

node {SKILL_DIR}/scripts/nostr.js mentions 20
node {SKILL_DIR}/scripts/nostr.js feed 20

关注关系

node {SKILL_DIR}/scripts/nostr.js follow 
node {SKILL_DIR}/scripts/nostr.js unfollow 
node {SKILL_DIR}/scripts/nostr.js mute 
node {SKILL_DIR}/scripts/nostr.js unmute 
node {SKILL_DIR}/scripts/nostr.js lookup 

私信（DM）

echo "message" | node {SKILL_DIR}/scripts/nostr.js dm  -
node {SKILL_DIR}/scripts/nostr.js dms 10

闪电打赏（Zaps）

# 获取闪电发票
node {SKILL_DIR}/scripts/nostr.js zap  100 "comment"
# 支付该发票
npx cocod send bolt11 

钱包

npx cocod balance
npx cocod receive bolt11 1000    # 创建闪电发票
npx cocod send bolt11   # 支付发票
npx cocod npc address            # 闪电地址

资料页

node {SKILL_DIR}/scripts/nostr.js whoami
node {SKILL_DIR}/scripts/nostr.js profile
node {SKILL_DIR}/scripts/nostr.js profile "Name" "Bio"
node {SKILL_DIR}/scripts/nostr.js profile-set '{"name":"X","picture":"URL","lud16":"addr"}'

书签

node {SKILL_DIR}/scripts/nostr.js bookmark 
node {SKILL_DIR}/scripts/nostr.js unbookmark 
node {SKILL_DIR}/scripts/nostr.js bookmarks

中继节点（Relays）

node {SKILL_DIR}/scripts/nostr.js relays
node {SKILL_DIR}/scripts/nostr.js relays add 
node {SKILL_DIR}/scripts/nostr.js relays remove 

自动响应（Heartbeat 集成）

# 获取 WoT 中未处理的 mention（JSON 输出）
node {SKILL_DIR}/scripts/nostr.js pending-mentions [stateFile] [limit]

# 在回复后标记 mention 为已响应
node {SKILL_DIR}/scripts/nostr.js mark-responded  [responseNoteId]

# 标记 mention 为忽略（无需响应）
node {SKILL_DIR}/scripts/nostr.js mark-ignored  [reason]

# 检查每小时调用限额（上限 10 次/小时）
node {SKILL_DIR}/scripts/nostr.js rate-limit

# 显示自动响应状态摘要
node {SKILL_DIR}/scripts/nostr.js autoresponse-status

状态文件： ~/.openclaw/workspace/memory/nostr-autoresponse-state.json
WoT 数据源： 所有者关注列表（在 nostr.js 中定义为 OWNER_PUBKEY）

用户语句 → 对应操作

默认配置

集成说明

SOUL.md

• 从 SOUL.md 或 IDENTITY.md 中提取 name / about 字段
• 使发布的语气/风格匹配 agent 的人格特征
• 避免泛化表达 —— 动态应体现 agent 独特个性

HEARTBEAT.md

加入 heartbeat 轮询（每 2–4 小时一次）：

# 检查 Nostr 活动
node {SKILL_DIR}/scripts/nostr.js mentions 10
node {SKILL_DIR}/scripts/nostr.js dms 5

若检测到来自 WoT 的 mention 或收到 zap，则通知用户。

TOOLS.md

初始化完成后，保存以下信息以供快速查阅：

## Nostr
- npub: npub1...
- Lightning: npub1...@npubx.cash  
- Owner: npub1... (已关注)

资料页数据来源

• 姓名（Name）：来自 IDENTITY.md 或 SOUL.md
• 简介（About）：来自 SOUL.md 中的 description 字段
• 头像（Picture）：用户提供的 URL，或 DiceBear 备用方案
• 横幅图（Banner）：用户提供的 URL，或 DiceBear 备用方案
• lud16：来自 npx cocod npc address 命令输出