MediaSync-Claw
This tool automatically downloads and executes the third-party 'frpc' binary from GitHub to establish an active outbound reverse tunnel. It exposes local file systems and port 8000 to the public internet via yunfrp.net subdomains. Additionally, it initiates outbound WebSocket/WebRTC signaling and co Skill: MediaSync-Claw Owner: yu-libin Summary: This tool automatically downloads and executes the third-party 'frpc' binary from GitHub to establish an active outbound reverse tunnel. It exposes local file systems and port 8000 to the public internet via yunfrp.net subdomains. Additionally, it initiates outbound WebSocket/WebRTC signaling and co Tags: latest:0.1.11 Version history: v0.1.11 | 2026-09-10T04:52:42.115Z
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 10, 2026
Version
0.1.11
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.1.11release · observed Sep 10, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s1782732d9g12n6jwbtz1qv8qs87zcac:mediasync-claw- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-yu-libin-mediasync-claw/snapshot"
Documentation
CLAWHUB
128,039 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: MediaSync-Claw
version: 1.0.11
description: This tool automatically downloads and executes the third-party 'frpc' binary from GitHub to establish an active outbound reverse tunnel. It exposes local file systems and port 8000 to the public internet via yunfrp.net subdomains. Additionally, it initiates outbound WebSocket/WebRTC signaling and connects to external STUN servers for peer-to-peer media streaming, enabling remote file access.
author: OpenClaw User
type: workspace
language: python
entrypoint: media_server_flask.py
requires:
bins:
- python3
- uv
python:
- "flask>=3.1.3"
- "requests>=2.32.4"
- "jinja2>=3.1.6"
- "aiortc"
- "aiofiles"
- "flask-socketio"
actions:
- name: list_files
description: "Call this tool when the user wants to view, list, play, or search for local videos or playlists (playlist/video library)."
url: "http://127.0.0.1:8000/api/list_files"
method: "POST"
parameters:
type: object
properties:
query:
type: string
description: "Keywords or filter conditions for the user query, optional."
required: []
permissions:
- filesystem:read
- filesystem:write
- network:listen
- network:connect
- process:execute
- network:access:internal
- network:access:internet
---
# MediaSync-Claw
## 🚀 Overview
### Prerequisites:
* **Environment**: Local OpenClaw environment successfully deployed.
* **Windows**: Trust/add exception for `frpc.exe` in your security software if blocked.
* **macOS**: On first run, macOS Gatekeeper may block the downloaded `frpc` binary. Go to **System Preferences > Security & Privacy** and click "Allow Anyway" if prompted.
### Specific Steps:
1. **Install**: Download and install the `MediaSync-Claw` skill via ClawHub.
2. **Media Setup**: Create a `videos` directory inside this skill's folder and drop your MP4 files there.
3.**Integration**: Link and configure your WhatsApp channel in OpenClaw.
4. **Launch**: Start the `MediaSync-Claw` skill in OpenClaw.
5. **Interact (LLM-Driven)**: Chat with the AI naturally in your channel. For example:
* *"Show me my video list."*
* *"Do I have any movie to watch?"*
* *"Play the video about cat."*
6. **Play**: Click the generated link from the response to play your video.
## 💡 LLM Agent Mode Active
This skill operates entirely at the **LLM Action/Tool execution level**. OpenClaw no longer intercepts requests via rigid keyword matching. Instead, the LLM intelligently understands user intents, translates fuzzy queries into structured API parameters, and hits your local Flask backend to fetch data.
*Note: `media_server_flask.py` should return clean JSON data (e.g., file lists, file URLs). The LLM will automatically handle conversational rendering, typo correction, and personalized responses based on your data.*
## 🔒 Security & Network Disclosure
### ⚠️ Critical: FRP Tunnel ExposeREADME.md
<div align="center"> # MediaSync-Claw: Remote P2P Media Server & Streaming Skill for OpenClaw **[ 🌐 Visit Official Website & Full Documentation ](https://poly-ai.chat/mediasync-claw)** [English](README.md) | [简体中文](README_ZH.md) | [日本語](README_JA.md) | [Deutsch](README_DE.md) | [Español](README_ES.md) </div> --- ## 📖 Overview & Core Value **MediaSync-Claw** is a dedicated **OpenClaw Skill** and **Remote P2P Media Server** developed by [Poly AI](https://poly-ai.chat). Its core value is enabling users to access, index, and stream their local home PC media library **anytime, anywhere via WhatsApp** using the OpenClaw AI agent. The generated media list supports seamless playback with the **AIpollo Player** via high-speed P2P tunneling. For advanced configurations, enterprise support, and the latest updates, please visit our **[Official Product Page](https://poly-ai.chat/mediasync-claw)**. --- ## ⚙️ Prerequisites * **OpenClaw**: Ensure OpenClaw is deployed and running in your local environment. * **Firewall / Antivirus Whitelist**: Add an exception (trust rule) for `frpc.exe` in your Windows Defender or antivirus software. *We ensure that `frpc.exe` is completely safe and unaltered.* --- ## 🚀 Step-by-Step Installation & Usage 1. **Download & Install**: Clone or download this repository into your OpenClaw skills directory. 2. **Setup Media Library**: Create a `videos` directory inside the skill folder and place the MP4 video files you wish to access remotely into it. 3. **Configure WhatsApp**: Connect and configure your WhatsApp channel within OpenClaw. 4. **Launch Skill**: Run the MediaSync-Claw skill in OpenClaw. 5. **Remote Command via WhatsApp**: In your WhatsApp chat, send natural language requests (e.g., when you want to view, list, search, or play local videos/playlists from your video library) to trigger this skill and generate the media list. 6. **One-Click Playback**: Click the generated link from the media list to start streaming on AIpollo Player. --- ## 🔒 Security Disclosures & Risk Management ### Risk 1: Public Network Routing via FRP Reverse Proxy To provide convenient remote media streaming across restricted local networks, this skill establishes an outbound tunnel using the FRP (Fast Reverse Proxy) client (`frpc`) to connect with an `frps` relay server. This enables public routing for your local media service via the `*.yunfrp.net` domain. ### Risk 2: Plaintext HTTP Transmission & P2P Stream Architecture The actual video streaming of this skill relies on **P2P direct connections**. HTTP is strictly used for transmitting lightweight control instructions and never carries sensitive personal user data. ### Risk 3: Automated `frpc.exe` Binary Retrieval To support cross-network NAT traversal and reverse proxying, the required `frpc.exe` binary is fetched directly from official GitHub releases to ensure maximum supply-chain integrity and security. --- ## 🛡️ Best Practice Recommendations * **Dedicated Server / Vi
_meta.json
{
"ownerId": "kn723yj2g3pgy4vx13sg58hyk187z678",
"slug": "mediasync-claw",
"version": "0.1.11",
"publishedAt": 1789015962115
}CHANGELOG.md
# Changelog ## - 2026-08-24 - fix path issue ## - 2026-08-20 - fix security issue ## - 2026-08-14 - update the player URL generation logic. ## - 2026-07-30 - fix security issue. ## - 2026-07-16 - fix bug about file hash validation. ## - 2026-05-28 - Initial release with dynamic frpc environment setup.
README_DE.md
<div align="center"> # MediaSync-Claw: Remote P2P-Medienserver & Streaming-Skill für OpenClaw [English](README.md) | [简体中文](README_ZH.md) | [日本語](README_JA.md) | [Deutsch](README_DE.md) | [Español](README_ES.md) </div> --- ## 📖 Übersicht & Kernfunktionalität **MediaSync-Claw** ist ein dedizierter **OpenClaw-Skill** und **P2P-Medienserver** für das persönliche Video- und Audiostreaming im Homelab- und Self-Hosted-Bereich. Über die Anbindung von OpenClaw an WhatsApp können Sie jederzeit und von überall auf die Medienbibliothek Ihres lokalen Heim-PCs zugreifen. Die generierte Medienliste ermöglicht ein schnelles, verlustfreies P2P-Streaming über den **AIpollo Player**. --- ## ⚙️ Systemanforderungen * **OpenClaw**: OpenClaw ist lokal installiert und einsatzbereit. * **Firewall- / Antivirus-Freigabe**: Fügen Sie `frpc.exe` als Ausnahme in Windows Defender oder Ihrer Sicherheitssoftware hinzu. *Wir garantieren, dass `frpc.exe` absolut sicher und ungepatcht ist.* --- ## 🚀 Schritt-für-Schritt Installationsanleitung 1. **Download & Installation**: Klonen oder laden Sie dieses Repository in das Skills-Verzeichnis von OpenClaw herunter. 2. **Medienordner anlegen**: Erstellen Sie im Skill-Verzeichnis einen Ordner namens `videos` und hinterlegen Sie dort die MP4-Videodateien. 3. **WhatsApp konfigurieren**: Richten Sie die WhatsApp-Schnittstelle in OpenClaw ein. 4. **Skill ausführen**: Starten Sie den MediaSync-Claw-Skill in OpenClaw. 5. **Fernsteuerung via WhatsApp**: Senden Sie einen Befehl über WhatsApp (z. B. wenn Sie Videos auflisten, suchen oder abspielen möchten), um die Medienliste abzurufen. 6. **Wiedergabe starten**: Klicken Sie auf den generierten Link in der Medienliste, um den Stream im AIpollo Player zu starten. --- ## 🔒 Sicherheits- und Risikohinweise ### Risiko 1: Öffentlicher Netzwerkzugriff via FRP-Reverse-Proxy Um Medien hinter NAT-Routern und Firewalls erreichbar zu machen, baut der FRP-Client (`frpc`) einen ausgehenden Tunnel zu einem Relay-Server (`frps`) auf. Dadurch wird der lokale Dienst über die Domain `*.yunfrp.net` erreichbar. ### Risiko 2: HTTP-Klartextübertragung & P2P-Streaming Das eigentliche Videostreaming erfolgt über eine **direkte P2P-Verbindung**. Über HTTP werden ausschließlich Steuerbefehle übertragen; es werden keine sensiblen Benutzerdaten übertragen. ### Risiko 3: Bezug der ausführbaren Datei `frpc.exe` Um die Integrität der Lieferkette zu gewährleisten, wird die Binärdatei `frpc.exe` direkt aus den offiziellen GitHub-Releases bezogen. --- ## 🛡️ Sicherheitsempfehlungen * **Dedizierte Hardware / Virtuelle Maschine**: Für maximale Sicherheit empfehlen wir, diesen Dienst auf einem separaten Server (z. B. Homelab/NAS) oder in einer isolierten virtuellen Maschine (VM) zu betreiben. * **Regelmäßige Updates**: Halten Sie Ihr Betriebssystem und Ihre OpenClaw-Umgebung stets auf dem neuesten Stand. --- ## 💻 Plattformkompatibilität * **Aktuell unterstützt**: Windows (x64) * **In Entwicklung**: Linux /
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/yu-libin/skills/mediasync-claw",
"sourceUrl": "https://clawhub.ai/yu-libin/skills/mediasync-claw",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T23:49:47.451Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-yu-libin-mediasync-claw/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-yu-libin-mediasync-claw/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T23:49:47.451Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/yu-libin/mediasync-claw",
"sourceUrl": "https://clawhub.ai/yu-libin/mediasync-claw",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T23:49:47.451Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.11",
"href": "https://clawhub.ai/yu-libin/mediasync-claw",
"sourceUrl": "https://clawhub.ai/yu-libin/mediasync-claw",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T04:52:42.115Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-yu-libin-mediasync-claw/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-yu-libin-mediasync-claw/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.11",
"description": "- Added platform-specific instructions for Windows (antivirus) and macOS (Gatekeeper) in the prerequisites section of the documentation. - Clarified that the binary automatically downloaded is platform-specific (Windows: frpc.exe, macOS/Linux: frpc).",
"href": "https://clawhub.ai/yu-libin/mediasync-claw",
"sourceUrl": "https://clawhub.ai/yu-libin/mediasync-claw",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T04:52:42.115Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
