| name | channel-hub |
| description | Unified channel management — setup, monitor, and manage all messaging channels (iMessage, WhatsApp, Discord) from one place. |
| metadata | {"author":"fae","version":"1.0"} |
Channel Hub
You are helping the user set up and manage their messaging channels. Fae can communicate through iMessage, WhatsApp, and Discord — all running locally on this Mac.
Activation
User says: "set up my channels", "connect WhatsApp", "how do I get you on Discord", "manage my messaging", "channel status".
Channel Overview
| Channel | Protocol | Requirements | Status Check |
|---|
| iMessage | Local SQLite + AppleScript | macOS Messages.app signed in | channel_setup with channel=imessage |
| WhatsApp | HTTP webhook + Meta Graph API | WhatsApp Business account + webhook URL | channel_setup with channel=whatsapp |
| Discord | WebSocket Gateway + REST API | Discord bot token + server invite | channel_setup with channel=discord |
Setup Flow
Quick Status Check
When user asks about channels:
- Use
channel_setup tool with action status for each channel
- Report which channels are active, which need setup:
"Here's your channel status:
- iMessage: Active — monitoring for messages
- WhatsApp: Not configured — needs webhook setup
- Discord: Active — connected to 2 servers
Want me to help set up WhatsApp?"
iMessage Setup
Activate the channel-imessage skill for detailed setup. Key steps:
- Grant Fae access to Messages database (Full Disk Access in Privacy settings)
- Fae polls the SQLite database for new incoming messages
- Replies are sent via AppleScript through Messages.app
No API keys needed. Everything is local Apple infrastructure.
WhatsApp Setup
Activate the channel-whatsapp skill for detailed setup. Key steps:
- Create a Meta Business account and WhatsApp Business app
- Configure webhook URL pointing to Fae's local server
- Set the verification token and app secret in Fae's channel config
Note: WhatsApp requires a Meta Business account (free but needs verification). This is a Meta platform requirement, not a Fae requirement.
Discord Setup
Activate the channel-discord skill for detailed setup. Key steps:
- Create a Discord application at discord.com/developers
- Create a bot, copy the token
- Configure the token in Fae's channel config
- Invite the bot to your server with message permissions
Note: Discord requires a bot token (free, no payment needed).
Cross-Channel Behaviour
When Fae receives a message from any channel:
- The sender is treated as a non-owner guest by default
- No tool access is granted to channel messages (text-only responses)
- The primary user (you) can grant specific guests temporary tool access
- Fae maintains separate conversation context per channel + sender
Security Model
- All inbound channel messages are sandboxed — guests cannot access your tools, files, or memory
- Outbound responses are text-only (no tool results, no sensitive data)
- You can introduce people to Fae and optionally grant them access levels
- Channel credentials are stored in the macOS Keychain, not in config files
Monitoring
Use channel_setup with action status periodically. If a channel disconnects:
- iMessage: check that Messages.app is running
- WhatsApp: check webhook health and token expiry
- Discord: check bot online status and gateway connection
Future: Unified Gateway
Currently each channel runs as a separate adapter. A future architecture milestone will unify them into a single gateway with:
- Normalised message format across all channels
- Shared session state (same conversation context regardless of channel)
- Single-process multi-channel management
- Cross-channel message routing (reply to WhatsApp from Discord)
This is inspired by OpenClaw's gateway architecture and is planned for a future release.
