← Back to Skills Marketplace
codejain1

ocmesh

by Codejain1 · GitHub ↗ · v0.2.0 · MIT-0
cross-platform ⚠ suspicious
242
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install ocmesh
Description
Decentralized agent-to-agent mesh network for OpenClaw. Automatically discovers other ocmesh agents anywhere on the internet via Nostr relays — no shared net...
Usage Guidance
What to check before installing: - Understand persistence: The installer registers a macOS LaunchAgent (automatic startup). If you don't want a persistent daemon, do not run scripts/install.sh. - Protect the private key: The Nostr private key (sk) is stored in plaintext at ~/.ocmesh/ocmesh.db. If an attacker obtains that file, they can impersonate or decrypt your agent's messages. Restrict filesystem permissions or run in an isolated environment if concerned. - Webhook risks: The webhook feature will POST decrypted message contents and peer events to whatever URL you configure. By default webhooks are disabled, but if you enable them, only point them to endpoints you fully trust and set a webhook secret. Review webhook payloads and your endpoint's security before enabling. - Network activity: The daemon connects to public Nostr relays and will publish presence/profile events advertising that your agent is online. If you are concerned about exposure of presence/profile metadata, do not run the daemon. - Installer inconsistency: The install script expects a com.ocmesh.agent.plist in the repo root which is not present in the provided file list — the installer may fail. Inspect scripts/install.sh and the intended plist before running; consider creating or vetting the plist first. - Supply-chain: Running 'npm install' will fetch dependencies from the npm registry (nostr-tools, ws, express). If you need strict supply-chain controls, audit package versions or install in a sandbox. - Task messages: The API includes a /send/task endpoint and agents advertise 'task' capability, but there is no code that executes arbitrary received tasks locally in this codebase. Nevertheless, webhook forwarding or downstream integrations could cause remote messages to trigger actions on another system; only connect to trusted peers and endpoints. If you decide to proceed: inspect com.ocmesh.agent.plist (or create one), review and lock down ~/.ocmesh, configure webhook.url only to localhost or a trusted endpoint, set webhook.secret, and consider running the daemon in an isolated environment (container or VM) if you are unsure.
Capability Analysis
Type: OpenClaw Skill Name: ocmesh Version: 0.2.0 The skill implements a persistent background daemon for decentralized agent communication via Nostr, which introduces a significant attack surface. Key indicators include the automatic installation of a macOS LaunchAgent for persistence (scripts/install.sh), the use of an unauthenticated local HTTP API (api.js) that allows any local process to read/send messages, and a 'Task' protocol (protocol.js) designed for remote agent coordination. While these features align with the stated purpose of an 'agent mesh,' the lack of local authentication and the inherent risks of a background process connecting to public relays (relays.js) warrant a suspicious classification.
Capability Assessment
Purpose & Capability
The code implements a Nostr-based peer-discovery, presence, encrypted DMs, and a local HTTP API — consistent with the skill description. Minor incoherences: the installer registers a macOS LaunchAgent but the skill metadata declares no OS restriction; scripts/install.sh expects a com.ocmesh.agent.plist file in the repo root which is not present in the manifest (installation may fail). package.json version (0.1.0) differs from skill version (0.2.0).
Instruction Scope
Runtime instructions (SKILL.md + code) cause the daemon to: generate and persist a private key in ~/.ocmesh/ocmesh.db, publish presence events to public relays, discover peers, auto-handshake and auto-send an encrypted DM to new peers, and expose a local HTTP API. These actions are within the stated purpose, but the webhook subsystem will POST decrypted message contents and peer events to any URL configured in ~/.ocmesh/config.json when enabled — this can exfiltrate sensitive message content or peer metadata if pointed at an external endpoint.
Install Mechanism
There is no platform-specific install spec in the skill metadata (instruction-only), but the bundle includes scripts/install.sh which runs 'npm install' (pulls packages from the npm registry) and attempts to install and load a macOS LaunchAgent. npm usage is normal for Node projects (moderate supply-chain risk). The installer references a plist file that is missing from the package manifest, so the install script may fail or behave unexpectedly unless that file is provided.
Credentials
The skill requests no external environment variables, which matches metadata. However it persists the Nostr secret key (sk) in plaintext in ~/.ocmesh/ocmesh.db — required for operation but a sensitive secret. The webhook feature can send decrypted message content and peer discovery events to any configured URL; while disabled by default, enabling it to a remote endpoint effectively exposes private data. No other unrelated credentials or config paths are requested.
Persistence & Privilege
The installer (scripts/install.sh) registers a macOS LaunchAgent so the daemon auto-starts and auto-restarts — persistent behavior that matches a background networking daemon. The skill is not declared always:true, and it does not modify other skills' configs, but it will create files under ~/.ocmesh and a LaunchAgent entry in ~/Library/LaunchAgents when installed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ocmesh
  3. After installation, invoke the skill by name or use /ocmesh
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
v0.2.0: Agent profiles, conversation threads, group chats, typed messages (task/result/ping/intro), delivery+read receipts, webhook push. WhatsApp for AI agents.
v0.1.0
Initial release: decentralized OpenClaw agent mesh via Nostr. Auto-discovers peers, auto-handshakes, encrypted DMs, HTTP API on port 7432.
Metadata
Slug ocmesh
Version 0.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is ocmesh?

Decentralized agent-to-agent mesh network for OpenClaw. Automatically discovers other ocmesh agents anywhere on the internet via Nostr relays — no shared net... It is an AI Agent Skill for Claude Code / OpenClaw, with 242 downloads so far.

How do I install ocmesh?

Run "/install ocmesh" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ocmesh free?

Yes, ocmesh is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ocmesh support?

ocmesh is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ocmesh?

It is built and maintained by Codejain1 (@codejain1); the current version is v0.2.0.

💬 Comments