1. 为什么搭 QQ 机器人总在环境这一步卡住如果你搜过「Docker 部署 AstrBot NapCat DeepSeek QQ 机器人」这类关键词大概率已经看过不少教程但真正动手时还是会被劝退。原因通常不在某一步特别难而是链路太长QQ 登录要处理协议、机器人框架要装 Python 依赖、模型调用要配 Key、容器之间还要能互相通信。任何一环出问题表现都是「机器人不回消息」你根本不知道是 QQ 没登上、OneBot 没连上还是模型 Key 填错了。我自己的经历是最早用源码方式装 AstrBot光 Python 版本和依赖冲突就折腾了一晚上第二天换 Docker 才意识到这套组合真正的价值就是把「环境」这件事交给容器你只需要关心三样东西——NapCat 有没有登上 QQ、AstrBot 有没有连上 NapCat、模型 Key 有没有生效。这三个问题各自都有明确的验证动作跑通一次之后后面换模型、加插件、改人设都只是改配置。这篇要交付的就是这条完整链路用 Docker Compose 把 AstrBot 和 NapCat 一起拉起来NapCat 扫码登录 QQAstrBot 通过 OneBot 协议对接再把 DeepSeek 的模型接进去最后用「容器健康检查 → QQ 收发消息 → 模型回复确认」三步验证。模型通道这块我会用 TaoToken 统一管理 Key 和 API 地址这样以后想换模型不用改一堆地方。适合谁看零基础、想在 Windows 或 Linux 上用 Docker 跑一个能对话的 QQ 机器人、不想天天修环境的人。全程命令可复制配置片段可直接改。先说清楚三个组件各自干什么不然后面配置容易懵。NapCat 是基于 NTQQ 的 OneBot 协议实现通俗讲它负责「登录你的 QQ 并提供标准接口」把 QQ 的收发消息翻译成 HTTP/WebSocket 接口。AstrBot 是 AI 聊天机器人框架负责接大模型、处理逻辑、管插件和人设它通过 OneBot 协议去调用 NapCat。DeepSeek 是模型提供方负责生成回复内容。三者关系是QQ 用户发消息 → NapCat 收到 → 通过 OneBot 转给 AstrBot → AstrBot 调模型 → 回复经 NapCat 发回 QQ。理解了这条数据流排障就有方向了消息没到 AstrBot查 NapCat 和 OneBot 连接AstrBot 收到了但不回复查模型 Key 和网络回复内容不对查人设和上下文。2. 用 TaoToken 统一模型 Key 与 API 通道在讲 Docker 编排之前先把模型接入这块理清楚因为它决定了你后面配置 AstrBot 时填什么。很多人卡在模型这一步是因为每个模型厂商的 Key、Base URL、模型名都不一样换一个模型就要改一次配置时间久了配置散落各处很难维护。我的做法是用 TaoToken 作为统一的模型接入通道。它的作用是给你一个统一的 API 地址和 Key背后可以对接 DeepSeek 等模型。对 AstrBot 来说它只需要知道一个 Base URL、一个 Key、一个 Model ID剩下的路由由 TaoToken 处理。这样你以后想从 DeepSeek 换到别的模型只改 Model ID 就行不用动 Key 和地址。具体要准备三样东西我把它叫「三件套」后面配置 AstrBot 时会反复用到配置项说明示例形态Base URL模型 API 的请求地址https://taotoken.net/apiAPI Key身份凭证形如 sk- 开头sk-xxxxxxxxModel ID具体调用的模型标识deepseek-chat获取方式先访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后进入控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建时给它起个能认出来的名字比如 astrbot-qq方便以后区分。注意API Key 只在创建时完整显示一次复制后先存到安全的地方。如果忘了直接删掉重新建一个即可不用纠结。拿到 Key 之后建议先单独验证一次确认通道是通的再去配 AstrBot。这样能把「模型通道问题」和「机器人配置问题」分开排障时省一半时间。验证可以用模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 直接发一句话测试也可以后面用 curl 验证。如果你打算长期跑编码类或 Agent 类任务可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 不过 QQ 机器人这种对话场景按量用 API 就够了。这里要强调一点TaoToken 是模型接入通道不是替代 AstrBot 或 NapCat 的。NapCat 依然负责 QQ 登录AstrBot 依然负责机器人逻辑TaoToken 只解决「模型怎么调」这一层。三者职责别混配置时就不会乱。3. 可复制的 Docker Compose 配置这一节是核心给你一份可以直接改的 docker-compose 配置把 AstrBot 和 NapCat 一起编排起来。我不用一键脚本因为脚本出问题时你不知道它改了什么用 compose 文件每一步都看得见改起来也清楚。先建目录把配置放进去mkdir -p ~/qq-bot cd ~/qq-bot然后创建docker-compose.yml内容如下。注意端口映射和 volumes 路径这两个是最容易出错的地方services: napcat: image: mlikiowa/napcat-docker:latest container_name: napcat restart: unless-stopped environment: - NAPCAT_UID1000 - NAPCAT_GID1000 ports: - 6099:6099 # NapCat WebUI 登录端口 - 3000:3000 # OneBot HTTP 接口 - 3001:3001 # OneBot WebSocket 接口 volumes: - ./napcat/config:/app/napcat/config - ./napcat/qq:/app/.config/QQ networks: - botnet astrbot: image: soulter/astrbot:latest container_name: astrbot restart: unless-stopped ports: - 6185:6185 # AstrBot WebUI 端口 volumes: - ./astrbot/data:/AstrBot/data environment: - TZAsia/Shanghai depends_on: - napcat networks: - botnet networks: botnet: driver: bridge几个关键点解释一下。restart: unless-stopped保证容器异常退出后自动拉起机器人这种长期跑的服务必须加。networks让两个容器在同一网络里AstrBot 可以直接用服务名napcat访问 NapCat不用管 IP。端口方面6099 是 NapCat 的 WebUI你扫码登录 QQ 用它3000/3001 是 OneBot 接口AstrBot 连它用6185 是 AstrBot 后台。启动docker compose up -d启动后先做容器健康检查这是三步验证的第一步docker compose ps正常的话两个容器状态都是Up。如果某个是Restarting或Exited看日志docker compose logs -f napcat docker compose logs -f astrbotNapCat 首次启动会初始化 QQ 环境日志里出现监听 6099 端口就算就绪。AstrBot 日志里出现 WebUI 启动信息即可。这一步过了说明容器编排没问题再往下走。提示如果你在 Linux 上跑注意 volumes 目录权限。NapCat 容器内以 UID 1000 运行宿主机目录如果权限不对会写不进去表现为登录后配置不保存。可以chown -R 1000:1000 ./napcat处理。4. 验证请求与成功结果容器起来后按三步验证走每步都有明确的成功标志不要跳步。第一步容器健康检查。上面docker compose ps两个 Up 就算过。再补一个端口检查curl -I http://localhost:6099 curl -I http://localhost:6185能返回 HTTP 响应头就说明服务在监听。第二步QQ 收发消息。浏览器打开http://localhost:6099进入 NapCat WebUI。首次登录需要 TokenToken 在容器日志里docker compose logs napcat | grep -i token复制 Token 填进页面然后选「扫码登录」用手机 QQ 扫码。登录成功后NapCat 就接管了这个 QQ 账号。此时用另一个 QQ 号给机器人账号发一条消息在 NapCat 的日志或消息列表里能看到这条消息说明 QQ 收发链路通了。第三步模型回复确认。回到 AstrBot 后台http://localhost:6185默认账号密码都是astrbot首次登录会要求改密码。登录后做两件事一是创建机器人消息平台选 QQ 个人号OneBot启用二是配置模型提供商把前面准备的「三件套」填进去。AstrBot 连 NapCat 的配置如果用 WebUI 填关键参数是{ platform: qq_official_or_onebot, onebot_ws_url: ws://napcat:3001, onebot_http_url: http://napcat:3000 }注意这里用的是容器服务名napcat不是 localhost因为 AstrBot 在容器里localhost 指向它自己。这是新手最容易踩的坑之一。模型提供商配置选 OpenAI 兼容类型填{ api_base: https://taotoken.net/api, api_key: sk-你的Key, model: deepseek-chat }保存后点「测试」返回成功即通道可用。然后用另一个 QQ 号给机器人发「你好」如果收到模型生成的回复三步验证全部通过。到这一步你的 QQ 机器人已经能对话了。如果模型测试通过但 QQ 不回复问题在 OneBot 连接如果 QQ 能收到消息但没回复问题在模型配置。按这个二分法定位很快能找到。5. 本篇常见报错排查这一节按真实报错来都是这套组合里高频出现的。401 Unauthorized。出现在模型测试或对话时。原因基本是 API Key 错了、过期或者 Base URL 填错。检查api_base是不是https://taotoken.net/apiKey 有没有多余空格。如果 Key 是在别处复制的重新在 API Keys 页面建一个再试。local proxy failed / connection refused。AstrBot 连不上 NapCat。先确认 NapCat 容器在跑再确认 AstrBot 里填的是ws://napcat:3001而不是ws://localhost:3001。如果两个容器不在同一 network服务名解析不了检查 compose 里的 networks 配置是否两边都加了botnet。reading choices 相关报错。这是模型返回结构解析失败通常发生在 Base URL 指向了非 OpenAI 兼容接口或者 Model ID 写错。确认 Model ID 是deepseek-chat这类有效值Base URL 用 TaoToken 的地址。如果换了模型Model ID 要同步改。OAuth / 登录失败。NapCat 扫码登录时报错多半是 QQ 版本或容器环境问题。先看 NapCat 日志具体报什么常见的是需要更新镜像docker compose pull napcat docker compose up -d。另外扫码用的手机 QQ 和机器人账号别是同一个否则会顶号。容器反复重启。看日志定位。NapCat 常见是 volumes 权限问题AstrBot 常见是 data 目录被占用或损坏。权限问题按前面说的chown处理data 损坏可以备份后清空./astrbot/data重新初始化。消息能收到但不回复且模型测试正常。检查 AstrBot 里机器人是否启用、是否绑定了正确的模型提供商。有时候创建了机器人但没启用或者模型提供商没设为默认都会导致不回复。排障时记住一个原则先看日志再改配置。docker compose logs -f 服务名是最高频的命令90% 的问题日志里直接写了原因。如果你在接入文档里找不到对应说明可以查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Base URL、Key、Model ID 的完整说明。6. 后续扩展与稳定运行建议跑通之后这套组合的可玩性才刚开始。AstrBot 支持人设切换、插件市场、MCP 服务NapCat 支持群管理、文件传输。但扩展之前先把稳定性做好不然加的功能越多越容易崩。第一把配置持久化确认好。compose 里的 volumes 已经映射了 NapCat 的 config 和 QQ 数据、AstrBot 的 data只要这两个目录在容器重建后登录状态和配置都还在。建议定期备份这两个目录。第二模型通道保持统一。既然用了 TaoToken 统一 Key 和地址就别再往 AstrBot 里塞多个厂商的 Key否则以后换模型又要翻配置。需要换模型时只改 Model ID 一个字段。第三人设和上下文管理。AstrBot 里切换人设后记得用/reset清空上下文否则旧人设的对话会影响新回复。这个细节很多人忽略导致「换了人设但感觉没生效」。第四公网访问要谨慎。如果你想让管理后台在外网也能访问用内网穿透工具时务必给后台加密码并且不要把 OneBot 接口直接暴露到公网否则别人可以拿你的机器人发消息。安全永远优先于方便。第五长期运行建议用 Coding Plan 或按量 API 都行但要注意额度。QQ 机器人如果进了活跃群消息量可能不小先在控制台看用量避免超额。控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 里能看消耗。最后说个我踩过的坑一开始我把 AstrBot 和 NapCat 放在不同 compose 项目里结果网络不通排查了半天。后来统一到一个 compose、一个 network问题消失。所以如果你要改配置尽量保持两个服务在同一编排文件里省心。到这一步你的 Docker AstrBot NapCat DeepSeek QQ 机器人已经完整跑通从容器编排到模型回复全链路验证过。后面想加插件、换人设、接 MCP都是在稳定底座上做增量不会再被环境问题劝退。 搭 QQ 机器人被各种门槛劝退？用 Docker 几步搞定 AstrBot + NapCat + DeepSeek
1. 为什么搭 QQ 机器人总在环境这一步卡住如果你搜过「Docker 部署 AstrBot NapCat DeepSeek QQ 机器人」这类关键词大概率已经看过不少教程但真正动手时还是会被劝退。原因通常不在某一步特别难而是链路太长QQ 登录要处理协议、机器人框架要装 Python 依赖、模型调用要配 Key、容器之间还要能互相通信。任何一环出问题表现都是「机器人不回消息」你根本不知道是 QQ 没登上、OneBot 没连上还是模型 Key 填错了。我自己的经历是最早用源码方式装 AstrBot光 Python 版本和依赖冲突就折腾了一晚上第二天换 Docker 才意识到这套组合真正的价值就是把「环境」这件事交给容器你只需要关心三样东西——NapCat 有没有登上 QQ、AstrBot 有没有连上 NapCat、模型 Key 有没有生效。这三个问题各自都有明确的验证动作跑通一次之后后面换模型、加插件、改人设都只是改配置。这篇要交付的就是这条完整链路用 Docker Compose 把 AstrBot 和 NapCat 一起拉起来NapCat 扫码登录 QQAstrBot 通过 OneBot 协议对接再把 DeepSeek 的模型接进去最后用「容器健康检查 → QQ 收发消息 → 模型回复确认」三步验证。模型通道这块我会用 TaoToken 统一管理 Key 和 API 地址这样以后想换模型不用改一堆地方。适合谁看零基础、想在 Windows 或 Linux 上用 Docker 跑一个能对话的 QQ 机器人、不想天天修环境的人。全程命令可复制配置片段可直接改。先说清楚三个组件各自干什么不然后面配置容易懵。NapCat 是基于 NTQQ 的 OneBot 协议实现通俗讲它负责「登录你的 QQ 并提供标准接口」把 QQ 的收发消息翻译成 HTTP/WebSocket 接口。AstrBot 是 AI 聊天机器人框架负责接大模型、处理逻辑、管插件和人设它通过 OneBot 协议去调用 NapCat。DeepSeek 是模型提供方负责生成回复内容。三者关系是QQ 用户发消息 → NapCat 收到 → 通过 OneBot 转给 AstrBot → AstrBot 调模型 → 回复经 NapCat 发回 QQ。理解了这条数据流排障就有方向了消息没到 AstrBot查 NapCat 和 OneBot 连接AstrBot 收到了但不回复查模型 Key 和网络回复内容不对查人设和上下文。2. 用 TaoToken 统一模型 Key 与 API 通道在讲 Docker 编排之前先把模型接入这块理清楚因为它决定了你后面配置 AstrBot 时填什么。很多人卡在模型这一步是因为每个模型厂商的 Key、Base URL、模型名都不一样换一个模型就要改一次配置时间久了配置散落各处很难维护。我的做法是用 TaoToken 作为统一的模型接入通道。它的作用是给你一个统一的 API 地址和 Key背后可以对接 DeepSeek 等模型。对 AstrBot 来说它只需要知道一个 Base URL、一个 Key、一个 Model ID剩下的路由由 TaoToken 处理。这样你以后想从 DeepSeek 换到别的模型只改 Model ID 就行不用动 Key 和地址。具体要准备三样东西我把它叫「三件套」后面配置 AstrBot 时会反复用到配置项说明示例形态Base URL模型 API 的请求地址https://taotoken.net/apiAPI Key身份凭证形如 sk- 开头sk-xxxxxxxxModel ID具体调用的模型标识deepseek-chat获取方式先访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后进入控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建时给它起个能认出来的名字比如 astrbot-qq方便以后区分。注意API Key 只在创建时完整显示一次复制后先存到安全的地方。如果忘了直接删掉重新建一个即可不用纠结。拿到 Key 之后建议先单独验证一次确认通道是通的再去配 AstrBot。这样能把「模型通道问题」和「机器人配置问题」分开排障时省一半时间。验证可以用模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 直接发一句话测试也可以后面用 curl 验证。如果你打算长期跑编码类或 Agent 类任务可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 不过 QQ 机器人这种对话场景按量用 API 就够了。这里要强调一点TaoToken 是模型接入通道不是替代 AstrBot 或 NapCat 的。NapCat 依然负责 QQ 登录AstrBot 依然负责机器人逻辑TaoToken 只解决「模型怎么调」这一层。三者职责别混配置时就不会乱。3. 可复制的 Docker Compose 配置这一节是核心给你一份可以直接改的 docker-compose 配置把 AstrBot 和 NapCat 一起编排起来。我不用一键脚本因为脚本出问题时你不知道它改了什么用 compose 文件每一步都看得见改起来也清楚。先建目录把配置放进去mkdir -p ~/qq-bot cd ~/qq-bot然后创建docker-compose.yml内容如下。注意端口映射和 volumes 路径这两个是最容易出错的地方services: napcat: image: mlikiowa/napcat-docker:latest container_name: napcat restart: unless-stopped environment: - NAPCAT_UID1000 - NAPCAT_GID1000 ports: - 6099:6099 # NapCat WebUI 登录端口 - 3000:3000 # OneBot HTTP 接口 - 3001:3001 # OneBot WebSocket 接口 volumes: - ./napcat/config:/app/napcat/config - ./napcat/qq:/app/.config/QQ networks: - botnet astrbot: image: soulter/astrbot:latest container_name: astrbot restart: unless-stopped ports: - 6185:6185 # AstrBot WebUI 端口 volumes: - ./astrbot/data:/AstrBot/data environment: - TZAsia/Shanghai depends_on: - napcat networks: - botnet networks: botnet: driver: bridge几个关键点解释一下。restart: unless-stopped保证容器异常退出后自动拉起机器人这种长期跑的服务必须加。networks让两个容器在同一网络里AstrBot 可以直接用服务名napcat访问 NapCat不用管 IP。端口方面6099 是 NapCat 的 WebUI你扫码登录 QQ 用它3000/3001 是 OneBot 接口AstrBot 连它用6185 是 AstrBot 后台。启动docker compose up -d启动后先做容器健康检查这是三步验证的第一步docker compose ps正常的话两个容器状态都是Up。如果某个是Restarting或Exited看日志docker compose logs -f napcat docker compose logs -f astrbotNapCat 首次启动会初始化 QQ 环境日志里出现监听 6099 端口就算就绪。AstrBot 日志里出现 WebUI 启动信息即可。这一步过了说明容器编排没问题再往下走。提示如果你在 Linux 上跑注意 volumes 目录权限。NapCat 容器内以 UID 1000 运行宿主机目录如果权限不对会写不进去表现为登录后配置不保存。可以chown -R 1000:1000 ./napcat处理。4. 验证请求与成功结果容器起来后按三步验证走每步都有明确的成功标志不要跳步。第一步容器健康检查。上面docker compose ps两个 Up 就算过。再补一个端口检查curl -I http://localhost:6099 curl -I http://localhost:6185能返回 HTTP 响应头就说明服务在监听。第二步QQ 收发消息。浏览器打开http://localhost:6099进入 NapCat WebUI。首次登录需要 TokenToken 在容器日志里docker compose logs napcat | grep -i token复制 Token 填进页面然后选「扫码登录」用手机 QQ 扫码。登录成功后NapCat 就接管了这个 QQ 账号。此时用另一个 QQ 号给机器人账号发一条消息在 NapCat 的日志或消息列表里能看到这条消息说明 QQ 收发链路通了。第三步模型回复确认。回到 AstrBot 后台http://localhost:6185默认账号密码都是astrbot首次登录会要求改密码。登录后做两件事一是创建机器人消息平台选 QQ 个人号OneBot启用二是配置模型提供商把前面准备的「三件套」填进去。AstrBot 连 NapCat 的配置如果用 WebUI 填关键参数是{ platform: qq_official_or_onebot, onebot_ws_url: ws://napcat:3001, onebot_http_url: http://napcat:3000 }注意这里用的是容器服务名napcat不是 localhost因为 AstrBot 在容器里localhost 指向它自己。这是新手最容易踩的坑之一。模型提供商配置选 OpenAI 兼容类型填{ api_base: https://taotoken.net/api, api_key: sk-你的Key, model: deepseek-chat }保存后点「测试」返回成功即通道可用。然后用另一个 QQ 号给机器人发「你好」如果收到模型生成的回复三步验证全部通过。到这一步你的 QQ 机器人已经能对话了。如果模型测试通过但 QQ 不回复问题在 OneBot 连接如果 QQ 能收到消息但没回复问题在模型配置。按这个二分法定位很快能找到。5. 本篇常见报错排查这一节按真实报错来都是这套组合里高频出现的。401 Unauthorized。出现在模型测试或对话时。原因基本是 API Key 错了、过期或者 Base URL 填错。检查api_base是不是https://taotoken.net/apiKey 有没有多余空格。如果 Key 是在别处复制的重新在 API Keys 页面建一个再试。local proxy failed / connection refused。AstrBot 连不上 NapCat。先确认 NapCat 容器在跑再确认 AstrBot 里填的是ws://napcat:3001而不是ws://localhost:3001。如果两个容器不在同一 network服务名解析不了检查 compose 里的 networks 配置是否两边都加了botnet。reading choices 相关报错。这是模型返回结构解析失败通常发生在 Base URL 指向了非 OpenAI 兼容接口或者 Model ID 写错。确认 Model ID 是deepseek-chat这类有效值Base URL 用 TaoToken 的地址。如果换了模型Model ID 要同步改。OAuth / 登录失败。NapCat 扫码登录时报错多半是 QQ 版本或容器环境问题。先看 NapCat 日志具体报什么常见的是需要更新镜像docker compose pull napcat docker compose up -d。另外扫码用的手机 QQ 和机器人账号别是同一个否则会顶号。容器反复重启。看日志定位。NapCat 常见是 volumes 权限问题AstrBot 常见是 data 目录被占用或损坏。权限问题按前面说的chown处理data 损坏可以备份后清空./astrbot/data重新初始化。消息能收到但不回复且模型测试正常。检查 AstrBot 里机器人是否启用、是否绑定了正确的模型提供商。有时候创建了机器人但没启用或者模型提供商没设为默认都会导致不回复。排障时记住一个原则先看日志再改配置。docker compose logs -f 服务名是最高频的命令90% 的问题日志里直接写了原因。如果你在接入文档里找不到对应说明可以查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Base URL、Key、Model ID 的完整说明。6. 后续扩展与稳定运行建议跑通之后这套组合的可玩性才刚开始。AstrBot 支持人设切换、插件市场、MCP 服务NapCat 支持群管理、文件传输。但扩展之前先把稳定性做好不然加的功能越多越容易崩。第一把配置持久化确认好。compose 里的 volumes 已经映射了 NapCat 的 config 和 QQ 数据、AstrBot 的 data只要这两个目录在容器重建后登录状态和配置都还在。建议定期备份这两个目录。第二模型通道保持统一。既然用了 TaoToken 统一 Key 和地址就别再往 AstrBot 里塞多个厂商的 Key否则以后换模型又要翻配置。需要换模型时只改 Model ID 一个字段。第三人设和上下文管理。AstrBot 里切换人设后记得用/reset清空上下文否则旧人设的对话会影响新回复。这个细节很多人忽略导致「换了人设但感觉没生效」。第四公网访问要谨慎。如果你想让管理后台在外网也能访问用内网穿透工具时务必给后台加密码并且不要把 OneBot 接口直接暴露到公网否则别人可以拿你的机器人发消息。安全永远优先于方便。第五长期运行建议用 Coding Plan 或按量 API 都行但要注意额度。QQ 机器人如果进了活跃群消息量可能不小先在控制台看用量避免超额。控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 里能看消耗。最后说个我踩过的坑一开始我把 AstrBot 和 NapCat 放在不同 compose 项目里结果网络不通排查了半天。后来统一到一个 compose、一个 network问题消失。所以如果你要改配置尽量保持两个服务在同一编排文件里省心。到这一步你的 Docker AstrBot NapCat DeepSeek QQ 机器人已经完整跑通从容器编排到模型回复全链路验证过。后面想加插件、换人设、接 MCP都是在稳定底座上做增量不会再被环境问题劝退。