From 999d7e11f78a9e8aee9f6c56af865e9f05b097b7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=B3=AF=E7=B1=B3=E8=8C=A8?= <143102889+nuomicici@users.noreply.github.com> Date: Fri, 26 Dec 2025 16:49:40 +0800 Subject: [PATCH 1/3] Update faq.md --- zh/faq.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/zh/faq.md b/zh/faq.md index 31245df..89d77d6 100644 --- a/zh/faq.md +++ b/zh/faq.md @@ -1,5 +1,23 @@ # FAQ - +## 安装相关 +### Windows安装失败 +Windows出现venv安装失败、启动失败，请优先尝试[手动uv部署](https://docs.astrbot.app/deploy/astrbot/cli.html#%E5%AE%89%E8%A3%85%E4%BE%9D%E8%B5%96%E5%B9%B6%E8%BF%90%E8%A1%8C)。如果无法解决，请进群提供报错截图！ +### Linux安装失败 +可能是因为python版本不兼容。Astrbot兼容python3.10~3.13版本，如果需要排查，请自行搜索（或者问AI，豆包、deepseek都可以） +### 都不能解决的话，可以进群问 + +## NapCat连接相关 +### 我明明按照文档的步骤做了，为什么NapCat连不上Astrbot？ +1. 如果你两个**全都**是使用docker部署，请尝试在终端运行： +``` +sudo docker network create newnet # 创建新网络 +sudo docker network connect newnet astrbot +sudo docker network connect newnet napcat # 让两个容器连到一起 +sudo docker restart astrbot +sudo docker restart napcat # 重启容器 +``` +运行无报错则回到NapCat的Webui，网络配置中，将你之前填写的`ws://127.0.0.1:6099/ws`修改为`ws://astrbot:6099/ws` +2. 如果只有NapCat是docker部署，那么请将`ws://127.0.0.1:6099/ws`修改为`ws://宿主机IP:6099/ws`（宿主机IP请自行搜索如何查看） ## 管理面板相关 ### 当管理面板打开时遇到 404 错误 From 573e5d671e66cf8606d396b34b7db8b6783ca2be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=B3=AF=E7=B1=B3=E8=8C=A8?= <143102889+nuomicici@users.noreply.github.com> Date: Fri, 26 Dec 2025 16:53:39 +0800 Subject: [PATCH 2/3] Update faq.md --- zh/faq.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/zh/faq.md b/zh/faq.md index 89d77d6..2e99830 100644 --- a/zh/faq.md +++ b/zh/faq.md @@ -1,10 +1,9 @@ # FAQ ## 安装相关 ### Windows安装失败 -Windows出现venv安装失败、启动失败，请优先尝试[手动uv部署](https://docs.astrbot.app/deploy/astrbot/cli.html#%E5%AE%89%E8%A3%85%E4%BE%9D%E8%B5%96%E5%B9%B6%E8%BF%90%E8%A1%8C)。如果无法解决，请进群提供报错截图！ +Windows出现venv安装失败、启动失败，请优先尝试[手动uv部署](https://docs.astrbot.app/deploy/astrbot/cli.html#%E5%AE%89%E8%A3%85%E4%BE%9D%E8%B5%96%E5%B9%B6%E8%BF%90%E8%A1%8C)。 ### Linux安装失败 可能是因为python版本不兼容。Astrbot兼容python3.10~3.13版本，如果需要排查，请自行搜索（或者问AI，豆包、deepseek都可以） -### 都不能解决的话，可以进群问 ## NapCat连接相关 ### 我明明按照文档的步骤做了，为什么NapCat连不上Astrbot？ @@ -16,8 +15,10 @@ sudo docker network connect newnet napcat # 让两个容器连到一起 sudo docker restart astrbot sudo docker restart napcat # 重启容器 ``` -运行无报错则回到NapCat的Webui，网络配置中，将你之前填写的`ws://127.0.0.1:6099/ws`修改为`ws://astrbot:6099/ws` -2. 如果只有NapCat是docker部署，那么请将`ws://127.0.0.1:6099/ws`修改为`ws://宿主机IP:6099/ws`（宿主机IP请自行搜索如何查看） +运行无报错则回到NapCat的Webui，网络配置中，将你之前填写的`ws://127.0.0.1:6199/ws`修改为`ws://astrbot:6199/ws` + +2. 如果只有NapCat是docker部署，请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://宿主机IP:6199/ws`（宿主机IP请自行搜索如何查看） +3. 如果都不是docker部署，则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6099/ws`修改为`ws://localhost:6199/ws`或`ws://127.0.0.1:6199/ws` ## 管理面板相关 ### 当管理面板打开时遇到 404 错误 From 2146c62803a17a4dbdd1daeebd5cd5f7bb8e48f8 Mon Sep 17 00:00:00 2001 From: Soulter <37870767+Soulter@users.noreply.github.com> Date: Tue, 6 Jan 2026 12:47:08 +0800 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com> --- zh/faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/faq.md b/zh/faq.md index 2e99830..4309689 100644 --- a/zh/faq.md +++ b/zh/faq.md @@ -18,7 +18,7 @@ sudo docker restart napcat # 重启容器 运行无报错则回到NapCat的Webui，网络配置中，将你之前填写的`ws://127.0.0.1:6199/ws`修改为`ws://astrbot:6199/ws` 2. 如果只有NapCat是docker部署，请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://宿主机IP:6199/ws`（宿主机IP请自行搜索如何查看） -3. 如果都不是docker部署，则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6099/ws`修改为`ws://localhost:6199/ws`或`ws://127.0.0.1:6199/ws` +3. 如果都不是docker部署，则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://localhost:6199/ws`或`ws://127.0.0.1:6199/ws` ## 管理面板相关 ### 当管理面板打开时遇到 404 错误