准备工作

• 一台 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 代理 来设置代理。

🎉 大功告成