hermes-agent/plugins/platforms/whatsapp/plugin.yaml
Teknium 5600105478 refactor(gateway): migrate slack/dingtalk/whatsapp/matrix/feishu/telegram/wecom/email/sms adapters to bundled plugins
Salvage of PR #41284 onto current main. Relocates the last 9 inline messaging
adapters (+ satellites: telegram_network, feishu_comment/_rules/meeting_invite,
wecom_crypto, wecom_callback) from gateway/platforms/ into self-contained
bundled plugins under plugins/platforms/<x>/, discovered via the platform
registry. Strips the per-platform core touchpoints from gateway/run.py,
gateway/config.py, hermes_cli/gateway.py, hermes_cli/setup.py, and
tools/send_message_tool.py.

Carries forward the migration fixes (explicit enabled:false honored,
get_connected_platforms forces discovery, plugin is_connected via
gateway.get_env_value, logs --component gateway matches plugins.platforms.*,
matrix hidden on Windows).

Additionally ports config keys main added since the PR base: the matrix
plugin's _apply_yaml_config now also covers allowed_users,
ignore_user_patterns, process_notices, and session_scope (the inline
gateway/config.py matrix block gained these in the 1340 commits the PR sat
open; they would otherwise have been silently dropped on deletion).
2026-06-20 10:26:45 -07:00

33 lines
1.2 KiB
YAML

name: whatsapp-platform
label: WhatsApp
kind: platform
version: 1.0.0
description: >
WhatsApp gateway adapter for Hermes Agent.
Connects to WhatsApp via a local Node.js bridge (WhatsApp Web client) over
an HTTP API and relays messages between WhatsApp chats and the Hermes agent.
Supports DM/group policies, mention gating, free-response chats, and
per-user allowlists.
author: NousResearch
requires_env:
- name: WHATSAPP_ENABLED
description: "Enable the WhatsApp adapter (requires the Node.js bridge running)"
prompt: "Enable WhatsApp? (true/false)"
password: false
optional_env:
- name: WHATSAPP_ALLOWED_USERS
description: "Comma-separated WhatsApp user IDs allowed to talk to the bot"
prompt: "Allowed users (comma-separated)"
password: false
- name: WHATSAPP_ALLOW_ALL_USERS
description: "Allow any WhatsApp user to trigger the bot (dev only)"
prompt: "Allow all users? (true/false)"
password: false
- name: WHATSAPP_HOME_CHANNEL
description: "Default chat ID for cron / notification delivery"
prompt: "Home channel ID"
password: false
- name: WHATSAPP_HOME_CHANNEL_NAME
description: "Display name for the WhatsApp home channel"
prompt: "Home channel display name"
password: false