realvco Docs

Messaging Overview

Route your AI companions into the messaging apps you already use — chat from anywhere, no browser required.


Which Platform Should I Pick?

There is no perfect platform; the pick depends on your use case:

PlatformBest ForDifficultyCostEngine
TelegramTechnical users, internal comms, globalFreeOpenClaw + Hermes
LINETaiwan, Japan, Thailand⭐⭐⭐Free up to 500 msgs / monthOpenClaw
WhatsAppAmericas, Europe, SE Asia, international business⭐⭐⭐⭐Free for personal; paid Business APIOpenClaw
SlackEnterprise, dev teams⭐⭐Free / ProOpenClaw + Hermes
DiscordCommunities, gaming, creators⭐⭐FreeOpenClaw
Signal / DingTalk / MatrixAdvanced users⭐⭐⭐FreeHermes

Not sure?Telegram. Five-minute setup, fully free, ideal for your first connection.


E-commerce Support

  • LINE → Ada — primary support channel (Taiwan / Japan)
  • Telegram → Rose — internal ops group, system alerts

International SaaS Company

  • WhatsApp Business API → Ada — production customer service
  • Slack → Vi — engineering team queries and analysis

Personal Automation

  • Telegram → Rose — cron jobs, push notifications
  • Telegram → Vi (second bot) — data analysis, note summarization

General Connection Flow

Details vary per platform, but the shape is the same:

① Create a bot or channel on the platform (Telegram / LINE / Meta)
② Obtain credentials (Token, Channel Secret, API Key, etc.)
③ In the Admin Panel, open the companion's tab → Settings → Messaging → paste credentials
④ The platform may ask for a Webhook URL (the Admin Panel provides one)
⑤ Test: send a message to the bot on the platform — the AI should respond

Companion ↔ Platform Support

CompanionEngineDefault Platforms
Rose (oc-1)OpenClawTelegram, WhatsApp, LINE, Slack, Discord, QQ, Feishu, Teams, …
Ada (oc-2)OpenClawSame as Rose
Vi (hm-3)HermesTelegram, Signal, DingTalk, Matrix, SMS, Mattermost, Webhook, …

Key points:

  • Each companion can connect to multiple platforms at once
  • Each platform bot can be bound to one companion
  • OpenClaw has stronger support for LINE, WhatsApp, and East Asian platforms (QQ, Feishu)
  • Hermes has stronger support for enterprise platforms (Signal, Matrix, SMS)

Security Notes

Bot Tokens and API keys are passwords. Leaking one is equivalent to handing over your AI account.

  • Do not post screenshots publicly
  • Do not hard-code them in frontend code
  • If leaked, revoke/regenerate on the platform immediately

Message data path — when the AI reads a message, it passes through:

  1. The platform (LINE / Meta / Telegram)
  2. Your realvco host (messages are temporarily stored in the Activity Log)
  3. Your AI model provider (OpenAI / Anthropic / etc., depending on your settings)

See Connectivity & Security for details.


FAQ

Can one companion handle multiple platforms at the same time?

Yes. Ada can listen on Telegram + LINE + WhatsApp simultaneously, and every message flows into the same Ada.

Can multiple companions share one platform?

Depends on the platform:

  • Telegram: create multiple bots, bind each to a different companion ✅
  • LINE: create multiple channels, bind each ✅
  • WhatsApp: each phone number can only be bound to one ⚠️

Can realvco see the messages?

No. Message flow: Platform → your VPS → AI provider. realvco is not in that path. See Security Best Practices.

Can the AI send images?

Most platforms support two-way media:

  • Read: the AI can see and interpret images
  • Send: the AI can send images (Rose and Vi can also generate them)

Exceptions: WhatsApp has a 64 MB media cap. LINE stickers are read-only — the AI cannot reply with native stickers.


Platform Tutorials

Further Reading