[弓手] 纸飞机 Rot搭建

Sat, 04 Apr 2026 16:42:50 +0800

准备工作

一台 Linux VPS 或本地机器：2 核 1G 内存够跑，推荐 Ubuntu 22.04 或 Debian 12
安装好 Docker：没装的话直接搜 Docker 官方文档安装，国内机器可以换 DaoCloud 加速源
一个纸飞机账号

第一步：部署 AstrBot

Docker Compose（推荐）

首先，需要 Clone AstrBot 仓库到本地：

git clone https://github.com/AstrBotDevs/AstrBot

cd AstrBot

然后，运行 Compose：

sudo docker compose up -d

带 Agent沙盒环境的部署

git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot
# 修改 compose-with-shipyard.yml 文件中的环境变量配置，例如 Shipyard 的 access token 等
docker compose -f compose-with-shipyard.yml up -d
docker pull soulter/shipyard-ship:lates

配置和使用详见 Agent 沙盒环境文档

第二步：创造一个新Bot

在Telegram客户端搜索@BotFather

向 BotFather 发送命令：

/newbot

按提示输入机器人名称和用户名（用户名需以 bot 或 _bot 结尾）

第三步：配置AstrBot

进入 AstrBot 的管理面板

点击左边栏机器人

然后在右边的界面中，点击 + 创建机器人

选择 telegram

弹出的配置项填写：

ID(id)：随意填写，用于区分不同的消息平台实例。

启用(enable): 勾选。

Bot Token: 你的 Telegram 机器人的 token。

请确保你的网络环境可以访问 Telegram。你可能需要使用配置页->其他配置->HTTP 代理来设置代理。

🎉 大功告成

[弓手] QQ 个人Rot搭建

Sat, 04 Apr 2026 08:00:00 +0800

准备工作

一台 Linux VPS 或本地机器：2 核 1G 内存够跑，推荐 Ubuntu 22.04 或 Debian 12
安装好 Docker：没装的话直接搜 Docker 官方文档安装，国内机器可以换 DaoCloud 加速源
一个 QQ 号：用来登录成机器人，强烈不建议用主号，风控触发直接封号很难受
一台手机：NapCat 登录 QQ 需要扫码，手机要在旁边

第一步：部署 AstrBot

Docker Compose（推荐）

首先，需要 Clone AstrBot 仓库到本地：

git clone https://github.com/AstrBotDevs/AstrBot

cd AstrBot

然后，运行 Compose：

sudo docker compose up -d

如果您想对接 NapCat，使用这种方式可以同时部署 AstrBot 和 NapCat

mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
sudo docker compose -f astrbot.yml up -d

通过 Docker 部署

mkdir astrbot
cd astrbot
sudo docker run -itd -p 6185:6185 -p 6199:6199 -v $PWD/data:/AstrBot/data -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name astrbot soulter/astrbot:latest

🎉 大功告成

如果一切顺利，你会看到 AstrBot 打印出的日志。

如果没有报错，你会看到一条日志显示类似 🌈 管理面板已启动，可访问并附带了几条链接。打开其中一个链接即可访问 AstrBot 管理面板。

第二步：部署 NapCat，登录 QQ

如果你用的是方式一的如果您想对接 NapCat，使用这种方式可以同时部署 AstrBot 和 NapCat NapCat 已经随着 AstrBot 一起部署好了，直接看 NapCat 的日志：

如果你是单独部署 NapCat，跑这个命令：

docker run -d \
  -e NAPCAT_GID=$(id -g) \
  -e NAPCAT_UID=$(id -u) \
  -p 3000:3000 \
  -p 3001:3001 \
  -p 6099:6099 \
  --name napcat \
  --restart=always \
  mlikiowa/napcat-docker:latest

几个关键端口说明一下：

6185：WebUI 管理面板，浏览器访问用这个

6199：OneBot/aiocqhttp 协议端口，NapCat 接进来用这个

11451：微信回调端口，只接 QQ 的话用不到

部署完查看日志确认状态：

sudo docker logs -f astrbot

然后同样 docker logs napcat 拿 Token

第三步：连接 NapCat 和 AstrBot

在 NapCat WebUI 配置 WebSocket 客户端

进入 NapCat 管理面板 → 网络配置 → 新建 → 选 WebSocket 客户端
URL 填：ws://宿主机IP:6199/ws（注意末尾要有 /ws，少了这个连不上）
消息格式：Array
心跳间隔：5000
重连间隔：5000
Token：随便设一个强密码，后面 AstrBot 那边要填一样的
保存

在 AstrBot WebUI 开启 aiocqhttp 适配器

进入 AstrBot 管理面板 → 消息平台 → 新增适配器
选择「接入 QQ 个人号（aiocqhttp）」
反向 WebSocket 主机地址填：0.0.0.0
端口：6199
Token：填和 NapCat 一样的那个密码
保存，然后重启 AstrBot 容器

🎉 大功告成

弓手的个人博客

[弓手] 纸飞机 Rot搭建

准备工作

第一步：部署 AstrBot

Docker Compose（推荐）

首先，需要 Clone AstrBot 仓库到本地：

带 Agent沙盒环境的部署

第二步：创造一个新Bot

第三步：配置AstrBot

[弓手] QQ 个人Rot搭建

准备工作

第一步：部署 AstrBot

Docker Compose（推荐）

首先，需要 Clone AstrBot 仓库到本地：

如果您想对接 NapCat，使用这种方式可以同时部署 AstrBot 和 NapCat

通过 Docker 部署

第二步：部署 NapCat，登录 QQ

第三步：连接 NapCat 和 AstrBot

在 NapCat WebUI 配置 WebSocket 客户端

在 AstrBot WebUI 开启 aiocqhttp 适配器