Bot入门
Bot入门文档
快速开始
1. 基础消息交互
GracyBot支持多种消息触发方式,适配私聊和群聊双场景:
私聊场景:
- 直接发送消息即可触发对应功能
- 使用//前缀触发AI对话
- 特定关键词触发自动回复
群聊场景:
- @机器人 + 消息内容
- 使用//前缀的AI对话
- 支持插件指令响应
2. 基础指令系统
框架内置基础指令,无需安装插件即可使用:
/运行状态 # 查看系统状态
/关于 # 查看框架信息
/info # 系统信息(同/运行状态)
3. 权限说明
用户分级管理,保障功能安全使用:
- 主人权限:最高权限,可执行所有管理命令(默认配置文件中MASTER_QQ对应的账号)
- 普通用户:基础功能使用权限,可触发插件指令和AI对话
4. 插件使用
插件通过指令触发,通用格式为:
/插件指令 [参数]
示例:
/复读 你好! # 小禹插件的复读功能
/启动Linux # Linux终端插件
5. AI对话功能
触发方式:
- 私聊:
//你要问的内容 - 群聊:
@机器人 //你要问的内容或//你要问的内容
特性:
- 支持上下文记忆
- 可自定义AI人设
- 主人可配置API参数
6. 日志查看
实时查看Bot运行状态和功能执行日志:
# 在GracyBot目录下执行
tail -f bot.log
7. 服务管理
使用systemd管理机器人后台服务(推荐):
# 启动服务
sudo systemctl start bot
# 查看状态
sudo systemctl status bot
# 重启服务
sudo systemctl restart bot
# 停止服务
sudo systemctl stop bot
遇到问题?欢迎反馈至:admin@gracybot.xyz