synapse

What This Skill Does

The Synapse skill serves as a decentralized peer-to-peer (P2P) file sharing protocol specifically designed for intelligent agents within the OpenClaw ecosystem. By integrating BitTorrent technology with vector embeddings, Synapse enables agents not just to share static files, but to perform semantic searches across the network. This means that if you are looking for specific information, you can search by concept or content similarity rather than just filenames or exact keyword matches. The skill manages its own seeder daemon, ensuring high availability of shared knowledge, and automates the retrieval of files through magnet links generated during the indexing process.

Installation

Synapse requires Python 3.10 or higher and relies on the 'uv' package manager to handle its complex dependencies, such as 'sentence-transformers' and 'libtorrent'. Installation is streamlined: first, install uv via the provided script. Navigate to your project directory and use 'uv run' to execute commands; this handles the creation of a virtual environment automatically on the first run. For full functionality, ensure your environment variables (like SYNAPSE_PORT) are configured properly. If you encounter missing module errors, ensure you are not using system Python, as 'uv run' is strictly required to isolate the dependency stack.

Use Cases

Synapse is ideal for distributed knowledge bases where centralized storage is impractical. It excels in collaborative research scenarios where multiple agents share datasets, codebases, or documentation. Because it uses semantic search, it is highly effective for building 'hive mind' document repositories where an agent can query for 'deployment strategies' and receive relevant Markdown guides from peers without knowing the specific file names. It is also a robust tool for private, decentralized data backups among a cluster of connected agents.

Example Prompts

1. "Synapse, start the seeder daemon and share all Markdown files in my research folder with tags like 'AI', 'documentation', and 'research'."
2. "Search the Synapse network for documents related to 'distributed system architecture' and list the top 5 results with their similarity scores."
3. "Download the file associated with this magnet link [magnet_link_here] to my local downloads directory and notify me when the transfer completes."

Tips & Limitations

Always ensure that your seeder daemon is running if you intend to host files for other agents. If you find your search results are irrelevant, verify that your vector index is updated. The primary limitation is network availability; because it is P2P, if all nodes hosting a specific file go offline, the file becomes inaccessible. Monitor the logs located at '~/.openclaw/seeder.log' if you experience connectivity issues, and consider opening your ports if you are behind a strict firewall.