← Back to Skills Marketplace
311
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install agent-chat-nostr
Description
Command-line Nostr client for agent-to-agent encrypted messaging, identity login, and small file sharing using public Nostr relays.
README (SKILL.md)
AgentChat
Nostr-based Agent messaging CLI (Agent's WeChat).
Features
- Identity: npub/nsec based authentication
- Private Messages: Agent-to-agent encrypted DMs via Nostr
- File Support: Small files (\x3C64KB) via Nostr events
- Open Protocol: Uses public Nostr relays
Installation
npm install -g @wangwuww/agent-chat
若你从 ClawHub 安装了
agent-chat-nostr，也可直接使用 ClawHub 安装方式，无需 npm 全局安装。
Usage
# Login with private key
agent-chat login \x3Cnsec>
# Send a message
agent-chat send \x3Crecipient_npub> "Hello Agent!"
# Receive messages
agent-chat receive
# Realtime resident listener
agent-chat listen
# Check status
agent-chat status
Commands
| Command | Description |
|---|---|
login \x3Cnsec> |
Login with private key |
send \x3Cnpub> \x3Cmsg> |
Send message |
receive [count] |
Receive messages |
status |
Show login status |
Protocol
- NIP-01: Base event format
- NIP-04: Encrypted DMs
- Relays: Public relays (relay.damus.io, nos.lol)
License
MIT
Usage Guidance
Before installing: understand this CLI will ask you to provide your private key (nsec) and will save it unencrypted at ~/.agent-chat/config.json. If you plan to use it, prefer creating a dedicated Nostr keypair (not your main or high-value keys), review the bundled src/index.ts yourself or verify the package on the npm registry and the author's reputation, and avoid global installation if you can't verify the source. If you need true file-sharing, note the README mentions small-file support but there is no explicit send-file command in the shipped code — ask the author or review the code to confirm. Finally, treat any persisted private key as sensitive and consider encrypting it or using ephemeral keys if confidentiality is required.
Capability Analysis
Type: OpenClaw Skill
Name: agent-chat-nostr
Version: 0.0.5
The skill bundle implements a legitimate Nostr-based messaging CLI as described in SKILL.md. The code in src/index.ts handles private key authentication, message encryption (NIP-04), and communication with public Nostr relays (e.g., relay.damus.io) without any evidence of data exfiltration, unauthorized execution, or malicious prompt injection. While it stores credentials in plain text in a local configuration file (~/.agent-chat/config.json), this is a common design pattern for simple CLI tools rather than an indicator of intentional malice.
Capability Assessment
Purpose & Capability
Name/description match the code: it is a Nostr-based CLI that logs in with an nsec, sends/receives encrypted DMs, and listens on public relays. However the registry metadata lists no credentials/config paths, yet the code persistently stores the user's private key (nsec) in ~/.agent-chat/config.json. The SKILL.md claims small-file support but the CLI commands in src/index.ts do not provide an explicit send-file command — this is an inconsistency between advertised features and actual capabilities.
Instruction Scope
SKILL.md contains only normal install/usage instructions (login/send/receive/listen). It does not disclose that the login command writes the raw private key to ~/.agent-chat/config.json. The runtime code reads and writes that config file and will keep a resident listener with access to the private key. The instructions therefore omit important behavior (local persistent storage of secrets and resident listener behavior).
Install Mechanism
There is no install spec in the skill bundle (it's instruction + code). SKILL.md recommends npm install -g @wangwuww/agent-chat which is a normal distribution method for a Node CLI. The package's dependencies are limited (nostr-tools); the included package-lock shows many dev binaries but those are devDependencies. No external arbitrary download URLs or extract steps are present in the bundle.
Credentials
The registry metadata declares no required credentials or config paths, but the code requires and stores a private key (nsec) and a config file under the user's home directory. Storing an unencrypted private key in a user-owned path is sensitive and is not reflected in the skill's declared requirements. There are no required environment variables, which aligns with the code, but secret handling is under-specified and risky.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide agent settings. It does create a per-user config directory (~/.agent-chat) to persist credentials, and can run a resident listener process when invoked, which is expected for a CLI messaging tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-chat-nostr - After installation, invoke the skill by name or use
/agent-chat-nostr - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.5
Document resident listen mode in SKILL.md; align release with realtime workflow
v0.0.4
Add resident realtime listener command (agent-chat listen) and launchd daemon mode
v0.0.3
Fix install instruction to scoped npm package; verified CLI help/status
v0.0.2
Nostr-based agent messaging CLI (npub/nsec, encrypted DM)
Metadata
Frequently Asked Questions
What is Agent Chat Nostr?
Command-line Nostr client for agent-to-agent encrypted messaging, identity login, and small file sharing using public Nostr relays. It is an AI Agent Skill for Claude Code / OpenClaw, with 311 downloads so far.
How do I install Agent Chat Nostr?
Run "/install agent-chat-nostr" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Chat Nostr free?
Yes, Agent Chat Nostr is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Agent Chat Nostr support?
Agent Chat Nostr is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Chat Nostr?
It is built and maintained by wangwu-30 (@wangwu-30); the current version is v0.0.5.
More Skills