-
-
Notifications
You must be signed in to change notification settings - Fork 2.1k
zh use proactive agent
github-actions[bot] edited this page Mar 9, 2026
·
1 revision
AstrBot 引入了主动 Agent(Proactive Agent)系统,使 AstrBot 不仅能被动响应用户,还能通过给自己下达未来的任务来在未来的指定时刻主动执行任务并向用户主动反馈结果(文本、图片、文件都可)。
在 v4.14.0 引入,目前是实验性功能,未稳定。
主 Agent 现在可以管理一个全局的 Cron Job 列表,为未来的自己设置任务。
- 自我唤醒:AstrBot 会在预定时间自动唤醒并执行任务。
- 任务反馈:执行完成后,AstrBot 会将结果告知任务布置方。
- WebUI 管理:你可以在 WebUI 的“定时任务”页面查看、编辑或删除已设置的任务。
Tip
首先,确保配置中 “主动型能力” 已启用。
主 Agent 拥有管理定时任务的能力。你可以直接对它说:
- “明天早上 8 点提醒我开会”
- “每周五下午 5 点总结本周的工作日志”
- “帮我定一个 10 分钟后的闹钟”
主 Agent 会调用内置的定时任务工具来安排这些计划。
你可以在 AstrBot WebUI 左侧导航栏中点击 未来任务 来查看和管理所有未来任务。
“定时任务”的设置支持所有平台,然而,由于部分平台没有开放主动消息推送的 API,因此只有以下平台支持 AstrBot 主动向用户推送结果:
- Telegram
- OneBot v11
- Slack
- 飞书 (Lark)
- Discord
- Misskey
- Satori
为了方便 Agent 直接向用户发送图片、音频、视频等文件,AstrBot 默认提供了一个 send_message_to_user 工具。
- 直接发送:Agent 可以直接将生成或获取的多媒体文件发送给用户,而无需通过复杂的文本转换。
- 支持多种格式:支持图片、文件、音频、视频等。
- 首页
- 文档入口
- Top Level
- community events
- deploy
- dev
- others
- platform
- 接入 OneBot v11 协议实现
- 接入钉钉 DingTalk
- 接入 Discord
- 接入 Kook
- 接入飞书
- 接入 LINE
- 接入 Matrix
- 接入 Mattermost
- 接入 Misskey 平台
- 接入 QQ 官方机器人平台
- 通过 QQ官方机器人 接入 QQ (Webhook)
- 通过 QQ官方机器人 接入 QQ (Websockets)
- 接入 Satori 协议
- 接入 server-satori (基于 Koishi)
- 接入 Slack
- 接入消息平台
- 接入 Telegram
- 接入 VoceChat
- AstrBot 接入企业微信
- 接入企业微信智能机器人平台
- AstrBot 接入微信公众平台
- 接入个人微信
- providers
- use
- Home
- Docs Entry
- Top Level
- config
- deploy
- Deploy AstrBot on 1Panel
- Deploy AstrBot on BT Panel
- Deploy AstrBot on CasaOS
- Deploy AstrBot from Source Code
- Community-Provided Deployment Methods
- Deploy via Compshare
- Deploy AstrBot with Docker
- Deploy AstrBot with Kubernetes
- Deploy AstrBot with AstrBot Launcher
- Other Deployments
- Package Manager Deployment (uv)
- Installation via System Package Manager
- Preface
- dev
- ospp
- others
- platform
- Connect OneBot v11 Protocol Implementations
- Connect to DingTalk
- Connecting to Discord
- Connect to KOOK
- Connecting to Lark
- Connecting to LINE
- Connecting to Matrix
- Connecting to Mattermost
- Connecting to Misskey Platform
- Connect QQ Official Bot
- Connect QQ via QQ Official Bot (Webhook)
- Connect QQ via QQ Official Bot (Websockets)
- Connect to Satori Protocol
- Connect server-satori (Koishi)
- Connecting to Slack
- Messaging Platforms
- Connecting to Telegram
- Connect to VoceChat
- Connect AstrBot to WeCom
- Connect to WeCom AI Bot Platform
- Connect AstrBot to WeChat Official Account Platform
- Connect Personal WeChat
- providers
- 接入 302.AI
- Agent Runners
- Built-in Agent Runner
- Connect to Coze
- Connect to Alibaba Cloud Bailian Application
- Connect to DeerFlow
- Connect to Dify
- Connect AIHubMix
- coze
- dashscope
- dify
- 大语言模型提供商
- NewAPI
- 接入 PPIO 派欧云
- 接入 LM Studio 使用 DeepSeek-R1 等模型
- Integrating Ollama
- Connecting to SiliconFlow
- Connecting Model Services
- Connecting to TokenPony
- use
- Agent Runner
- Agent Sandbox Environment ⛵️
- astrbot sandbox
- Docker-based Code Interpreter
- Built-in Commands
- Computer Use
- Context Compression
- Custom Rules
- Function Calling
- AstrBot Knowledge Base
- MCP
- AstrBot Star
- Proactive Capabilities
- Anthropic Skills
- Agent Handoff and SubAgent
- Unified Webhook Mode
- Web Search
- WebUI

