具体操作（含核心命令）

GracyBot 配置文档

1. 配置NapCat WebUI

访问 http://服务器IP:6099，用安装NapCat时保存的token登录。

服务端配置：

类型：HTTP
主机：localhost
端口：3000
消息格式：array
Token：留空
保存并启用

客户端配置：

URL：http://localhost:3002/callback
消息格式：array
Token：留空
保存并启用开关

2. 配置GracyBot

编辑配置文件：

                cd /root/GracyBot
                nano core/config.py
            

修改关键配置：

                ROBOT_QQ = "你的机器人QQ"
                MASTER_QQ = "你的QQ"
                # 其他配置一般无需修改
            

3. 验证配置

启动测试：

                cd /root/GracyBot
                source venv/bin/activate
                python3 bot.py
            

查看日志确认无报错，向机器人发送消息测试响应。

4. 问题排查

连接失败：检查NapCat服务端是否启用
无响应：确认客户端URL配置正确
查看日志：tail -f /root/GracyBot/bot.log

✅ 配置完成后即可正常使用机器人功能，可前往项目架构了解代码结构，或直接查看 Bot入门学习基础操作。

核心命令汇总

                # NapCat相关命令
                napcat start <你的QQ号>  # 启动NapCat并登录
                napcat stop             # 停止NapCat服务
                napcat status           # 查看NapCat运行状态

                # GracyBot相关命令
                cd /root/GracyBot               # 进入项目目录
                source venv/bin/activate        # 激活虚拟环境
                python3 bot.py                  # 启动GracyBot（测试模式）
                sudo systemctl start bot        # 启动GracyBot服务（后台运行）
                sudo systemctl restart bot      # 重启GracyBot服务
                sudo systemctl stop bot         # 停止GracyBot服务
                sudo systemctl status bot       # 查看GracyBot服务状态
                tail -f /root/GracyBot/bot.log  # 实时查看运行日志
            