cross-platform-relay

Relay messages bidirectionally between WeChat, QQ, and Telegram with roleplay tagging and platform-specific behavior modes.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill cross-platform-relay-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cross-platform-relay
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/productivity/cross-platform-relay
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill cross-platform-relay-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating conversations across multiple messaging platforms (WeChat, QQ, Telegram) requires manually copying messages between apps, and naive automation breaks down on platform quirks like QQ Bot push timeouts, WeChat iLink rate limiting, and identity confusion between family members on different platforms. ## Core Features & Use Cases - Bidirectional Message Relay: Forward messages between two platforms with sender-tagged labels (e.g., 【妈妈传话】/【爸爸传话】), natural paraphrasing, emoji flair, and first-person voice framing so relays read like direct messages. - Per-Platform Identity & Behavior Modes: Maintain distinct personas per platform (work mode on Telegram, play mode on QQ/WeChat) with strict routing rules that keep family chat off work channels. - Platform Workarounds: Direct REST API sends for QQ Bot (bypassing hermes send timeouts), WeChat iLink rate-limit handling with circuit-breaker-aware retries, file delivery via uguu.se upload, and tesseract OCR fallback for images. - Use Case: A family setup where mom chats on WeChat and dad on QQ — the agent relays messages between them with correct roleplay identity, while dad's Telegram stays strictly work-only. ## Quick Start Set up a bidirectional relay between my WeChat and QQ accounts so messages from mom on WeChat get forwarded to dad on QQ with proper sender tags.

Frequently Asked Questions about cross-platform-relay

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I relay messages between WeChat and Telegram automatically?

Use hermes send -q --to <platform> to forward messages with a sender tag prefix like 【妈妈传话】. Detect relay requests by patterns like "和妈妈说xxx" or "告诉爸爸xxx", paraphrase naturally, and never add meta-commentary or reply confirmations to the sender.

Why does hermes send to QQ Bot time out silently?

QQ Bot can only reply within an active session and cannot receive standalone pushes via hermes send. Use the Tencent QQ Bot REST API directly with appId and clientSecret to get an access token, then POST to api.sgroup.qq.com to deliver messages reliably.

How do I avoid WeChat iLink rate limiting when sending multiple messages?

Bundle all content into a single hermes send call instead of separate sends. The iLink circuit breaker extends the 30-second cooldown on every failed retry, so wait 60-90 seconds and retry only once if rate-limited.

Can I send files or images to WeChat users through a bot?

WeChat iLink bots cannot deliver MEDIA: paths or raw URLs as openable files. Upload the file to uguu.se, verify the returned URL serves raw bytes with curl, then send the direct download link as plain text.

What happens when two gateways share the same WeChat bot token?

Both gateways receive and process every inbound message, which can leak family messages into work channels like Telegram. Fix it by using separate bot tokens per instance, disabling WeChat on the work gateway, or suppressing cross-platform forwards.

How do I read images from WeChat when the vision model fails?

Fall back to local tesseract OCR with chi_sim+eng language packs for text-bearing images. Preprocess photos with grayscale, contrast boost, and 2x upscaling; if OCR returns empty, ask the user to describe the image instead of retrying.