astrbot_plugin_proactive_chat
一个能让 Bot 在私聊和群聊中发起主动消息的插件,拥有上下文感知、持久化数据、动态情绪、免打扰时段和 TTS 集成。还有独立 WebUI,可进行个性化配置。 An AstrBot plugi
What is astrbot_plugin_proactive_chat?
一个能让 Bot 在私聊和群聊中发起主动消息的插件,拥有上下文感知、持久化数据、动态情绪、免打扰时段和 TTS 集成。还有独立 WebUI,可进行个性化配置。 An AstrBot plugin that enables Bot to send proactive messages in private and group chats, featuring context awareness, persistent data, dynamic emotions, do-not-disturb periods, and TTS integration. It also boasts an independent WebUI for personalized.
Overview of astrbot_plugin_proactive_chat
What it is
A plugin for AstrBot that enables the bot to send proactive messages in private and group chats. It features context awareness, persistent data, dynamic emotions, do-not-disturb periods, and TTS integration. It also includes an independent WebUI for personalized configuration.
Key features
- Timed triggering: automatically triggers after a random time range based on user silence duration.
- Automatic proactive messages: the plugin can automatically start creating proactive message tasks on each reload without user input.
- Multi-session support: supports multiple private and group chats simultaneously, each with its own configuration and alias.
- Complete session isolation: each session has its own state, counters, and triggers to avoid interference.
- Context awareness: flexibly selects context sources, reviews historical conversations, and generates replies related to previous topics.
- Full personality support: loads and applies the personality set for each session.
- Dynamic emotions: includes an unread reply counter that can be used in prompts to design different emotional expressions, with a configurable upper limit.
- Persistent sessions: restores all unexecuted proactive message tasks from files after restarting AstrBot or reloading the plugin.
- Do-not-disturb periods: allows setting a time range during which the bot will not proactively disturb users.
- TTS integration: supports calling configured TTS services to generate voice.
- Segmented replies: splits long text replies into multiple short messages and simulates real typing intervals.
- High compatibility: compatible with other plugins that need to modify proactive messages, such as sticker plugins.
- Quick configuration: all core configurations can be easily set in AstrBot's WebUI or the plugin's own WebUI.
Use cases
- Making an AI companion more lifelike by having it initiate conversations when the user is idle.
- Keeping group chats active by having the bot send context-aware messages after periods of silence.
- Providing emotional companionship through proactive, personality-driven interactions.
Getting started
- Download the plugin from the AstrBot plugin market or from the GitHub Releases as a .zip file, then install it via the AstrBot WebUI.2. Install dependencies if missing:
bashpip install fastapi uvicorn# For Python < 3.11pip install tomli>=2.0; python_version < '3.11'3. Restart AstrBot if the plugin does not load correctly.4. Configure the plugin in the AstrBot WebUI or the plugin's own WebUI.5. Use the /sid command in the target chat to get the session UMO, then fill it in the plugin configuration.
License and pricing
License: AGPL-3.0. Pricing: open source (free).
Based on the project's public README and repository metadata.