Pallas-Bot

外观

快速开始 ​

字数
888 字
阅读时间
4 分钟

这一页带你完成第一次启动：打开网页控制台，并为连接 QQ 做好准备。Bot 启动后还需要 连接 QQ，它才能在群里收发消息。

开始前准备 ​

需要准备用途
一台能长期运行的电脑或服务器运行 Bot 和网页控制台
一个用于机器人的 QQ 账号连接协议端后收发群消息
Release 部署包、源码环境或 Docker按使用场景安装 Bot

PostgreSQL 是默认数据库。Docker 部署会一并启动它；源码部署可以使用本机数据库，也可以用 Docker 单独启动。

LLM、唱歌和画图都不是首次启动的前置条件。先让 Bot 正常上线，之后再按需安装插件或配置 AI。

第 1 步：选择部署方式 ​

你的情况推荐方式完成后你会得到
想直接部署到服务器，不准备修改代码Docker 部署Bot、数据库和控制台容器
不使用 Docker，也不准备修改代码Release 部署包已包含 WebUI、可自动更新的精简 Bot 目录
要开发、调试或修改主仓代码源码安装本地 Python 环境和可运行的 Bot

新手推荐

没有源码开发需求时，优先选择 Docker；不使用 Docker 时选择 Release 部署包。只有需要修改本体或参与开发时才 clone 源码仓库。

下载慢或失败

先看报错来自哪里：拉容器镜像或构建基础镜像，见 Docker 下载慢与镜像源；uv sync 下载 Python 依赖失败，见 Python 依赖镜像源。控制台自带的 Git 镜像源只用于 GitHub 资源，不能替代这两类配置。

按所选文档完成安装、填写 superusers 与数据库配置，然后启动 Bot。

第 2 步：确认 Bot 已启动 ​

启动成功后，先检查下面三件事：

  1. 终端日志没有持续出现数据库连接失败。
  2. 日志中出现网页控制台的初始密码。
  3. 浏览器能打开 http://<主机>:8088/pallas/。

本机运行时，<主机> 填 127.0.0.1。部署在服务器上时，换成服务器 IP 或域名，并确认防火墙已放行 8088。

首次只看到控制台、还没有 QQ 消息是正常的：这说明 Bot 本体已经运行，但协议端尚未连接。

第 3 步：连接 QQ 并完成验收 ​

打开 连接 QQ，在协议端管理页新建 NapCat 实例并扫码登录。

协议端显示“在线”后，把机器人拉进测试群并发送：

text
牛牛帮助

能收到帮助图，表示 Bot、协议端和群消息链路已经正常工作。

接下来做什么 ​