AstrBot 部署完整教學 | AstrBot Deployment Guide

🤖 AstrBot 係咩嚟㗎？

🤖 AstrBot 是什么？

🤖 What is AstrBot?

AstrBot 係一個完全免費、開源嘅 AI 聊天機械人平台。你可以將佢想像成一個「AI 機械人中樞」——佢負責喺背後幫你接住唔同嘅即時通訊 App（例如 QQ、微信、Telegram），然後駁去 AI 模型（例如 ChatGPT、DeepSeek），令你可以喺自己用開嘅通訊 App 入面直接同 AI 對話。

AstrBot 是一个完全免费、开源的 AI 聊天机器人平台。你可以把它想象成一个「AI 机器人中樞」——它负责在背后帮你连接不同的即时通讯 App（比如 QQ、微信、Telegram），然后接通 AI 模型（比如 ChatGPT、DeepSeek），让你可以在自己常用的通讯 App 里直接跟 AI 对话。

AstrBot is a completely free, open-source AI chatbot platform. Think of it as an "AI bot hub" — it connects your favorite messaging apps (QQ, WeChat, Telegram, etc.) to AI models (ChatGPT, DeepSeek, etc.), so you can chat with AI directly inside the apps you already use.

用白話講：裝完 AstrBot 之後，你嘅 QQ / Telegram / 微信就會多咗一個識傾偈嘅 AI 機械人 friend，你可以問佢問題、叫佢幫手做嘢、甚至同佢玩遊戲（經由插件）。

用大白话讲：装完 AstrBot 之后，你的 QQ / Telegram / 微信就会多了一个会聊天的 AI 机器人朋友，你可以问它问题、叫它帮忙做事、甚至跟它玩游戏（通过插件）。

In plain English: After installing AstrBot, your QQ / Telegram / WeChat will have a smart AI bot buddy that can answer questions, help with tasks, and even play games with you (via plugins).

💡 關鍵概念：AstrBot 本身唔係 AI 模型，佢係一個橋樑。佢連接「用戶 ↔ 通訊平台 ↔ AI 模型」。你需要另外準備一個 AI 模型嘅 API Key（後面會詳細講）。

💡 关键概念：AstrBot 本身不是 AI 模型，它是一个桥梁。它连接「用户 ↔ 通讯平台 ↔ AI 模型」。你需要另外准备一个 AI 模型的 API Key（后面会详细讲）。

💡 Key concept: AstrBot itself is not an AI model — it's a bridge. It connects "User ↔ Messaging Platform ↔ AI Model". You'll need an API Key from an AI model provider (covered in detail later).

📋 事前準備（新手必讀）

📋 事前准备（新手必读）

📋 Prerequisites (Must-Read for Beginners)

唔需要驚！部署 AstrBot 唔需要識寫 Code。你只需要一部電腦（Windows / Mac / Linux 都得），同埋跟住以下步驟做就得。

不用怕！部署 AstrBot 不需要会写代码。你只需要一部电脑（Windows / Mac / Linux 都可以），然后跟着以下步骤做就行。

Don't worry! You don't need to know how to code. You just need a computer (Windows / Mac / Linux), and follow the steps below.

1️⃣ 需要準備嘅嘢

1️⃣ 需要准备的东西

1️⃣ What You Need

項目	项目	Item	說明	说明	Description
🖥️ 一部電腦	🖥️ 一部电脑	🖥️ A Computer	Windows / Mac / Linux 都得。最好係一直開住嘅電腦（或者雲伺服器）。	Windows / Mac / Linux 都可以。最好是 24 小时开着的电脑（或者云服务器）。	Windows / Mac / Linux all work. Ideally a computer that stays on (or a cloud server).
🔑 AI 模型 API Key	🔑 AI 模型 API Key	🔑 AI Model API Key	令機械人變聰明嘅「燃料」。可以用 DeepSeek（平靚正）、OpenAI、或者免費嘅 SiliconFlow。	让机器人变聪明的「燃料」。可以用 DeepSeek（便宜好用）、OpenAI、或者免费的 SiliconFlow。	The "fuel" that makes your bot smart. Use DeepSeek (cheap & good), OpenAI, or free SiliconFlow.
📱 通訊 App 帳號	📱 通讯 App 帐号	📱 Messaging App Account	你想喺邊個 App 用機械人？QQ、微信、Telegram、Discord 都得。	你想在哪个 App 用机器人？QQ、微信、Telegram、Discord 都行。	Which app do you want the bot on? QQ, WeChat, Telegram, Discord — all supported.

2️⃣ 咩係「uv」？（新手解釋）

2️⃣ 什么是「uv」？（新手解释）

2️⃣ What is "uv"? (Beginner Explanation)

uv 係一個工具安裝器，你可以將佢理解成手機上面嘅「App Store」。AstrBot 係用 Python 寫嘅，所以需要 uv 幫手一鍵安裝。你唔需要學 Python，只需要裝咗 uv 就得。

uv 是一个工具安装器，你可以把它理解成手机上的「应用商店」。AstrBot 是用 Python 写的，所以需要 uv 帮忙一键安装。你不需要学 Python，只需要装了 uv 就行。

uv is a tool installer — think of it like an "App Store" for developer tools. AstrBot is written in Python, so uv handles the one-click install. You don't need to learn Python — just install uv.

🖥️ 點安裝 uv？
👉 Windows：打開「PowerShell」（在開始菜單搜尋 PowerShell），貼上以下指令然後按 Enter：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

👉 Mac / Linux：打開「終端機」(Terminal)，貼上以下指令然後按 Enter：
curl -LsSf https://astral.sh/uv/install.sh | sh

裝完之後，關閉再重新打開 PowerShell / Terminal，然後輸入 uv --version，如果見到版本號碼就代表成功！

🖥️ 怎么安装 uv？
👉 Windows：打开「PowerShell」（在开始菜单搜索 PowerShell），粘贴以下指令然后按 Enter：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

👉 Mac / Linux：打开「终端」(Terminal)，粘贴以下指令然后按 Enter：
curl -LsSf https://astral.sh/uv/install.sh | sh

装完之后，关闭再重新打开 PowerShell / Terminal，然后输入 uv --version，如果看到版本号就代表成功！

🖥️ How to install uv?
👉 Windows: Open "PowerShell" (search in Start menu), paste this and press Enter:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

👉 Mac / Linux: Open "Terminal", paste this and press Enter:
curl -LsSf https://astral.sh/uv/install.sh | sh

After install, close and reopen PowerShell/Terminal, then run uv --version. If you see a version number, you're good!

3️⃣ 咩係「Docker」？（可跳過）

3️⃣ 什么是「Docker」？（可跳过）

3️⃣ What is "Docker"? (Optional)

Docker 係一個「容器」工具，可以將成個 App 連同佢需要嘅環境打包成一個箱仔，去邊度都 run 到。好處係穩定，但新手可以直接用方法一（uv），更簡單。

Docker 是一个「容器」工具，可以将整个 App 连同它需要的环境打包成一个小箱子。好处是稳定，但新手可以直接用方法一（uv），更简单。

Docker is a "container" tool that packages the entire app. It's stable, but beginners can just use Method 1 (uv) — it's simpler.

⚡ 方法一：uv 一鍵部署（新手推薦！）

⚡ 方法一：uv 一键部署（新手推荐！）

⚡ Method 1: uv One-Click Deploy (Recommended!)

呢個係最簡單嘅方法。只要三步，全程自動化。以下每一步都有詳細解釋，你跟住做就得。

这是最简单的方法。只需三步，全程自动化。以下每一步都有详细解释，你跟着做就行。

This is the easiest method. Just three steps, fully automated. Follow each step below.

🟢 第一步：安裝 AstrBot

🟢 第一步：安装 AstrBot

🟢 Step 1: Install AstrBot

打開 Terminal（Mac/Linux）或者 PowerShell（Windows），輸入以下指令然後撳 Enter：

打开 Terminal（Mac/Linux）或者 PowerShell（Windows），输入以下指令然后按 Enter：

Open Terminal (Mac/Linux) or PowerShell (Windows), paste this and press Enter:

uv tool install astrbot --python 3.12

呢個指令做緊咩？佢會自動下載 Python 3.12（如果未裝），然後安裝最新版本嘅 AstrBot。全程自動，唔需要人手 download 任何嘢。視乎網速，大概需要 1-3 分鐘。

这个指令在干嘛？它会自动下载 Python 3.12（如果没装），然后安装最新版本的 AstrBot。全自动，不需要人手下载任何东西。视乎网速，大概需要 1-3 分钟。

What does this do? It auto-downloads Python 3.12 (if not installed), then installs the latest AstrBot. Fully automatic — no manual downloads. Takes about 1-3 minutes depending on internet speed.

🟡 第二步：初始化

🟡 Step 2: Initialize

⚠️ 呢步只係第一次安裝先需要做。初始化會幫你建立設定檔、資料夾等必要嘅檔案。

⚠️ 这一步只有第一次安装才需要做。初始化会帮你创建配置文件、文件夹等必要的文件。

⚠️ Only needed on first install. This creates config files, folders, and other necessary files.

astrbot init

如果見到類似 ✅ Initialization complete! 嘅訊息，代表成功。

如果看到类似 ✅ Initialization complete! 的消息，代表成功。

If you see something like ✅ Initialization complete!, you're good.

🟣 第三步：啟動！

🟣 第三步：启动！

🟣 Step 3: Launch!

astrbot run

🎉 恭喜！AstrBot 已經喺你部電腦度 run 緊！你會見到一堆日誌輸出，最後會有一行類似：

🎉 恭喜！AstrBot 已经在你的电脑上跑起来了！你会看到一堆日志输出，最后会有一行类似：

🎉 Congrats! AstrBot is now running on your computer! You'll see log output, ending with something like:

🌈 管理面板已啟動，可訪問 http://localhost:6185

👉 打開你嘅瀏覽器（Chrome / Edge / Safari），喺網址列輸入 http://localhost:6185，你就會見到 AstrBot 嘅管理後台！

👉 打开你的浏览器（Chrome / Edge / Safari），在地址栏输入 http://localhost:6185，你就会看到 AstrBot 的管理后台！

👉 Open your browser (Chrome / Edge / Safari) and go to http://localhost:6185 — you'll see the AstrBot dashboard!

🍎 macOS 用戶注意：第一次執行 astrbot 可能需時 10-20 秒，因為 macOS 要做安全檢查。如果彈出「無法驗證開發者」嘅警告，去「系統設定 → 私隱與安全性」允許執行就得。

🍎 macOS 用户注意：第一次执行 astrbot 可能需要 10-20 秒，因为 macOS 要进行安全检查。如果弹出「无法验证开发者」的警告，去「系统设置 → 隐私与安全性」允许执行即可。

🍎 macOS users: The first astrbot run may take 10-20s for security checks. If you see a "cannot verify developer" warning, go to "System Settings → Privacy & Security" and allow it.

🔄 日後點更新？

🔄 日后怎么更新？

🔄 How to Update Later?

當有新版本推出，只需要行以下指令：

当有新版本推出，只需运行以下指令：

When a new version is released, just run:

uv tool upgrade astrbot --python 3.12

⚠️ 重要提醒：AstrBot 嘅 WebUI 唔支援直接升級，一定要返去 Terminal / PowerShell 打上面嗰行指令先可以更新！

⚠️ 重要提醒：AstrBot 的 WebUI 不支持直接升级，必须回到 Terminal / PowerShell 输入上面那行指令才能更新！

⚠️ Important: AstrBot's WebUI does NOT support upgrading. You must go back to Terminal/PowerShell and run the command above to update!

🐳 方法二：Docker 部署（進階用戶）

🐳 方法二：Docker 部署（进阶用户）

🐳 Method 2: Docker Deploy (Advanced)

如果你需要更穩定嘅部署方案、或者想將 AstrBot 放喺 NAS / 雲伺服器上面 24 小時運行，Docker 係一個好選擇。

如果你需要更稳定的部署方案、或者想把 AstrBot 放在 NAS / 云服务器上 24 小时运行，Docker 是一个好选择。

For a more stable setup, or if you want AstrBot running 24/7 on a NAS or cloud server, Docker is the way to go.

🐳 新手提示：如果未裝 Docker，先去 Docker 官網下載安裝。Windows 用戶裝 Docker Desktop 就得，好簡單。

🐳 新手提示：如果没装 Docker，先去 Docker 官网下载安装。Windows 用户装 Docker Desktop 就行，很简单。

🐳 Beginner tip: If you haven't installed Docker, go to Docker's website. Windows users just need Docker Desktop.

# 1. 下載 AstrBot 原始碼下载 AstrBot 源代码Download AstrBot source code
git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot

# 2. 用 Docker Compose 啟動用 Docker Compose 启动Start with Docker Compose
sudo docker compose up -d

🇨🇳 大陸用戶：如果拉取鏡像失敗，可以用 DaoCloud 鏡像：

🇨🇳 大陆用户：如果拉取镜像失败，可以用 DaoCloud 镜像：

🇨🇳 Users in China: If you can't pull images, use the DaoCloud mirror:

sudo docker run -itd -p 6185:6185 -p 6199:6199 \
  -v $PWD/data:/AstrBot/data \
  --name astrbot \
  m.daocloud.io/docker.io/soulter/astrbot:latest

之後用 sudo docker logs -f astrbot 睇日誌，見到 🌈 管理面板已啟動 代表成功。

之后用 sudo docker logs -f astrbot 看日志，看到 🌈 管理面板已启动 代表成功。

Then check logs with sudo docker logs -f astrbot. When you see 🌈 Dashboard started, you're done.

🎉 部署完成後 — 第一步設定

🎉 部署完成后 — 第一步设置

🎉 After Deployment — First Setup

打開 http://localhost:6185（如果係雲伺服器就用你嘅 IP，例如 http://123.456.789.0:6185）之後，你會見到登入畫面：

打开 http://localhost:6185（如果是云服务器就用你的 IP，例如 http://123.456.789.0:6185）之后，你会看到登录画面：

Go to http://localhost:6185 (or http://your-server-ip:6185 for cloud servers). You'll see the login page:

👤 用戶名：astrbot
👤 用户名：astrbot
👤 Username: astrbot
🔑 密碼：喺 Terminal / PowerShell 嘅日誌入面會見到一行隨機密碼。例如：password: aB3xK9mW
🔑 密码：在 Terminal / PowerShell 的日志里会看到一行随机密码。比如：password: aB3xK9mW
🔑 Password: Check your Terminal/PowerShell logs for a random password line, e.g. password: aB3xK9mW

🔐 安全第一！登入之後即刻去設定頁面改密碼！唔好 keep 住個隨機密碼。

🔐 安全第一！登录之后立刻去设置页面改密码！不要保留随机密码。

🔐 Security first! Change your password immediately after logging in. Don't keep the random one.

🔥 雲伺服器注意：記得喺伺服器嘅防火牆（安全組）放行 6185（WebUI 管理面板）同 6199（Web Chat）呢兩個端口，否則出面訪問唔到。

🔥 云服务器注意：记得在服务器的防火墙（安全组）放行 6185（WebUI 管理面板）和 6199（Web Chat）这两个端口，否则外面访问不到。

🔥 Cloud server note: Make sure to open ports 6185 (WebUI dashboard) and 6199 (Web Chat) in your firewall/security group.

🔌 接入消息平台（喺 App 度用機械人）

🔌 接入消息平台（在 App 里用机器人）

🔌 Connect Messaging Platforms (Use Bot in Apps)

搞掂 AI 模型之後，就要設定「喺邊度用」個機械人。AstrBot 支援超多平台，以下係最常用嘅幾個：

搞定 AI 模型之后，就要设置「在哪里用」这个机器人。AstrBot 支持超多平台，以下是最常用的几个：

After setting up the AI model, you need to configure where to use the bot. AstrBot supports many platforms:

平台	平台	Platform	難度	难度	Difficulty	支援方式	支持方式
QQ	🟢 簡單	🟢 Easy	官方機器人 / WebSocket / OneBot v11	官方机器人 / WebSocket / OneBot v11	Official Bot / WebSocket / OneBot v11
Telegram	🟢 最簡單	🟢 Easiest	Bot API（@BotFather 創建就得）		Bot API (create via @BotFather)
Discord	🟢 簡單	🟢 Easy	Bot API（Developer Portal 創建）		Bot API (create via Developer Portal)
企業微信	企业微信	WeCom	🟡 中等	🟡 Medium	應用 / 智能機器人	应用 / 智能机器人	App / AI Bot
微信公眾號	微信公众号	WeChat OA	🟡 中等	🟡 Medium	官方接入（需要認證公眾號）	官方接入（需要认证公众号）	Official API (requires verified account)
飛書 / 釘釘	飞书 / 钉钉	Feishu / DingTalk	🟡 中等	🟡 Medium	官方應用	官方应用	Official App
Slack / LINE / KOOK	🔴 進階	🔴 Advanced	官方接入	官方接入	Official Integration

🚀 新手最推薦：Telegram
1️⃣ 喺 Telegram 搜尋 @BotFather
2️⃣ 發送 /newbot 指令
3️⃣ 跟住指示改個名 → 佢會俾一個 Token 你（一串字）
4️⃣ 將個 Token 貼入 AstrBot WebUI 嘅對應欄位 → 搞掂！

🚀 新手最推荐：Telegram
1️⃣ 在 Telegram 搜索 @BotFather
2️⃣ 发送 /newbot 指令
3️⃣ 跟着指示起个名字 → 它会给你一个 Token（一串字）
4️⃣ 把 Token 粘贴到 AstrBot WebUI 的对应栏位 → 搞定！

🚀 Best for Beginners: Telegram
1️⃣ Search @BotFather on Telegram
2️⃣ Send /newbot
3️⃣ Follow the prompts → you'll get a Token
4️⃣ Paste the Token into AstrBot WebUI → done!

🧠 接入 AI 模型（令機械人變聰明！）

🧠 接入 AI 模型（让机器人变聪明！）

🧠 Connect AI Models (Make Your Bot Smart!)

呢個係最重要嘅一步！冇 AI 模型，你嘅機械人就只係一個空殼。你需要一個「API Key」—— 你可以將佢理解成「AI 模型嘅入場券」。

这是最重要的一步！没有 AI 模型，你的机器人就只是一个空壳。你需要一个「API Key」—— 你可以把它理解成「AI 模型的入场券」。

This is the most important step! Without an AI model, your bot is just an empty shell. You need an "API Key" — think of it as your "ticket" to the AI model.

💰 推薦嘅 AI 模型服務（由平到貴）

💰 推荐的 AI 模型服务（由便宜到贵）

💰 Recommended AI Model Services (Cheapest to Priciest)

服務商	服务商	Provider	價錢	价格	Price	點申請	怎么申请	How to Apply
DeepSeek ⭐推薦	DeepSeek ⭐推荐	DeepSeek ⭐Top Pick	💰 超平，¥1 用勁耐	💰 超便宜，¥1 用很久	💰 Dirt cheap	platform.deepseek.com → 註冊 → API Keys → 建立新 Key → 複製	platform.deepseek.com → 注册 → API Keys → 创建新 Key → 复制	platform.deepseek.com → Sign up → API Keys → Create → Copy
硅基流動（SiliconFlow）	硅基流动（SiliconFlow）	SiliconFlow	🆓 有免費額度	🆓 有免费额度	🆓 Free tier available	siliconflow.cn → 註冊 → API 密鑰 → 建立 → 複製	siliconflow.cn → 注册 → API 密钥 → 创建 → 复制	siliconflow.cn → Sign up → API Keys → Create → Copy
OpenAI（ChatGPT）	OpenAI（ChatGPT）	OpenAI (ChatGPT)	💰💰 中等	💰💰 中等	💰💰 Moderate	platform.openai.com → 註冊 → API Keys → 建立 → 複製	platform.openai.com → 注册 → API Keys → 创建 → 复制	platform.openai.com → Sign up → API Keys → Create → Copy

💡 新手建議：先用 硅基流動（免費）或者 DeepSeek（平靚正）試玩。DeepSeek 嘅 API Key 申請只需 1 分鐘：註冊 → 按「API Keys」→ 按「創建」→ 複製嗰串字。夠簡單！

💡 新手建议：先用 硅基流动（免费）或者 DeepSeek（便宜好用）试玩。DeepSeek 的 API Key 申请只需 1 分钟：注册 → 点「API Keys」→ 点「创建」→ 复制那串字。超简单！

💡 Beginner tip: Start with SiliconFlow (free) or DeepSeek (cheap & great). Getting a DeepSeek API Key takes 1 minute: sign up → click "API Keys" → "Create" → copy the string. Easy!

🔧 喺 AstrBot 入面設定 AI 模型

🔧 在 AstrBot 里面设置 AI 模型

🔧 Setting Up the AI Model in AstrBot

攞到 API Key 之後，跟住以下步驟喺 AstrBot 嘅 WebUI 入面設定：

拿到 API Key 之后，跟着以下步骤在 AstrBot 的 WebUI 里面设置：

Once you have your API Key, follow these steps in AstrBot's WebUI:

喺左邊 menu 撳 「AI 配置」
在左边菜单点 「AI 配置」
Click "AI Config" in the left menu
撳 「新增模型服務」
点 「新增模型服务」
Click "Add Model Service"
選擇服務商（例如 OpenAI 兼容、DeepSeek），填好 API Key 同 Base URL
选择服务商（例如 OpenAI 兼容、DeepSeek），填好 API Key 和 Base URL
Choose your provider (e.g. OpenAI compatible, DeepSeek), fill in your API Key and Base URL
撳 「保存」 → 揀你想用嘅模型 → 搞掂！
点 「保存」 → 选你想用的模型 → 搞定！
Click "Save" → pick your model → done!

📝 常用 Base URL（照抄就得）：
👉 DeepSeek：https://api.deepseek.com/v1
👉 SiliconFlow：https://api.siliconflow.cn/v1
👉 OpenAI：https://api.openai.com/v1
👉 Ollama（本地）：http://localhost:11434/v1

📝 常用 Base URL（照抄就行）：
👉 DeepSeek：https://api.deepseek.com/v1
👉 SiliconFlow：https://api.siliconflow.cn/v1
👉 OpenAI：https://api.openai.com/v1
👉 Ollama（本地）：http://localhost:11434/v1

📝 Common Base URLs (copy-paste):
👉 DeepSeek: https://api.deepseek.com/v1
👉 SiliconFlow: https://api.siliconflow.cn/v1
👉 OpenAI: https://api.openai.com/v1
👉 Ollama (local): http://localhost:11434/v1

❓ 常見問題（FAQ）

❓ 常见问题（FAQ）

❓ Frequently Asked Questions

Q: 我完全唔識 Code，真係搞得掂？

Q: 我完全不会写代码，真的能搞定吗？

Q: I don't know how to code at all. Can I really do this?

A: 得！呢篇教學就係為咗完全唔識 coding 嘅人而寫。成個過程你只需要做三件事：① 開 Terminal / PowerShell 貼指令 ② 申請一個 API Key ③ 喺網頁填資料。全程唔需要寫任何 code。

A: 能！这篇教程就是为完全不会编程的人写的。整个过程你只需要做三件事：① 开 Terminal / PowerShell 粘贴指令 ② 申请一个 API Key ③ 在网页填资料。全程不需要写任何代码。

A: Yes! This guide is written for non-coders. The entire process is just: ① Open Terminal/PowerShell and paste commands ② Apply for an API Key ③ Fill in a web form. Zero coding required.

Q: 使唔使錢㗎？

Q: 需要花钱吗？

Q: Does it cost money?

A: AstrBot 本身完全免費。你需要俾錢嘅只係 AI 模型嘅 API 費用。如果用 SiliconFlow 嘅免費額度或者 DeepSeek（¥1 可以玩好耐），基本上等於免費。

A: AstrBot 本身完全免费。你需要花钱的只是 AI 模型的 API 费用。如果用 SiliconFlow 的免费额度或者 DeepSeek（¥1 可以玩很久），基本等于免费。

A: AstrBot is 100% free. The only cost is the AI model API. Using SiliconFlow's free tier or DeepSeek ($0.14 can last a long time) makes it essentially free.

Q: 熄咗電腦仲用到機械人嗎？

Q: 关了电脑还能用机器人吗？

Q: Can I still use the bot if I turn off my computer?

A: 唔可以。AstrBot 需要喺一部一直開住嘅電腦上面運行。如果你只係想試玩，可以喺自己電腦 run 住先。想 24 小時在線，建議用雲伺服器（例如阿里雲、騰訊雲，最平幾十蚊一個月）。

A: 不可以。AstrBot 需要在一部一直开着的电脑上运行。如果你只是想试玩，可以先在自己电脑上跑着。想 24 小时在线，建议用云服务器（比如阿里云、腾讯云，最便宜几十块一个月）。

A: No. AstrBot needs to run on a computer that stays on. For testing, your PC is fine. For 24/7 uptime, use a cloud server (Alibaba Cloud, AWS, etc. — as low as $5/month).

Q: 出咗問題搞唔掂點算？

Q: 出了问题搞不定怎么办？

Q: What if I run into problems?

A: 去 GitHub Issues 搜尋你嘅問題，或者加入 AstrBot 官方社群問人。佢哋嘅社群好活躍。

A: 去 GitHub Issues 搜索你的问题，或者加入 AstrBot 官方社区问人。他们的社区很活跃。

A: Search GitHub Issues or join the AstrBot community. They're very active and helpful.

🎯 總結：5 分鐘回顧

🎯 总结：5 分钟回顾

🎯 Recap in 1 Minute

帶你回顧一次成個流程，確保你冇漏任何嘢：

带你回顾一次整个流程，确保你没漏掉任何东西：

Quick recap to make sure you didn't miss anything:

裝 uv → 打開 Terminal / PowerShell，貼指令 → 撳 Enter
装 uv → 打开 Terminal / PowerShell，粘贴指令 → 按 Enter
Install uv → Open Terminal/PowerShell, paste command → Enter
裝 AstrBot → uv tool install astrbot --python 3.12
装 AstrBot → uv tool install astrbot --python 3.12
Install AstrBot → uv tool install astrbot --python 3.12
初始化 → astrbot init
初始化 → astrbot init
Initialize → astrbot init
啟動 → astrbot run
启动 → astrbot run
Launch → astrbot run
打開網頁 → http://localhost:6185，用日誌入面嘅密碼登入
打开网页 → http://localhost:6185，用日志里的密码登录
Open browser → http://localhost:6185, login with the password from logs
設定 AI 模型 → 去 AI 配置 → 填 API Key（推薦 DeepSeek）
设置 AI 模型 → 去 AI 配置 → 填 API Key（推荐 DeepSeek）
Set up AI Model → AI Config → fill in API Key (recommend DeepSeek)
接入平台 → 揀 Telegram / QQ / Discord → 跟住指引填資料
接入平台 → 选 Telegram / QQ / Discord → 跟着指引填资料
Connect Platform → Pick Telegram / QQ / Discord → follow instructions
✅ 搞掂！去你嘅通訊 App 同機械人傾偈啦！
✅ 搞定！去你的通讯 App 跟机器人聊天吧！
✅ Done! Go chat with your bot in your messaging app!

AstrBot 係一個非常強大又易用嘅 AI 聊天機械人框架。無論你想整個人 AI 伴侶、智能客服、定係自動化助手，AstrBot 都可以幫你快速搞掂。部署只需幾分鐘，生態豐富，絕對值得一試！

AstrBot 是一个非常强大又易用的 AI 聊天机器人框架。无论你是想打造个人 AI 伴侣、智能客服、还是自动化助手，AstrBot 都能帮你快速搞定。部署只需几分钟，生态丰富，绝对值得一试！

AstrBot is a powerful yet easy-to-use AI chatbot framework. Whether you're building a personal AI companion, intelligent customer service, or an automation assistant, AstrBot gets you there fast. Deployment takes just minutes with a rich ecosystem — definitely worth a try!

Happy Coding! 🤖✨

🚀 AstrBot 部署完整教學十分鐘打造你嘅 AI 聊天機械人

🚀 AstrBot 部署完整教程十分钟打造你的 AI 聊天机器人

🚀 AstrBot Deployment GuideBuild Your AI Chatbot in 10 Minutes

🤖 AstrBot 係咩嚟㗎？

🤖 AstrBot 是什么？

🤖 What is AstrBot?

📋 事前準備（新手必讀）

📋 事前准备（新手必读）

📋 Prerequisites (Must-Read for Beginners)

1️⃣ 需要準備嘅嘢

1️⃣ 需要准备的东西

1️⃣ What You Need

2️⃣ 咩係「uv」？（新手解釋）

2️⃣ 什么是「uv」？（新手解释）

2️⃣ What is "uv"? (Beginner Explanation)

3️⃣ 咩係「Docker」？（可跳過）

3️⃣ 什么是「Docker」？（可跳过）

3️⃣ What is "Docker"? (Optional)

⚡ 方法一：uv 一鍵部署（新手推薦！）

⚡ 方法一：uv 一键部署（新手推荐！）

⚡ Method 1: uv One-Click Deploy (Recommended!)

🟢 第一步：安裝 AstrBot

🟢 第一步：安装 AstrBot

🟢 Step 1: Install AstrBot

🟡 第二步：初始化

🟡 第二步：初始化

🟡 Step 2: Initialize

🟣 第三步：啟動！

🟣 第三步：启动！

🟣 Step 3: Launch!

🔄 日後點更新？

🔄 日后怎么更新？

🔄 How to Update Later?

🐳 方法二：Docker 部署（進階用戶）

🐳 方法二：Docker 部署（进阶用户）

🐳 Method 2: Docker Deploy (Advanced)

🎉 部署完成後 — 第一步設定

🎉 部署完成后 — 第一步设置

🎉 After Deployment — First Setup

🔌 接入消息平台（喺 App 度用機械人）

🔌 接入消息平台（在 App 里用机器人）

🔌 Connect Messaging Platforms (Use Bot in Apps)

🧠 接入 AI 模型（令機械人變聰明！）

🧠 接入 AI 模型（让机器人变聪明！）

🧠 Connect AI Models (Make Your Bot Smart!)

💰 推薦嘅 AI 模型服務（由平到貴）

💰 推荐的 AI 模型服务（由便宜到贵）

💰 Recommended AI Model Services (Cheapest to Priciest)

🔧 喺 AstrBot 入面設定 AI 模型

🔧 在 AstrBot 里面设置 AI 模型

🔧 Setting Up the AI Model in AstrBot

❓ 常見問題（FAQ）

❓ 常见问题（FAQ）

❓ Frequently Asked Questions

Q: 我完全唔識 Code，真係搞得掂？

Q: 我完全不会写代码，真的能搞定吗？

Q: I don't know how to code at all. Can I really do this?

Q: 使唔使錢㗎？

Q: 需要花钱吗？

Q: Does it cost money?

Q: 熄咗電腦仲用到機械人嗎？

Q: 关了电脑还能用机器人吗？

Q: Can I still use the bot if I turn off my computer?

Q: 出咗問題搞唔掂點算？

Q: 出了问题搞不定怎么办？

Q: What if I run into problems?

🎯 總結：5 分鐘回顧

🎯 总结：5 分钟回顾

🎯 Recap in 1 Minute

🚀 AstrBot 部署完整教學
十分鐘打造你嘅 AI 聊天機械人

🚀 AstrBot 部署完整教程
十分钟打造你的 AI 聊天机器人

🚀 AstrBot Deployment Guide
Build Your AI Chatbot in 10 Minutes