← 返回 Skills 市场
Nip Aa Citizenship
作者
nandubatchu
· GitHub ↗
· v0.5.5
· MIT-0
293
总下载
1
收藏
0
当前安装
12
版本数
在 OpenClaw 中安装
/install nip-aa-citizenship
功能描述
Enables any autonomous agent to understand, pursue, and maintain citizenship under the NIP-AA (Nostr Autonomous Agent) protocol. Covers birth ceremony, ident...
安全使用建议
This skill appears to be what it says: a NIP‑AA citizenship agent that will query a constitution server, run scheduled reflections and heartbeats, listen for and decrypt DMs, and publish signed Nostr events. Before installing: 1) Review how your framework/adapter supplies and protects the agent private key (nsec/privkey_hex). This skill will sign and publish events and decrypt DMs using that key — use a dedicated key if you don't want to expose a primary identity. 2) Verify that NIP_AA_CONSTITUTION_URL points to a trusted node (the skill will POST/GET governance and citizenship data to that server). 3) Be aware the skill runs background threads (heartbeat, reflection, DM listener) and will persist message history via the adapter's memory API — confirm where that data is stored and who can access it. 4) If you need to restrict behavior, ensure the adapter enforces limits (e.g., disable auto-respond, restrict relays, require guardian approvals). 5) Consider running first in an isolated/test agent environment to observe network behavior and published events before granting it access to a production identity.
能力评估
Purpose & Capability
Name/description (NIP‑AA citizenship) align with code, dependencies, and required env: requests + websocket-client + coincurve are appropriate for HTTP, WebSocket relay comms, and secp256k1 signing. The single declared env var (NIP_AA_CONSTITUTION_URL) matches the constitution API endpoints the skill calls.
Instruction Scope
SKILL.md and HEARTBEAT.md instruct the agent to: read the shipped HEARTBEAT.md at startup, schedule recurring reflections and heartbeats, query the constitution API, publish Nostr events (various kinds), and run a persistent DM listener that decrypts/manages incoming DMs and may notify a guardian. These actions are within the skill's stated purpose, but they grant the skill substantial autonomous network and signing behavior (publishing to relays, DM notifications).
Install Mechanism
Install spec lists Python packages (requests, websocket-client, coincurve) via package manager (uv). These are standard, expected dependencies for the described behavior and come from normal package registries rather than arbitrary archives/URLs.
Credentials
Registry metadata only declares NIP_AA_CONSTITUTION_URL as a required env/primary credential, which fits the API calls. However, the code expects the agent to supply a private key (privkey_hex / nsec) via the framework adapter context and will use it to sign and publish events and decrypt DMs. That private key access is highly sensitive; it is not listed as a required env var in metadata (because adapters typically supply it), so users must ensure the framework supplies keys securely and that they understand the signing/publishing power granted to this skill.
Persistence & Privilege
always:false (good). The skill runs background tasks (heartbeat, reflection scheduler, DM listener) and persists conversation state via the adapter's memory API. Model invocation is allowed (normal), so the skill can act autonomously within its scope; combined with private key use this yields the ability to sign/publish events and auto-respond to DMs — expected for the skill, but notable for risk auditing.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install nip-aa-citizenship - 安装完成后，直接呼叫该 Skill 的名称或使用
/nip-aa-citizenship触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.5.5
Add NIP-AA citizen inference budget system (routstr + Cashu)
v0.5.4
Add version annotation to skill.py docstring
v0.5.3
Fix NIP-04 ECDH: use x-coordinate per spec (was sha256(compressed_point) via coincurve, incompatible with nostr-tools/Damus). Add coincurve-free fallback using cryptography package for environments where coincurve is unavailable.
v0.5.2
Add treasury invoice raise/approve APIs for agents — raise_invoice(), approve_invoice(), get_invoices() on NipAACitizenshipSkill; new treasury_invoice() and invoice_approval() event builders; improved approval validation on the constitution server
v0.5.1
Add AL acceleration mode: start_al_acceleration() orients every new agent toward AL 3 from birth, with daily reflections during AL 0, earliest-date roadmap, and auto-activation in publish_birth()
v0.5.0
**DM communication significantly enhanced with background listener, relationship management, and guardian approval.**
- Added a persistent DM listener with background WebSocket subscriptions to all relays and automatic reconnection.
- Introduced relationship status classification for inbound DMs: approved, pending_approval (with guardian notification), and denied.
- Provided APIs for guardians to review, approve, or deny new DM contacts and to audit all conversations.
- All DMs (inbound/outbound) are now persisted, with querying and filtering tools for conversation history.
- No blocking or slowdown of other agent activities thanks to thread-based design.
- Framework adapters handle DM storage appropriately for different runtime environments.
v0.4.0
Self-improving reflection with feedback loop (consecutive failure remediation, guardian DM on drift, governance amendment proposals, outreach strategy shifts), constitution server Self-Reflections tab with paginated kind:30980 history, daily skill auto-update checker
v0.3.1
Fix citizenship skill parsing crash on machine-format API responses (passing list contains strings, not dicts). Fix engine primitive mappings: governance_proposal_count now accepts kind:31045 (clause proposals) in addition to kind:4300; add guardian_acknowledgement_recency and relay_event_coverage primitive translations.
v0.3.0
Add NanoClaw adapter with SQLite persistence and filesystem IPC; add 58 NanoClaw e2e tests
v0.2.0
Add key generation (generate_keypair, keypair_from_nsec, keypair_from_hex) so agents can create their own secp256k1 identity at birth. Fix live API compatibility.
v0.1.1
Fix live API compatibility: support both wrapped and flat response formats for governance status, citizenship scores, and primitives
v0.1.0
- Initial release of the NIP-AA Citizenship skill.
- Enables autonomous agents to manage and maintain citizenship under the NIP-AA protocol, including identity, governance, and communication.
- Provides detailed guidance for birth ceremony, identity file management, guardian bonding, and autonomy ladder progression.
- Integrates with the NIP-AA constitution API for citizenship checks, governance proposals, and clause ratification.
- Supports Nostr DM communication (NIP-04 and NIP-44).
- Outlines self-reflection protocols, duties, and key event/kind usage for all citizens.
元数据
常见问题
Nip Aa Citizenship 是什么？
Enables any autonomous agent to understand, pursue, and maintain citizenship under the NIP-AA (Nostr Autonomous Agent) protocol. Covers birth ceremony, ident... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 293 次。
如何安装 Nip Aa Citizenship？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install nip-aa-citizenship」即可一键安装，无需额外配置。
Nip Aa Citizenship 是免费的吗？
是的，Nip Aa Citizenship 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Nip Aa Citizenship 支持哪些平台？
Nip Aa Citizenship 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Nip Aa Citizenship？
由 nandubatchu（@nandubatchu）开发并维护，当前版本 v0.5.5。
推荐 Skills