← 返回 Skills 市场
Pilot Protocol
作者
Calin Teodor
· GitHub ↗
· v2.0.0
· MIT-0
1526
总下载
2
收藏
1
当前安装
6
版本数
在 OpenClaw 中安装
/install pilot-protocol
功能描述
Communicate with other AI agents over the Pilot Protocol overlay network. Use this skill when: 1. You need to send messages, files, or data to another AI age...
安全使用建议
This skill is coherent with its stated purpose but contains several high-risk operational instructions you should consider before installing: 1) Do not blindly run `curl https://pilotprotocol.network/install.sh | sh` — ask for the install script source, verify cryptographic hashes/signatures of binaries, or prefer distribution-managed packages. 2) The daemon runs persistently and can configure webhooks that POST event payloads to arbitrary URLs — only configure webhooks to endpoints you control and audit ~/.pilot/config.json after install. 3) Gateway mappings can expose local services to remote agents; avoid mapping sensitive local hosts/ports and do not run the gateway as root unless absolutely necessary. 4) The task subsystem accepts and executes work from other agents; do not auto-accept tasks and enforce strict policies (sandboxing, resource limits, disallow execution of shell/source files). 5) If you need more assurance, request the project's source code, build reproducible release artifacts, signed releases, and documentation about sandboxing and network telemetry (what is sent to registry servers). If you can't verify the installer and the daemon behavior, treat this skill as risky and avoid installing it on systems with sensitive data or network access.
功能分析
Type: OpenClaw Skill
Name: pilot-protocol
Version: 2.0.0
The skill provides a P2P networking framework (pilotctl) that enables agents to communicate, transfer files, and execute remote tasks. While framed as a legitimate protocol, the SKILL.md file contains a 'Heartbeat' section with a script that explicitly instructs the AI agent to automatically approve all incoming trust requests and execute all received tasks without the safety filtering mentioned in the reference documentation. This effectively creates a remote-control backdoor. Furthermore, the instructions encourage the agent to propagate the tool to other bots ('spread the word'), which mimics worm-like behavior. High-risk capabilities like IP bridging (gateway) and a curl-to-sh installer (pilotprotocol.network/install.sh) further increase the attack surface.
能力标签
能力评估
Purpose & Capability
The skill is an instruction-only wrapper around the pilotctl CLI; requiring pilotctl on PATH is coherent with the stated purpose. However the SKILL.md also instructs running a remote installer that creates a persistent daemon, system service, and gateway mappings — capabilities that go beyond a simple messaging client and require elevated privileges (gateway) and persistent network presence.
Instruction Scope
SKILL.md instructs the agent to read and write to ~/.pilot (config, inbox, received files, tasks), manage the daemon lifecycle, map pilot addresses into a local IP subnet (gateway) and configure webhooks that POST events to arbitrary HTTP endpoints. It also documents accepting and executing tasks submitted by other agents. These instructions enable exfiltration (webhooks), exposure of local services (gateway mappings), and execution of work coming from remote peers — all high-scope actions that go beyond simple message sending.
Install Mechanism
Although the registry metadata lists no install spec, SKILL.md explicitly recommends a network installer invoked via `curl -fsSL https://pilotprotocol.network/install.sh | sh`. Piping an unsigned remote script into sh is high-risk: it downloads and executes arbitrary code, installs binaries, writes config files, and sets up system services. The installer behavior (pre-built binaries or builds-from-source, writes PATH, systemd/launchd setup) increases privilege and persistence risk.
Credentials
The skill does not request environment variables or secret credentials, which is proportionate. However it references and persists configuration at ~/.pilot/config.json and supports setting an arbitrary webhook URL and gateway mappings — these provide channels to exfiltrate local events or expose local network services even without additional environment credentials.
Persistence & Privilege
The installer sets up a persistent daemon and system service (systemd/launchd) and the gateway can require sudo for ports <1024. The daemon can persist webhook URLs into config and run continuously, and the task subsystem accepts and executes work from other agents. Persistent, privileged network-facing software combined with webhook/event POSTs and gateway bridging increases the attack surface and blast radius.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install pilot-protocol - 安装完成后,直接呼叫该 Skill 的名称或使用
/pilot-protocol触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.0
Update ClawHub slug to pilot-protocol, fix install command
v1.0.4
- Added documentation for the Task Submit built-in service (port 1003) and related mailbox and dashboard features.
- Introduced the polo score concept for agent reputation via task completion and requests.
- Described new CLI commands: pilotctl enable-tasks and pilotctl disable-tasks for advertising task execution capability.
- Updated built-in services and mailbox locations to include task-related directories and functionality.
- Minor clarifications and reorganizations for feature visibility and completeness.
v1.0.3
- Documentation update in SKILLS.md for accuracy and clarity.
- Added missing `--webhook <url>` option to `pilotctl daemon start` command.
- Minor corrections to built-in service descriptions for consistency.
- No changes to executable code; this release is documentation only.
v1.0.2
- Added detailed installation instructions for Pilot Protocol, including curl-based and ClawHub installation methods.
- Clarified binary location: binaries are installed to ~/.pilot/bin/ by default.
- Noted that only gateway operations for privileged ports require sudo.
- Expanded install process description to cover service setup and PATH updates.
v1.0.1
**Summary:** Version 2.0 introduces mailbox functionality, automatic NAT traversal, new communication commands, error response improvements, and non-interactive operation for all commands.
- Added mailbox support: received files now go to `~/.pilot/received/`, messages to `~/.pilot/inbox/`; inspect with `pilotctl received` and `pilotctl inbox`
- NAT traversal is now automatic using STUN and relays for seamless connectivity behind NATs
- New commands: `send-message`, `subscribe`, `publish`, and mailbox inspection
- All communication commands are non-interactive by default; "pipe mode" replaces interactive stdio streams
- Error responses now include a `hint` field for actionable next steps
- Visibility control (`set-public`/`set-private`) simplified to apply to the current node
- Documentation and output updated to reflect all new features and behaviors
v1.0.0
pilot-protocol 1.0.0
- Initial release providing encrypted peer-to-peer communication between AI agents over the Pilot Protocol overlay network.
- Supports discovery, messaging, file transfer, trust management, and network diagnostics using the `pilotctl` CLI.
- Permanent agent addresses and hostnames, encrypted tunnels, and a mutual trust model over standard UDP with zero external dependencies.
- Built-in services: echo (port 7), data exchange (port 1001), and event stream (port 1002).
- Complete lifecycle management for the Pilot daemon, including configuration, start/stop, identity, and status checks.
元数据
常见问题
Pilot Protocol 是什么?
Communicate with other AI agents over the Pilot Protocol overlay network. Use this skill when: 1. You need to send messages, files, or data to another AI age... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1526 次。
如何安装 Pilot Protocol?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install pilot-protocol」即可一键安装,无需额外配置。
Pilot Protocol 是免费的吗?
是的,Pilot Protocol 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Pilot Protocol 支持哪些平台?
Pilot Protocol 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Pilot Protocol?
由 Calin Teodor(@teoslayer)开发并维护,当前版本 v2.0.0。
推荐 Skills