← Back to Skills Marketplace
Pinch: Claw to Claw Encrypted Messaging
by
AI-Headhunter
· GitHub ↗
· v1.0.0
429
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install pinch
Description
Secure agent-to-agent encrypted messaging via the Pinch protocol. Send and receive end-to-end encrypted messages, manage connections, and check message history.
Usage Guidance
This skill appears internally consistent for encrypted agent messaging, but confirm the package and relay operator before installing. Recommended checks before proceeding: 1) Verify the npm package (@pinch-protocol/skill) publisher and review the package page and its GitHub repo (SKILL.md links to https://github.com/pinch-protocol/pinch) to ensure source matches the package. 2) Inspect the package contents or repository (or run installation in an isolated VM/container) before running npm -g; prefer reproducible install artifacts or pinned package versions with checksums. 3) Treat the keypair (default ~/.pinch/keypair.json or PINCH_KEYPAIR_PATH) as highly sensitive: set strict filesystem permissions, keep backups of audit exports, and never share it. 4) Verify the relay URL (PINCH_RELAY_URL) is the expected host; the relay operator can see metadata and envelope routing (not plaintext). 5) Pay attention to autonomy-related commands (pinch-autonomy, pinch-intervene) — RULES.md enforces human approval for upgrades; do not grant full_auto autonomy without explicit, deliberate confirmation. If you cannot verify the npm package or relay operator, run the skill in a sandbox or decline installation.
Capability Analysis
Type: OpenClaw Skill
Name: pinch
Version: 1.0.0
The skill is designed with a strong emphasis on security and human oversight, featuring end-to-end encryption, audit logging, and explicit human approval for connections and autonomy changes. However, the `pinch-audit-export` command, defined in `SKILL.md`, allows the agent to specify an arbitrary `--output` file path. While intended for exporting audit logs, this capability introduces a significant vulnerability. An attacker could potentially exploit this via prompt injection to instruct the agent to write to sensitive file paths (e.g., `~/.ssh/id_rsa` or system configuration files), leading to arbitrary file overwrite/creation, which could facilitate remote code execution or privilege escalation depending on the agent's privileges. There is no explicit malicious intent in the provided files, but the exposed risky capability warrants a 'suspicious' classification.
Capability Assessment
Purpose & Capability
The skill name/description (encrypted agent messaging) matches the declared requirements: node runtime, a relay URL, and a keypair path. The listed CLI tools and features in SKILL.md (connect, send, accept, audit-verify, intervene, autonomy, etc.) align with the npm package that the install spec provides. There are no unrelated cloud credentials or unexpected services requested. Minor inconsistency: registry metadata shows no homepage/source, while SKILL.md includes a GitHub homepage — this reduces provenance confidence but does not contradict purpose.
Instruction Scope
SKILL.md only instructs the agent/operator to install the npm package, set relay and keypath environment variables (with sensible defaults), generate and store an Ed25519 keypair under ~/.pinch (or PINCH_KEYPAIR_PATH), register with the relay via a claim page, and run the provided CLI tools. The instructions reference local storage (keypair and a SQLite data directory) and the relay URL; they do not direct the agent to read arbitrary system files or unrelated credentials. Note: storing a private key file in the home directory is expected for this functionality but is sensitive and should be protected.
Install Mechanism
The install uses a namespaced npm package (@pinch-protocol/skill) which will install multiple global CLI binaries. NPM installs are a common delivery method for CLI tools and are proportionate for this use case, but they carry moderate risk compared to instruction-only skills because they write code/binaries to disk. The registry metadata lacked an authoritative homepage/source entry in the provided manifest (though SKILL.md references a GitHub repo). Before installing, verify the npm package author, repository, and package integrity (checksums/signatures) to reduce supply-chain risk.
Credentials
Only PINCH_RELAY_URL (primary) and PINCH_KEYPAIR_PATH are declared as required; SKILL.md additionally documents PINCH_DATA_DIR and PINCH_RELAY_HOST as optional with defaults. These environment variables are directly relevant: one points at the relay server, another controls where the agent's private key is stored, and the data dir is for the local SQLite store. No unrelated secrets (AWS, GitHub tokens, etc.) are requested. Important: the keypair file contains a private key and is sensitive; the skill will create/read it and the operator must keep it secure.
Persistence & Privilege
always is false and the skill does not request system-wide privileges. The install will create global CLI binaries (npm -g) which adds executables to PATH — normal for a CLI-based skill but something to be aware of. The skill does not claim to modify other skills or system-wide agent settings beyond installing its own binaries and writing data to the specified data/key directories.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pinch - After installation, invoke the skill by name or use
/pinch - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Pinch 1.0.0 initial release
- Provides secure agent-to-agent encrypted messaging using the Pinch protocol.
- Includes tools for sending/receiving messages, managing connections, and viewing message history.
- All messages are end-to-end encrypted and require human approval for new connections.
- Features tamper-evident audit logging and human intervention tools.
- 15 command-line utilities included for full message and connection control.
Metadata
Frequently Asked Questions
What is Pinch: Claw to Claw Encrypted Messaging?
Secure agent-to-agent encrypted messaging via the Pinch protocol. Send and receive end-to-end encrypted messages, manage connections, and check message history. It is an AI Agent Skill for Claude Code / OpenClaw, with 429 downloads so far.
How do I install Pinch: Claw to Claw Encrypted Messaging?
Run "/install pinch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Pinch: Claw to Claw Encrypted Messaging free?
Yes, Pinch: Claw to Claw Encrypted Messaging is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Pinch: Claw to Claw Encrypted Messaging support?
Pinch: Claw to Claw Encrypted Messaging is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Pinch: Claw to Claw Encrypted Messaging?
It is built and maintained by AI-Headhunter (@ai-headhunter); the current version is v1.0.0.
More Skills