📖 快速开始
1. 设置 Bot Token
前往 设置页面,输入从 BotFather 获得的 Token。
2. 添加定时任务
点击"添加新任务",填写任务信息:
- 任务名称:为任务起一个便于识别的名字
- 群组 ID:目标群组的 ID(负数)
- 发送时间:每天定时发送的时间
- 消息内容:要发送的消息,支持 HTML 格式
3. 启动机器人
在 SSH 终端执行:
cd /www/wwwroot/zd.sdhdhhsi.org && python3 bot.py &
⚠️ 重要:每次修改任务后,都需要重启机器人才能生效!
🔍 如何获取群组 ID
- 将机器人添加到目标群组
- 在群组中发送任意消息
- 查看机器人日志,找到类似这样的日志:
群组 -1001234567890 - 这个负数就是群组 ID
✨ 新功能说明
🔔 自动置顶和通知
机器人发送消息后会自动:
- 将消息置顶到群组顶部
- 通知所有群成员(类似 @所有人)
- 自动禁用任务
💡 提示:机器人需要有"置顶消息"权限才能自动置顶。在群组设置中将机器人设为管理员并勾选此权限。
🔒 一次性发送模式
任务发送后会自动禁用,适合每次内容不同的场景:
- 添加任务并启用
- 到达时间自动发送
- 任务自动禁用
- 下次使用时编辑内容并重新启用
💬 消息格式
支持 HTML 格式标签:
<b>粗体</b>- 粗体<i>斜体</i>- 斜体<a href="URL">链接文字</a>- 超链接<code>代码</code>- 行内代码
示例:
<b>📢 重要通知</b>
今天的活动已经开始!
🔗 查看详情: <a href="https://example.com">点击这里</a>
⚙️ 机器人管理
启动机器人:
cd /www/wwwroot/zd.sdhdhhsi.org && python3 bot.py &
停止机器人:
pkill -f bot.py
重启机器人:
pkill -f bot.py && cd /www/wwwroot/zd.sdhdhhsi.org && python3 bot.py &
查看日志:
tail -f /www/wwwroot/zd.sdhdhhsi.org/bot.log
❓ 常见问题
Q: 任务不发送怎么办?
A: 检查以下几点:
- 机器人是否在运行:
ps aux | grep bot.py - 任务是否已启用(绿色状态)
- 修改任务后是否重启了机器人
- 时间是否按服务器时区设置
Q: 置顶失败怎么办?
A: 确保机器人在群组中有"置顶消息"权限。将机器人设为管理员并勾选此权限。
Q: 如何设置每天重复发送?
A: 当前版本发送后会自动禁用。如需每天重复,需要每次手动重新启用任务。
🛠️ 技术支持
如遇到问题,请查看:
- 机器人日志 - 查看详细错误信息
- 检查服务器时间:
date - 检查数据库:
sqlite3 bot_config.db "SELECT * FROM scheduled_tasks;"