# 腾讯云一键部署 OpenClaw：从零打造一个 QQ 机器人
QQ 至今依然是大量开发者、社群和团队日常沟通的主阵地。群聊里总有一些反复出现的需求：有人想快速总结一段讨论，有人想让机器人帮忙整理待办，有人遇到部署报错不知道从哪儿查起，还有人只是单纯希望群里有个随时能问的 AI 助手。
传统的 QQ 机器人，大多是关键词匹配加固定指令，再加一堆手写规则。做个菜单、签到、自动回复倒是够用，可一旦遇到开放式问题就明显吃力了。OpenClaw 这类项目的意义在于，它把大模型能力嵌进了 QQ 消息入口，让机器人不再是机械匹配关键词，而是真正理解用户说了什么，再生成更自然、更有针对性的回复。
这次的目标很直白：用腾讯云一键部署 OpenClaw，把服务跑在云端，接入蓝耘 MaaS 模型，最后在 QQ 里验证机器人能不能正常回复。
---
## 一、整体方案
这套方案可以拆解成四层：
其中：
1. **QQ** 负责用户入口，用户在私聊或群聊里发送问题。
2. **OpenClaw** 负责接收消息、组织上下文、调用模型并返回结果。
3. **腾讯云** 负责承载 OpenClaw 服务，让机器人可以持续运行。
4. **蓝耘 MaaS** 负责大模型推理，提供自然语言理解和回复生成能力。
这样分层的好处是链路清晰。腾讯云解决部署问题，OpenClaw 解决机器人和模型之间的编排问题，蓝耘 MaaS 提供模型能力，QQ 则负责最终交互。各司其职，比较干净。
## 二、准备工作
正式开始之前，需要准备四样东西。
### 1. 腾讯云账号和服务器环境
一个腾讯云账号是必须的，另外还需要一台能部署应用的云服务器或轻量应用服务器。测试阶段不用一上来就盯着最高配置，先把服务跑通再说；以后真要放到真实群里用，再根据消息量、并发和上下文长度来调整规格。
### 2. QQ 机器人测试账号
建议准备一个专门用于测试的 QQ 账号，先在小群或私聊环境里验，别直接放到正式大群里。
原因很简单：机器人刚接好，模型回复到底靠不靠谱、触发规则有没有问题、权限控制是否到位，这些都需要调。一上来就扔进真实群，容易频繁响应、误触发，或者回复内容完全不符合预期，那体验就太糟糕了。
### 3. 蓝耘 MaaS API Key 和模型名称
蓝耘 MaaS 的 API Key 和模型名称需要提前准备好。本文示例使用的模型是：
```text
deepseek-v4-flash
```
实际填写的时候，以蓝耘控制台上展示的模型调用名称为准，不要自己随便写。
OpenAI-compatible 接入地址用这个：
```text
https://maas-api.lanyun.net/v1
```
后面在 OpenClaw 的模型配置里，Base URL、API Key、Model 这三项需要一一对应填进去。
### 4. 本次测试用例
为了后面验证效果，提前准备三条模拟输入：
```text
用例 1：你好，简单介绍一下你能帮我做什么。
用例 2：请把下面这段群聊内容总结成 3 个要点，并列出待办事项：
小王：周五前要把活动页上线。
小李：接口还差优惠券状态字段。
小张：设计稿今晚 8 点前补最后一版。
运营：上线前需要确认埋点和信息文案。
用例 3：我的 OpenClaw 服务启动后 QQ 没有回复，日志里显示模型请求失败，应该先检查哪些地方？
```
这三条分别覆盖基础问答、群聊总结和部署排查，足够验证一个最小可用链路了。
## 三、在腾讯云上一键部署 OpenClaw
腾讯云一键部署的价值在于省掉了手动准备环境的繁琐步骤。正常手动部署一个机器人项目，要处理依赖安装、运行目录、环境变量、端口开放、服务启动、日志查看等等细节。一键部署至少能把基础运行环境和项目初始化先搞定。
大致流程如下：
- **应用创建方式**：应用模板 > AI智能体 > OpenClaw(龙虾)
- **地域**：国内。
- **套餐**：
- 套餐类型：入门型（高性价比首选）
- 套餐配置：**推荐2核4G内存或更高配置的套餐**，最低配置支持2核2G内存（适合简单体验）
- 服务器名称、登录方式等按需配置就行。
如果已经有了腾讯云的轻量服务器，直接通过应用模板重装系统也可以。
部署完成后，别急着去 QQ 里测试。先确认服务本身是正常运行的，否则后面排查时很容易分不清到底是 QQ 连接问题、模型配置问题，还是 OpenClaw 服务根本没启动。
## 四、确认 OpenClaw 服务状态
进入腾讯云服务器或应用详情页后，建议先做一次基础检查。
| 检查项 | 期望结果 |
| ---- | ----------------- |
| 服务状态 | OpenClaw 相关服务正在运行 |
| 端口状态 | 项目监听端口正常 |
| 应用日志 | 没有明显启动报错 |
| 网络访问 | 服务器可以访问外部模型 API |
| 配置文件 | 模型、QQ 接入等配置入口可找到 |
如果一键部署页面提供了日志入口，可以先看看日志里有没有出现服务启动成功、监听端口、配置加载这些信息。如果需要通过终端查看，也可以按腾讯云页面给出的登录方式进入服务器。
把“服务是否启动”作为第一道关来卡，只有 OpenClaw 自身运行正常，后面配置模型和 QQ 接入才有意义。
## 五、配置蓝耘 MaaS 模型
接下来配置模型能力。OpenClaw 要想生成自然语言回复，必须调用大模型。这里走蓝耘 MaaS，通过 OpenAI-compatible 方式接入。
1. 在左侧菜单找到 **模型 (Models)** 配置项。
2. 默认的套餐包需要购买，直接在右侧下拉菜单中选择 **自定义模型**。
3. 根据官方文档，OpenClaw 支持“JSON 输入”和“表单输入”两种配置方式。推荐直接切换到 **表单输入**，然后严格对照蓝耘的模型参数逐项填写：
- **请输入自定义模型 provider**：自定义英文标识，例如 `lanyun`
- **请输入自定义模型 base_url**：填入蓝耘通用接口 `https://maas-api.lanyun.net/v1`
- **请输入自定义模型 api**：填入 `chat/completions`（注意，这是标准的 OpenAI 兼容调用路径，不要带斜杠）
- **请输入自定义模型 api_key**：填入你在蓝耘后台复制好的 `sk-...` 密钥
- **请输入自定义模型 model.id**：填入 `/maas/deepseek-ai/deepseek-v4-flash`（核心注意：一定要从蓝耘模型广场直接复制完整的调用路径）
- **请输入自定义模型 model.name**：自定义前台显示名称，例如 `deepseek-v4-flash`
> **进阶提示**：如果习惯用代码操作，也可以切换到 **JSON 输入**，直接粘贴以下配置（记得替换你的 `api_key`）：
> ```json
> {
> "provider": "deepseek",
> "base_url": "https://maas-api.lanyun.net/v1/chat/completions",
> "api": "openai",
> "api_key": "填入你的蓝耘API_KEY",
> "models": [
> {
> "id": "deepseek-v4-flash",
> "name": "deepseek-v4-flash"
> }
> ]
> }
> ```
4. 填写完毕后，点击下方的 **添加为默认**。如果左侧模型列表中间出现了一个带绿色小圆点（● 当前默认）的新模型卡片，说明蓝耘的高性能算力已经成功注入到你的 OpenClaw 中了！
这里最容易出错的点是模型名称。显示名称可以起得好记一些，但真正发起 API 请求时用的模型名必须和蓝耘控制台里的调用名称一字不差。
如果模型调用失败，优先检查三个地方：
1. API Key 是否完整复制。
2. Base URL 是否包含 `/v1`。
3. Model 是否和蓝耘控制台里的调用名称完全一致。
## 六、配置 QQ 机器人接入
模型配置搞定之后，还需要让 QQ 消息进入 OpenClaw。
这一步包括：
1. 登录或绑定 QQ 机器人账号。
2. 完成扫码、验证或授权流程。
3. 在 OpenClaw 中配置 QQ 适配器或消息入口。
4. 设置机器人允许响应的范围。
5. 保存配置并重启相关服务。
## 七、测试：用三条模拟消息验证最小链路
下面的测试不追求覆盖所有能力，只验证三个关键点：
1. QQ 是否能收到机器人回复。
2. OpenClaw 是否能正确调用蓝耘 MaaS 模型。
3. 回复内容是否适合作为 QQ 机器人输出。
把三条输入都发给 QQ 机器人做验证。重点看两点：QQ 端能不能收到 OpenClaw 返回的内容，以及回复是否真的体现了模型理解能力，而不是固定模板回复。
### 测试 1：基础能力说明
模拟输入：
```text
你好，简单介绍一下你能帮我做什么。
```
机器人收到问题后给出了一段比较完整的能力说明，开头明确表示自己是“运行在 OpenClaw 上的 AI 助手”。没有只返回一句固定欢迎语，而是按场景列出了几类能力：
1. 日常助手：回答问题、搜索信息、查天气、设置提醒、写作、翻译、总结、头脑风暴。
2. 文档和文件：创建、整理文档内容，读写工作区文件。
3. QQ 相关：在群里回答技术问题，管理频道或子频道，发布公告，查看成员，发送图片、语音、视频等富媒体消息。
这说明 QQ 消息已经能够进入 OpenClaw，并由接入的模型生成回复。作为连通性测试，这一条通过。
### 测试 2：群聊内容总结
模拟输入：
```text
请把下面这段群聊内容总结成 3 个要点，并列出待办事项：
小王：周五前要把活动页上线。
小李：接口还差优惠券状态字段。
小张：设计稿今晚 8 点前补最后一版。
运营：上线前需要确认埋点和信息文案。
```
这一轮里，机器人没有简单复述原文，而是把群聊内容整理成了两层结果。
第一层是“群聊总结 - 3 个要点”：
1. 活动页需要在周五前完成上线。
2. 接口侧还缺优惠券状态字段，对应小李。
3. 设计稿和运营前置事项仍需要推进，其中设计稿由小张在今晚 8 点前补最终版，运营需要在上线前确认埋点方案和信息文案。
第二层是待办表格，按“谁 / 做什么 / DDL”拆出了具体任务：
| 谁 | 做什么 | DDL |
| --- | --- | --- |
| 小李 | 补充接口中优惠券状态字段 | 尽快 |
| 小张 | 提交最终版设计稿 | 今晚 8 点前 |
| 运营 | 准备好埋点方案和信息文案，找相关方确认 | 上线前 |
| 小王 | 整体推进，兜底验收 | 周五前 |
这个结果比较符合群聊总结助手的预期：保留了时间信息，也把不同人的任务拆开了。尤其是“今晚 8 点前”“上线前”“周五前”这些时间节点一个没丢。后续如果把机器人放到项目群里，类似回复可以直接作为会后待办整理的初稿。
### 测试 3：部署排查建议
模拟输入：
```text
我的 OpenClaw 服务启动后 QQ 没有回复，日志里显示模型请求失败，应该先检查哪些地方？
```
机器人先判断出“模型请求失败导致 QQ 没有回复”这个关键前提，然后按优先级给出了排查清单。首先让用户检查 API Key 是否正确配置，接着提示检查模型名称和 Provider。
这个回复有两个亮点：
1. 没有泛泛地说“重启服务试试”，而是从最容易出错的模型鉴权和模型配置开始排查。
2. 能把 QQ 没回复和模型请求失败联系起来，说明模型理解问题中的因果关系。
当然也要注意，命令更适合作为排查思路参考，实际命令要以当前 OpenClaw 版本和部署方式为准。如果项目配置入口是页面表单，就不一定用得上命令行。
把三组测试整理成表格：
| 测试用例 | 预期结果 | 实际结果 | 是否可用 | 备注 |
| --- | --- | --- | --- | --- |
| 基础能力说明 | 能正常回复并说明能力 | 机器人成功返回 OpenClaw AI 助手能力说明，包含日常助手、文档文件、QQ 相关等能力 | 可用 | QQ -> OpenClaw -> 模型的基础链路已跑通 |
| 群聊内容总结 | 能提取要点和待办 | 输出 3 个总结要点，并生成“谁 / 做什么 / DDL”待办表格 | 可用 | 能保留负责人和时间节点 |
| 部署排查建议 | 能给出配置检查项 | 能围绕 API Key、模型名称、Provider 等模型请求失败高频问题给出排查方向 | 可用 | 命令示例需按实际部署版本调整 |
从这三组测试来看，OpenClaw 接入 QQ 后已经具备基础可用性：能正常回复、能处理结构化总结任务，也能围绕当前部署场景给出排查建议。后续要进一步优化，重点不再是“能不能通”，而是继续打磨 Prompt、触发规则和群聊里的回复边界。
## 总结
这次实践的完整链路可以概括为：
```text
腾讯云一键部署 -> OpenClaw 服务运行 -> QQ 机器人接入 -> 蓝耘 MaaS 模型配置 -> QQ 对话测试
```
腾讯云一键部署降低了 OpenClaw 的启动门槛，OpenClaw 把 QQ 消息和模型调用串起来，蓝耘 MaaS 提供实际的语言理解和回复生成能力。跑通这个最小闭环之后，一个 QQ 机器人就不再只是固定规则回复，而是可以承担问答、总结、排查建议等更灵活的任务。
后续如果想继续扩展，可以把机器人做成群聊总结助手、社群答疑助手、运维排查助手，或者接入更多业务资料和工具。真正需要打磨的，不只是模型能不能回答，而是触发规则、角色边界、上下文长度和安全策略是否适合 QQ 这个高频聊天场景。
