手把手教你部署一个跑在 Cloudflare Worker 上的 QQ AI 聊天助手

你是不是也想拥有一个 24 小时在线、随叫随到的 QQ AI 助手，但又不想买服务器、不想一直开着电脑？这篇教程就带你用 Cloudflare Worker + 腾讯 QQ 机器人 + DeepSeek 大模型，零成本搭一个「在 QQ 里直接和 AI 聊天」的机器人。部署完成后，哪怕你关掉电脑，它也会在云端稳定运行。

整个流程不需要写代码，全程「点点点」就能完成。跟着下面的步骤走就行。

开始前你需要准备#

一个 Cloudflare 账号（免费版就够，去 cloudflare.com 注册）
一个已完成实名的 QQ 账号（创建 QQ 机器人要求实名）
一个大模型 API Key（本教程以 DeepSeek 为例，去 platform.deepseek.com 注册后复制 API Key；你也可以换成任意 OpenAI 兼容的接口）

准备好了就开工。

第一步：Fork 仓库并部署到 Cloudflare#

打开项目仓库：https://github.com/violet27chen/qqbot-cloud

Pasted image 20260813191839.png

点击右上角的 Fork，把仓库复制到你的 GitHub 账号下。

Pasted image 20260813192028.png

接下来要把这个项目部署成 Cloudflare Worker。进入 Cloudflare 控制台，选择「创建 Worker 应用程序」。

Pasted image 20260813192216.png

选择「连接 GitHub」，授权 Cloudflare 访问你的仓库。

Pasted image 20260813192231.png

授权完成后，按钮会变成绿色，再次点击它。

Pasted image 20260813192310.png

Pasted image 20260813192322.png

在列表里选择刚才 Fork 的项目，点击 Next 进入下一步，然后直接点 Deploy 完成部署。

Pasted image 20260813192401.png

第二步：创建 KV 命名空间并绑定到 Worker#

Worker 需要一个 KV 存储空间来记住你和 AI 的对话上下文。我们先去创建它：点右上角的「创建」，新建一个 KV 命名空间。

Pasted image 20260813192512.png

命名空间名称填写 CHAT_HISTORY，然后点击 Create 创建。

Pasted image 20260813192614.png

创建好后回到刚才部署的 Worker，点右上角「添加绑定」。

Pasted image 20260813192708.png

绑定类型选择「KV 命名空间」。

Pasted image 20260813192724.png

第一个输入框填变量名 CHAT_HISTORY，第二个下拉框选择刚才创建的 CHAT_HISTORY 命名空间，保存。

Pasted image 20260813192743.png

第三步：创建 QQ 机器人并获取密钥#

打开 QQ 开放平台 https://q.qq.com/，登录并完成实名认证，然后点击「创建或管理我的机器人」。

Pasted image 20260813193225.png

填写一个你喜欢的机器人名称。

Pasted image 20260813193322.png

接入方式选择「其他机器人服务」，然后点击「查看密钥信息」。

Pasted image 20260813193437.png

复制这里的 AppID 和 AppSecret，待会儿要填到 Cloudflare Worker 里。

Pasted image 20260813193711.png

第四步：在 Worker 中配置环境变量#

回到 Cloudflare Worker，添加环境变量。先添加 QQ 相关的两项：

变量名 QQ_APP_ID，值填刚才复制的 AppID
变量名 QQ_CLIENT_SECRET，值填刚才复制的 AppSecret

注意变量名必须一字不差，否则 Worker 读不到对应的值。

Pasted image 20260813193711.png

继续添加大模型相关的环境变量，正确填写你的 LLM 信息（通常是 LLM_BASE_URL、LLM_API_KEY、LLM_MODEL 三项，分别对应接口地址、API Key 和模型名）。

Pasted image 20260813193820.png

填写完成后，Cloudflare 通常会自动重新部署让配置生效，稍等片刻即可。

第五步：开启生产环境访问并配置 QQ 回调#

在 Worker 页面点击「域 / Domains」，把生产环境的访问打开，拿到你的 Worker 地址。

Pasted image 20260813194013.png

复制弹出的第一个链接（也就是你的 *.workers.dev 地址），然后前往 QQ 机器人后台 https://q.qq.com/qqbot/dashboard/，选择刚才创建的机器人。

Pasted image 20260813194148.png

进入「开发设置 → 事件订阅与回调地址」。

Pasted image 20260813194244.png

把接入方式改为 Webhook，并勾选 C2C 消息事件（也就是你和机器人的私聊消息）。

Pasted image 20260813194331.png

点击「设置回调地址」。

Pasted image 20260813194359.png

在回调地址里粘贴刚才复制的 Worker 链接，格式是：前面加上 https://，后面加上 /qq-webhook。例如：

https://你的worker.workers.dev/qq-webhook

Pasted image 20260813194546.png

点击确定，到此全部配置完成！

为什么必须先在 Worker 配好环境变量，再去 QQ 设置回调#

有些同学会先把回调地址填好、再去 Worker 加密钥，结果 QQ 一直提示「签名校验不通过」。原因在这里：

QQ 的 Webhook 在设置回调地址时，会立刻发一个验证请求过来，要求 Worker 用机器人的密钥算出一个签名并返回。如果此时 Worker 里还没填 QQ_CLIENT_SECRET，它根本算不出正确的签名，验证自然失败。

所以正确顺序是：先在 Worker 里把 QQ_APP_ID 和 QQ_CLIENT_SECRET 配好并部署生效，再去 QQ 后台填回调地址。这样 QQ 来验证时，Worker 已经能用正确的密钥生成签名，一次通过。

Pasted image 20260813194756.png

大功告成#

配置完成后，去 QQ 私聊你的机器人，发一句话试试，它就会调用大模型给你回复了。对话上下文存在 Cloudflare KV 里，多轮聊天也能接得住。

如果你之后想用自己的域名访问（而不是 *.workers.dev），可以在 Cloudflare 给这个 Worker 绑定一个自定义域；要更稳地跑在生产环境，也可以按项目 README 的说明走「Dashboard 部署」。部署中有任何问题，欢迎在评论区留言，或去 GitHub 仓库提 Issue。