2026年新手小白部署OpenClaw（Clawdbot）+接入QQ机器人保姆级教程-阿里云开发者社区

在2026年AI办公与智能交互普及的背景下，OpenClaw（原Clawdbot、Moltbot）作为阿里云生态下极具实用性的开源AI代理工具，凭借自然语言指令操控、多任务自动化执行、多平台无缝集成的核心优势，成为个人与企业搭建专属AI助手的首选。其不仅能实现文档生成、文件解析、服务器运维等基础功能，更可通过与QQ机器人的深度对接，打破平台壁垒，让用户在QQ私聊、QQ频道中直接发送指令，完成各类办公与交互任务，大幅提升使用便捷度与效率。

很多用户和新手误以为，阿里云部署OpenClaw并接入QQ机器人需要专业编程知识、复杂的代码调试和环境配置，实则不然。2026年阿里云已完成OpenClaw专属镜像优化，预置所有运行依赖，实现“一键部署”；同时针对QQ机器人接入场景，结合QQ开放平台2026年最新规则，简化了凭证获取、通道配置、回调验证等流程，全程可视化操作+复制即用的代码命令，零基础用户也能在40-60分钟内完成从阿里云部署OpenClaw到QQ机器人接入、功能验证的全流程，无需编写一行代码。

本文基于阿里云官方实操指南、OpenClaw官方最新文档及QQ开放平台2026年最新规则，结合多场景实测经验，打造真正的保姆级教程。全程聚焦阿里云部署与QQ机器人接入两大核心环节，详细拆解每一步操作，标注每一个按钮位置、参数填写规范，包含完整的代码命令说明（复制即可执行），避开所有新手高频踩坑点，同时补充常见问题修复方案与日常运维技巧，确保每一位用户都能一次部署、一次接入成功，轻松打造适配QQ交互场景的专属AI助手。

本文全程不含任何无关平台信息，详细覆盖“部署前准备、阿里云OpenClaw一键部署、QQ机器人接入全步骤、功能验证、常见问题排查、日常运维”六大核心模块，无论是个人用户、学生群体，还是中小企业、创业团队，都能按需操作，快速实现OpenClaw与QQ机器人的无缝联动，解锁AI交互新方式。

一、部署与接入前置准备（必做，缺一不可）

在启动阿里云OpenClaw部署及QQ机器人接入流程前，需提前完成4项核心准备工作，这是部署与接入成功的基础，提前做好可大幅节省操作时间，避免中途卡壳，所有准备工作均标注清晰，新手可按步骤逐一完成。

（一）阿里云相关准备（部署核心）

1. 阿里云账号与实名认证

访问阿里云官网，注册阿里云账号（个人/企业账号均可），完成实名认证：个人用户可通过身份证刷脸、支付宝授权快速完成，审核即时生效；企业用户需上传营业执照等资质文件，审核周期1-3个工作日。
关键提醒：未完成实名认证无法购买阿里云服务器、开通百炼大模型服务，需确保账号状态正常、无欠费，可按需开通按量付费权限（避免大模型调用额度不足）。

2. 阿里云百炼API密钥获取（AI能力核心）

OpenClaw本身不具备AI能力，其所有自然语言解析、任务规划、对话响应等核心功能，均需对接阿里云百炼大模型实现（2026年新手推荐，新用户可领取免费调用额度，足够个人初期使用1-3个月、小型团队使用1个月），获取步骤如下：

登录阿里云百炼大模型服务平台，点击左侧导航栏“密钥管理”（默认地域建议选择华北2（北京），与服务器地域邻近可降低调用延迟）；
点击“创建API-Key”，系统自动生成一组专属凭证，包含“Access Key ID”和“Access Key Secret”，务必复制保存到本地记事本（仅创建时显示一次，丢失需重新创建）；
安全提示：API密钥是核心敏感信息，严禁泄露给未授权人员，避免大模型调用额度被盗用；若不慎泄露，可立即在百炼平台点击“重置”，生成新的API密钥；建议每3个月更新一次API密钥，提升安全性。

3. 阿里云一键部署OpenClaw步骤流程

第一步：访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot
阿里云轻量应用服务器部署OpenClaw1.png
阿里云轻量应用服务器部署OpenClaw2.png

第二步：选购阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

第三步：访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

4. 阿里云轻量应用服务器准备（部署载体）

推荐使用阿里云轻量应用服务器部署OpenClaw，操作简洁、性价比高，适配OpenClaw一键部署，无需手动配置复杂环境，步骤如下：

访问阿里云OpenClaw专属部署页面，点击“立即部署”；
核心配置选择（新手默认即可，无需修改，企业用户可按需升级）：
- 镜像选择：默认选中“应用镜像”→“OpenClaw（原Clawdbot）”专属镜像（2026年默认版本v2026.2.3，基于Alibaba Cloud Linux 3.2104 LTS 64位操作系统，来源于阿里云计算巢，已预装Node.js、Docker、OpenClaw主程序及所有核心依赖，无需额外安装）；
- 实例规格：新手/个人用户推荐2核2GB内存+40GB ESSD系统盘+200Mbps带宽（无固定流量限制），足够日常使用；复杂场景（如多用户同时使用、大量文件解析、多平台对接）可升级至4核4GB；需注意，内存必须2GiB及以上，否则无法正常部署；
- 地域选择：优先选择中国香港、美国弗吉尼亚等海外/港澳台地域（免ICP备案，购买后可直接使用，避免国内地域备案繁琐流程；目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限）；国内地域（如杭州、北京）需完成ICP备案后才能公网访问，且部分联网功能受限；
- 购买时长：短期测试可选择1个月，长期使用推荐1年付（性价比更高，新用户可享受专属优惠）；
完成配置后，点击“下一步：确认订单”，支付完成后，系统自动创建服务器实例并部署OpenClaw镜像，等待1-3分钟，直至服务器状态变为“运行中”，重点记录服务器公网IP（后续所有部署、接入操作均需用到，可在服务器实例详情页查看）。
补充说明：若已购买阿里云轻量应用服务器，可跳过购买步骤，以重置系统的方式部署OpenClaw（重置系统时选择应用镜像下的OpenClaw镜像），但重置系统会清除服务器上的系统盘数据，请提前做好数据备份。

（二）QQ机器人相关准备（接入核心）

1. QQ开放平台账号与权限准备

访问QQ开放平台官网（https://open.qq.com/ ），注册QQ开放平台账号（QQ开放平台账号与QQ账号独立，若之前未将QQ号绑定至已有的QQ开放平台账号，则无法用QQ号直接登录，需先完成QQ开放平台账号注册绑定流程）；
首次注册后，按照QQ开放平台的指引设置超级管理员，填写主体相关信息（姓名、身份证号、手机号、验证码），完成人脸认证（使用手机QQ扫码认证），审核通过后即可正常登录使用；
关键提醒：需确保账号具备机器人创建权限，个人主体可创建测试级机器人（适合个人使用、小型测试），企业主体可创建正式级机器人（适合企业使用、多场景适配）。

2. QQ机器人创建与核心凭证获取（接入关键）

OpenClaw与QQ机器人对接，需先创建QQ机器人，并获取3组核心凭证，分别是“AppID（机器人ID）”“AppSecret（机器人密钥）”“Token”，步骤如下（全程在QQ开放平台操作，可视化配置，新手可轻松完成）：

创建QQ机器人：
- 登录QQ开放平台，点击顶部导航栏“机器人”→“创建机器人”，根据页面提示填写机器人基础信息（机器人名称、头像、简介、所属分类，均自定义，便于识别）；
- 选择机器人类型：个人用户选择“测试机器人”，企业用户选择“正式机器人”，点击“创建”，完成机器人创建（创建后可在机器人列表中找到对应机器人，进入管理页面）。
获取核心凭证：
- 登录QQ开放平台，进入创建好的机器人管理页面，点击左侧导航栏“管理→开发管理”；
- 在开发管理页面，点击“生成”按钮，验证管理员身份后，即可获取当前机器人的“AppID”和“AppSecret”，点击右侧“复制”，分别保存到记事本（两种凭证需区分清楚，后续分别填写）；注意，AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成；
- 获取Token：Token格式为“AppID:AppSecret”，可手动拼接（将获取的AppID与AppSecret用冒号连接），拼接后保存到记事本，用于后续OpenClaw与QQ机器人的授权通信。
IP白名单设置（必做，否则无法通信）：
- 在机器人开发管理页面，找到“IP白名单”模块，点击“编辑”；
- 依次添加以下IP（阿里云OpenClaw与QQ机器人通信必备IP），添加完成后点击“保存”：
  121.40.82.220、47.97.73.42、47.98.226.113、47.96.151.112、118.178.89.160、120.27.202.100
- 额外添加部署OpenClaw的服务器公网IP（确保QQ机器人能接收来自服务器的请求）；
- 关键提醒：若后续出现“机器人去火星了”“无法接收消息”等提示，优先排查IP白名单是否配置正确、是否包含服务器公网IP。
沙箱环境配置（测试必备，2026年最新要求）：
- 进入机器人管理页面，点击左侧导航栏“开发→沙箱配置”；
- 在消息列表配置中，点击“添加成员”，输入需要测试机器人的个人QQ账号（仅沙箱成员可测试机器人，2026年1月31日后QQ开放平台暂不支持添加QQ群ID，仅支持频道与私聊）；
- 打开手机QQ，创建一个自定义频道（名称自定义，如“OpenClaw测试频道”），返回沙箱配置页面，选择该频道完成绑定，确保机器人可接收频道消息；
- 沙箱成员需使用手机QQ扫描配置页面提供的二维码，添加机器人为好友，完成后即可进行私聊、频道测试。

3. QQ机器人回调相关准备

回调地址是QQ机器人向OpenClaw发送指令、接收响应的核心通道，后续需配置为“http://你的服务器公网IP:18789/qqbot/callback”（适配OpenClaw 2026.2.3版本）；
若QQ机器人已完成企业认证，配置回调地址时需使用已备案且备案主体与QQ开放平台认证主体一致的域名（域名需提前解析至部署OpenClaw的服务器公网IP）；
若为测试机器人（未完成认证），可先使用服务器公网IP进行测试，无需配置域名，简化测试流程，后续正式使用时再配置备案域名即可；
补充配置：在机器人开发管理页面，点击“开发→开发管理→消息URL配置”，可配置发送图片的域名地址（可选，不配置有可能收不到图片消息）。

（三）环境预检（提前避坑，必做）

部署与接入前，需执行简单的预检操作，排查服务器环境、OpenClaw服务、网络连接等问题，避免中途出错，按以下步骤执行（复制命令即可，无需修改）：

远程连接阿里云服务器：
- 打开本地电脑的PowerShell（Windows系统）或终端（Mac/Linux系统），执行以下命令，远程连接服务器（替换为自己的服务器公网IP）：
```
# 远程连接阿里云服务器（root为默认用户名，无需修改）
ssh root@你的服务器公网IP
```
- 回车后，输入服务器root登录密码（输入时不显示，输完回车；提示“是否继续连接”，输入yes并回车，即可成功连接）；

检查OpenClaw服务运行状态：

# 查看OpenClaw服务运行状态（有“Up”字样即为正常运行）
docker ps | grep openclaw
# 正常输出示例：
# xxxxx openclaw:2026.2.3 "xxxx" Up 10 minutes 0.0.0.0:18789->18789/tcp openclaw-2026

若显示“Exited”，说明服务未正常启动，执行以下命令重启服务：
```
# 重启OpenClaw服务
docker restart openclaw-2026
```

检查核心端口是否放行（OpenClaw默认使用18789端口提供Web服务，同时用于与QQ机器人通信，必须放行）：
```
# 检查18789端口是否放行（输出“yes”即为正常）
firewall-cmd --query-port=18789/tcp
# 若输出“no”，执行以下命令一键放行端口（永久生效）
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 再次验证端口放行状态
firewall-cmd --query-port=18789/tcp
```
- 补充说明：阿里云轻量应用服务器控制台的“应用详情”页签，提供“一键放通”功能，可直接点击自动配置防火墙规则，无需手动执行命令放行端口。

验证OpenClaw API是否可正常访问（确保后续与QQ机器人通信正常）：

# 验证OpenClaw API可用性（替换为自己的服务器公网IP）
curl -X GET http://你的服务器公网IP:18789/api/v1/status
# 正常输出示例：{"code":200,"msg":"success","data":{"status":"running","version":"2026.2.3"}}

检查OpenClaw QQ机器人插件是否安装成功（核心，否则无法接入QQ机器人）：

# 查看已安装插件，确认qqbot插件是否存在
openclaw plugins list
# 正常输出示例：["qqbot", "file-parser", "document-generator"]，包含qqbot即为安装成功
# 若未安装，执行以下命令安装qqbot插件
openclaw plugins install qqbot
# 安装完成后再次查看插件列表，确认安装成功
openclaw plugins list

（四）工具准备（辅助操作）

终端工具：Windows系统使用自带的PowerShell（无需额外下载），Mac/Linux系统使用自带的终端，用于远程连接阿里云服务器、执行代码命令；
文本编辑工具：如记事本、Notepad++，用于保存各类凭证（API密钥、AppID、AppSecret等），避免混淆；
解压工具（可选）：如WinRAR、7-Zip，用于后续若需解压备份文件、配置文件；
浏览器：推荐使用Chrome、Edge浏览器，用于访问阿里云控制台、QQ开放平台、OpenClaw Web控制台，避免兼容性问题。

二、核心步骤一：阿里云OpenClaw一键部署与基础配置

阿里云服务器购买完成后，OpenClaw镜像已自动部署，无需手动安装主程序，只需完成“API密钥绑定、OpenClaw Token获取、Web控制台验证”3步，即可完成基础部署，全程可视化操作+简单命令，新手可快速完成。

第一步：绑定阿里云百炼API密钥（核心，实现AI能力）

API密钥绑定是OpenClaw实现AI功能的关键，新手推荐“控制台可视化配置”（无需执行复杂命令），进阶用户可选择终端命令配置，两种方式均可，步骤如下：

方式1：控制台可视化配置（新手首选，简单快捷）

登录阿里云轻量应用服务器控制台（https://swas.console.aliyun.com/ ），找到目标服务器实例，点击实例ID进入详情页；
点击顶部导航栏“应用管理”，找到“OpenClaw配置”模块，点击“一键配置API-Key”；
目前支持配置两种类型的百炼API Key，新手可按需选择：
- 按Token用量计费的百炼API Key：灵活计费，适合使用频率不固定的用户；
- Coding Plan 套餐专属 API Key：采用固定月费模式，提供月度请求额度，超出时段限额的调用会报错且不计费用，可避免产生超出预期的费用；需注意，Coding Plan仅支持抵扣qwen3-max-2026-01-23和qwen3-coder-plus模型调用费用，不支持调用多模态模型（包括默认内置的Image Model qwen3-vl-plus）；
API Key配置方式包括系统推荐及手动输入：
- 系统推荐（下拉选择）：系统会列出百炼Coding Plan的API Key（成本可控），及离服务器最近的百炼模型服务的API Key（时延较低），新手直接选择即可；
- 手动输入：若需使用其他地域或者其他账号的API Key，可切换至手动输入模式，输入百炼API Key并选择该API Key对应地域（务必确保地域正确，否则会导致模型无法正常调用）；
填写完成后，点击“确认配置”，等待30秒，系统提示“配置成功，服务已重启”，即完成API密钥绑定，OpenClaw已成功对接阿里云百炼大模型，具备AI交互能力。

方式2：终端命令配置（进阶用户，快捷高效）

打开终端工具，远程连接阿里云服务器（命令参考前置准备中的远程连接命令）；

执行以下命令，将API密钥写入OpenClaw配置文件（替换为自己的API密钥和对应地域，其余内容无需修改）：

# 绑定阿里云百炼API密钥（替换括号内的内容）
docker exec -it openclaw-2026 bash -c "echo 'ACCESS_KEY_ID=你的Access Key ID' > /opt/openclaw/.env && echo 'ACCESS_KEY_SECRET=你的Access Key Secret' >> /opt/openclaw/.env && echo 'BAILIAN_REGION=你的API Key对应地域' >> /opt/openclaw/.env"
# 重启OpenClaw服务，使配置生效
docker restart openclaw-2026
# 验证API密钥是否绑定成功
docker exec -it openclaw-2026 openclaw api test
# 正常输出：{"code":200,"msg":"success"}，即为绑定成功；若输出错误，检查API密钥是否正确、地域是否匹配

第二步：获取OpenClaw Token（对接QQ机器人授权凭证）

OpenClaw Token是QQ机器人访问OpenClaw服务的核心授权凭证，相当于“QQ机器人与OpenClaw通信的钥匙”，同时也是OpenClaw Web控制台的登录凭证，获取步骤如下（两种方式，按需选择）：

方式1：控制台可视化获取（新手首选）

进入阿里云服务器实例详情页→应用管理→OpenClaw配置→帮助→Token配置；
点击“执行命令”，系统会自动显示生成的OpenClaw Token，立即复制并保存到记事本（仅显示一次，切勿遗漏）；
警告：请勿泄露包含Token的完整URL，该链接包含身份验证凭据，任何持有此链接的人都能直接绕过登录验证，获得OpenClaw控制台的管理员权限。

方式2：终端命令获取（进阶用户）

远程连接阿里云服务器后，执行以下命令，直接获取Token：

# 查看并提取OpenClaw Token（直接复制回车，无需修改）
cat /root/.openclaw/openclaw.json | grep token
# 执行后会输出类似结果："token": "xxxxxxxxx"，复制双引号内的内容（不含双引号）即为Token

关键提醒：Token包含完整访问权限，严禁分享给未授权人员；若不慎丢失，可通过以下命令重置Token（重置后需重新配置QQ机器人对接）：

# 重置OpenClaw Token（直接复制回车，重置后会生成新Token）
openclaw config regenerate-token
# 或使用以下命令重置
docker exec -it openclaw-2026 openclaw token reset
# 重置后再次执行“查看Token”命令，获取新Token即可

第三步：开启OpenClaw响应API（适配QQ机器人对接，必做）

2026年OpenClaw v2026.2.3版本，需手动开启Response API访问，确保与QQ机器人的通信正常，步骤如下：

访问OpenClaw Web控制台：打开浏览器，输入“http://你的服务器公网IP:18789”，回车后进入登录页面，输入之前获取的OpenClaw Token，点击“登录”（首次登录无需额外设置密码）；
点击左侧导航栏“Setting > Config”，切换至“Gateway”→“Http”页签；
在“Responses”区域，将“Enabled”切换至开启状态（显示为绿色），点击“Save”保存，系统会自动重启服务，等待30秒即可生效；

补充验证：执行以下命令，确认API响应功能已开启：

# 验证OpenClaw响应API是否开启（替换为自己的服务器IP和Token）
curl -X POST http://你的服务器公网IP:18789/api/v1/response?token=你的OpenClaw Token -H "Content-Type: application/json" -d '{"msg":"test"}'
# 正常输出：{"code":200,"msg":"success","data":"test"}，即为开启成功

第四步：验证OpenClaw基础部署（必做，确保后续接入正常）

基础配置完成后，验证OpenClaw服务是否正常运行、AI能力是否可用，步骤如下：

打开OpenClaw Web控制台，在对话输入框中发送简单指令，如“你好，介绍一下你自己，说明你能做什么”；
正常响应示例：“你好呀！我是OpenClaw智能助手（原Clawdbot），已成功对接阿里云百炼大模型，可帮你完成文档生成、文件解析、服务器运维、任务管理等工作，后续可通过QQ机器人直接发送指令，无需切换平台～”；
测试核心功能：发送指令“生成一份个人工作周报模板，包含工作内容、遇到的问题、下周计划三个模块”，若能快速生成结构化周报模板，说明OpenClaw基础部署成功，AI能力正常；
若无响应，参考本文“常见问题排查”部分，优先检查API密钥绑定是否正确、OpenClaw服务是否正常运行、服务器网络是否通畅。

三、核心步骤二：OpenClaw接入QQ机器人（手把手操作，零编程）

完成OpenClaw基础部署后，进入核心接入环节，全程分为“配置OpenClaw QQ机器人通道”“创建阿里云AppFlow连接流（打通通信链路）”“QQ机器人回调地址配置”“绑定测试账号并测试”4步，适配2026年QQ开放平台最新规则，新手可按步骤操作，每一步都标注清晰，复制即用命令，确保不踩坑。

前置说明

2026年QQ开放平台对机器人功能进行了调整，QQ机器人在未上线之前，只能供沙箱测试账号使用，且暂不支持QQ群配置，仅支持QQ私聊和QQ频道交互；
若为测试机器人，无需完成上线流程，完成沙箱配置后即可进行测试；若为正式机器人，测试正常后需在QQ开放平台后台完成上线流程，才能供所有用户使用；
OpenClaw与QQ机器人通信，需区分沙箱环境和生产环境：测试阶段（机器人未上线），需使用QQ沙箱地址“https://sandbox.api.sgroup.qq.com”；生产阶段（机器人已上线，Docker运行默认为生产环境），默认使用QQ正式地址“https://api.sgroup.qq.com”；若机器人尚未发布，但使用Docker运行，需手动将apiBase设置为沙箱地址。

第一步：配置OpenClaw QQ机器人通道（关联QQ机器人凭证）

这一步的核心是“让OpenClaw识别QQ机器人”，将获取的QQ机器人凭证写入OpenClaw配置文件，步骤如下（新手推荐控制台可视化配置）：

方式1：控制台可视化配置（新手首选）

登录阿里云轻量应用服务器控制台→服务器实例详情页→应用管理→OpenClaw配置→通道配置；
点击“添加通道”，选择通道类型为“QQ机器人（QQBot）”；
依次填写以下信息（均为之前保存的凭证，复制粘贴即可，切勿手动输入）：
- 启用通道：勾选“启用”（确保通道处于开启状态）；
- AppID：粘贴之前获取的QQ机器人AppID；
- AppSecret：粘贴之前获取的QQ机器人AppSecret；
- Token：粘贴之前拼接的QQ机器人Token（AppID:AppSecret）；
- OpenClaw Token：粘贴之前获取的OpenClaw Token；
- 服务器公网IP：填写部署OpenClaw的服务器公网IP（无需加端口）；
- 环境选择：测试阶段选择“沙箱环境”，生产阶段选择“正式环境”；
- 交互设置：勾选“允许私聊”“允许频道@机器人”（适配2026年QQ机器人交互规则）；
填写完成后，点击“保存并应用”，系统会自动验证凭证有效性，若提示“通道配置成功，服务已重启”，即完成OpenClaw QQ机器人通道配置；若提示“凭证错误”，检查凭证是否复制完整、是否对应正确（如AppID与AppSecret混淆）。

方式2：终端命令配置（进阶用户，快捷高效）

远程连接阿里云服务器，执行以下命令，打开OpenClaw配置文件：

# 打开OpenClaw配置文件（用于配置QQ机器人通道）
nano /root/.openclaw/openclaw.json

在配置文件中找到“channels”节点，添加QQ机器人通道参数（替换为自己的凭证，其余内容无需修改）：

"channels": {
     
  "qq": {
     
    "enabled": true,
    "appId": "你的QQ机器人AppID",
    "appSecret": "你的QQ机器人AppSecret",
    "token": "你的QQ机器人Token",
    "sandbox": true, // 测试阶段设为true，生产阶段设为false
    "apiBase": "https://sandbox.api.sgroup.qq.com", // 测试阶段使用沙箱地址，生产阶段可删除或改为正式地址
    "allowPrivateChat": true, // 允许私聊
    "allowGroupAt": false, // 2026年暂不支持群聊，设为false
    "allowGuildAt": true // 允许频道@机器人
  }
}

保存配置文件：按下“Ctrl+X”，输入“Y”，按下“Enter”，即可保存并退出编辑；

执行以下命令，重启OpenClaw服务和网关，使通道配置生效：

# 重启OpenClaw服务
docker restart openclaw-2026
# 重启OpenClaw网关（确保通道配置生效）
openclaw gateway restart
# 验证QQ机器人通道是否配置成功
docker exec -it openclaw-2026 openclaw channel status qq
# 正常输出示例：{"code":200,"msg":"success","data":{"channel":"qq","status":"enabled","config":"valid"}}，即为配置成功

第二步：创建阿里云AppFlow连接流（打通通信链路，必做）

AppFlow是阿里云提供的应用连接器，用于打通OpenClaw与QQ机器人的通信链路，转发QQ机器人接收的指令到OpenClaw，再将OpenClaw的响应返回给QQ机器人，全程可视化配置，步骤如下：

访问阿里云AppFlow平台（https://appflow.console.aliyun.com/ ），使用部署OpenClaw的阿里云账号登录；
在首页搜索框中，搜索“通过QQ机器人使用MoltBot(Clawd)——多模态”模板，点击“立即使用”（无需手动创建空白连接流，节省配置时间）；
账户授权配置（核心步骤，确保凭证正确）：
- 点击“添加新凭证”，填写凭证名称（自定义，如“OpenClaw-QQ机器人凭证”）；
- 依次填写之前获取的QQ机器人AppID、AppSecret，以及OpenClaw Token；
- 点击“验证凭证”，验证通过后，点击“保存凭证”，选中刚刚创建的凭证，点击“下一步”；
执行动作配置（适配OpenClaw与QQ机器人通信）：
- 模型名称：填写格式为“alibaba-cloud/模型Code”（模型Code可在阿里云百炼模型广场查询，新手推荐填写“alibaba-cloud/qwen3-max-2026-01-23”，适配OpenClaw所有核心功能，且支持Coding Plan套餐抵扣）；
- 公网地址与端口：填写“你的服务器公网IP:18789”（默认端口18789，若已修改需填写实际端口）；
- 消息格式：默认选择“JSON格式”，无需修改；
- 环境配置：测试阶段，勾选“使用沙箱环境”，填写QQ沙箱地址“https://sandbox.api.sgroup.qq.com”；生产阶段，取消勾选，使用默认正式地址；
基本信息配置：填写连接流名称（自定义，如“OpenClaw-QQ机器人通信连接流”）与描述（自定义，如“打通OpenClaw与QQ机器人的通信链路，实现指令转发与响应”），点击“下一步”；
测试连接：点击“测试执行”，若提示“测试成功，返回状态码200”，即连接流配置正确；若提示“连接超时”，检查服务器18789端口是否放行、OpenClaw服务是否正常运行；若提示“权限不足”，检查凭证是否正确、QQ机器人IP白名单是否配置完整；
发布连接流：测试成功后，点击“保存”，再点击页面右上角“发布”，选择发布环境为“线上环境”，点击“确认发布”（发布后立即生效，无需审核）；
关键操作：发布成功后，复制页面顶部的“WebhookUrl”（QQ机器人消息接收地址），保存到记事本（后续QQ机器人回调地址配置需用到）。

第三步：配置QQ机器人回调地址（接入关键，必做）

回调地址是QQ机器人向OpenClaw发送指令、接收响应的核心通道，必须配置正确，否则无法实现双向通信，步骤如下（适配2026年QQ开放平台最新规则）：

登录QQ开放平台，进入创建好的机器人管理页面，点击左侧导航栏“开发→回调配置”；
配置核心参数（重点，填写错误会导致接入失败）：
- 请求地址（回调URL）：粘贴上一步获取的AppFlow WebhookUrl（复制完整，切勿遗漏字符）；若为测试机器人（未完成认证），也可直接填写“http://你的服务器公网IP:18789/qqbot/callback”（适配OpenClaw 2026.2.3版本）；若已配置备案域名，需使用域名格式“http://你的备案域名:18789/qqbot/callback”；
- 验证Token：填写之前拼接的QQ机器人Token（AppID:AppSecret），与OpenClaw通道配置中的Token保持一致；
- 消息加密方式：默认选择“兼容模式”，无需修改；
- 事件订阅：全选单聊事件、频道事件、互动事件（确保能接收所有类型的消息指令）；
点击“保存”，系统会自动验证回调地址有效性，若提示“验证成功”，即回调地址配置完成；若提示“验证失败”，检查URL是否填写正确、OpenClaw QQ机器人通道是否配置成功、服务器端口是否放行、QQ机器人IP白名单是否包含服务器公网IP；
补充配置：在回调配置页面，可设置消息重试次数（推荐设置为3次），避免因网络波动导致消息丢失。

第四步：绑定测试账号并测试（必做，验证接入成功）

配置完成后，将沙箱测试账号与QQ机器人绑定，测试通信是否正常，步骤如下：

绑定测试账号：
- 登录QQ开放平台，进入机器人管理页面，点击左侧导航栏“管理→成员管理”，点击“添加成员”，将需要测试机器人的QQ账号添加至成员列表（该账号需已添加到沙箱配置中）；
- 打开手机QQ，扫描沙箱配置页面提供的二维码，添加机器人为好友；同时进入之前创建的QQ测试频道，将机器人添加到频道中，完成绑定；
私聊测试（简单快捷，新手首选）：
- 打开手机QQ或电脑QQ，进入与QQ机器人的私聊窗口；
- 发送简单指令，如“你好，测试QQ机器人接入是否成功”；
- 若1-3秒内收到机器人响应，且响应内容正常（如“你好呀！OpenClaw已成功接入QQ机器人，以后你可以直接在这里发送指令，我会帮你处理办公任务哦～”），即单聊通信正常；
- 补充测试：发送指令“生成一份个人学习计划模板，包含每日学习内容、学习时长、目标”，若能快速生成结构化计划，说明AI功能正常对接。
频道测试（适配多用户协作场景）：
- 打开QQ测试频道，在频道聊天框中@QQ机器人，发送指令，如“@OpenClaw智能助手解析这份文件（上传本地简单文本文件），提取核心要点”；
- 若机器人能正常响应，且响应内容清晰、符合指令要求，即频道通信正常；若需要流式返回结果（如长文档解析），可在OpenClaw控制台开启“流式响应”功能，确保体验流畅；
关键提醒：
- 若未收到响应，不要着急，参考本文“常见问题排查”部分，逐一排查问题（多数是凭证填写错误、端口未放行、AppFlow配置错误、IP白名单未配置完整或QQ机器人环境配置错误）；
- 测试阶段，仅沙箱配置中的成员账号可与机器人交互，其他账号无法发送指令或接收响应；
- 若机器人已上线（正式机器人），需将交互设置中的“sandbox”改为false，apiBase改为QQ正式地址，重新配置回调地址并重启服务，即可供所有授权用户使用。

四、OpenClaw QQ机器人接入后核心功能配置（新手必学）

接入成功后，可配置OpenClaw QQ机器人的核心功能，适配个人、团队等多场景使用，无需复杂配置，全程在OpenClaw Web控制台操作，步骤如下：

登录OpenClaw Web控制台（http://你的服务器公网IP:18789 ），点击左侧导航栏“系统配置→QQ机器人配置”；
可配置以下核心功能（按需开启，推荐都开启，适配日常使用场景）：
- 自动回复配置：设置默认欢迎语（如“欢迎使用OpenClaw QQ AI助手，发送指令即可完成文档生成、文件解析、任务管理等工作，助力高效办公与学习！”），以及无指令时的回复（如“请发送具体指令，我会尽快为你处理～”）；
- 功能权限配置：勾选需要启用的功能，如“文档生成”“会议纪要生成”“待办清单创建”“文件解析”“服务器运维”“消息推送”（均为高频功能，无需额外配置）；可按用户权限设置功能访问范围，如普通测试用户仅可使用基础功能，管理员可使用服务器运维、权限管理等高级功能；
- 响应速度配置：选择“快速响应”（优先返回结果，适合简单指令，如通知生成、简单问答）或“精准响应”（优先保证结果质量，适合复杂指令，如合同解析、多任务规划）；
- 消息格式配置：设置响应消息的格式，如“文本展示”“卡片展示”，推荐“卡片展示”（更直观，适配QQ交互场景，支持图文结合）；
- 关键词触发配置：设置常用关键词（如“周报”“会议纪要”“学习计划”“文件解析”），用户发送关键词即可快速触发对应功能，节省指令输入时间；
- 定时任务配置：设置定时推送功能（如每天早上9点推送今日待办提醒、每周一早上推送本周学习/工作重点），步骤如下（可通过控制台或命令配置）：
```
# 方式1：控制台可视化配置（新手首选）
1.  点击“定时任务→添加任务”，选择任务类型为“QQ机器人推送”；
2.  填写任务名称（如“每日待办提醒”）、推送时间（如“0 9 * * *”，表示每天9点）、推送对象（指定QQ账号/QQ频道）、推送内容（可设置变量，如“今日待办：{
       {
       today_todo}}，请按时完成～”）；
3.  点击“保存”，任务自动生效。

# 方式2：终端命令配置（进阶用户）
# 添加定时任务（每天9点向指定QQ账号推送今日待办，替换为自己的QQ账号和推送内容）
docker exec -it openclaw-2026 openclaw cron add --time "0 9 * * *" --type "qq" --target "你的QQ账号" --content "今日待办：{
       {today_todo}}，请按时完成学习/工作任务～"
# 查看所有定时任务
docker exec -it openclaw-2026 openclaw cron list
# 启用定时任务
docker exec -it openclaw-2026 openclaw cron enable all
```
点击“保存并重启服务”，配置立即生效，此时在QQ私聊、QQ频道中发送对应指令，即可使用相关功能，常用功能示例如下：
- 指令1：“生成一份周末学习计划，包含英语、数学、语文三个科目，每天学习2小时”（文档生成功能）；
- 指令2：“@OpenClaw智能助手解析这份简历文件（上传简历），提取个人基本信息、工作经历、技能特长”（文件解析功能）；
- 指令3：“帮我创建一份今日待办清单，包含完成作业、整理笔记、运动1小时，设置每小时提醒一次”（待办清单功能）；
- 指令4：“查看当前阿里云服务器内存使用情况，发送到这个频道”（服务器运维功能）；
- 指令5：“向指定QQ频道推送一条通知，内容为‘本周六晚上8点开展线上学习交流，请勿缺席’”（消息推送功能）；
进阶配置（适合管理员，提升使用体验）：
- 点击左侧导航栏“权限管理→QQ机器人权限”，可设置不同QQ用户/频道的功能权限，避免无关功能干扰；
- 开启“多轮对话”功能，让OpenClaw记住上下文，支持连续指令交互（如“先生成周报模板，再帮我填充上周的工作内容，上周我主要负责客户对接和产品推广”）；
- 配置“消息过滤”功能，设置禁止触发的关键词（如恶意指令、敏感词汇），避免机器人响应不当内容；
- 定期备份OpenClaw配置文件，尤其是QQ机器人通道配置，避免配置丢失导致接入失败。

五、常见问题排查（新手必看，99%问题可解决）

新手在部署、接入过程中，容易遇到“OpenClaw服务启动失败、QQ机器人无响应、回调验证失败、AI无响应”等问题，无需上网查资料，直接对照以下问题，复制修复命令，一键解决，每一个问题都标注“表现+原因+修复步骤”，新手可快速对应。

问题1：QQ机器人发送指令后，无任何响应（最常见）

表现：QQ私聊/频道@机器人发送指令后，机器人无任何回复，也无错误提示；QQ开放平台回调配置页面提示“消息发送失败”或“未收到服务响应”；
常见原因：OpenClaw服务未启动、18789端口未放行、OpenClaw QQ机器人通道未启用、AppFlow未发布、回调地址填写错误、QQ机器人IP白名单未配置完整；
修复步骤：按以下顺序执行命令，逐一排查修复：

# 步骤1：重启OpenClaw服务，确保服务正常运行
docker restart openclaw-2026
# 重启OpenClaw网关
openclaw gateway restart

# 步骤2：检查18789端口是否放行，若未放行，一键放行
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 验证端口放行状态
firewall-cmd --query-port=18789/tcp

# 步骤3：检查OpenClaw QQ机器人通道状态，若未启用，启用通道
docker exec -it openclaw-2026 openclaw channel enable qq
# 再次查看通道状态，确认已启用
docker exec -it openclaw-2026 openclaw channel status qq

# 步骤4：验证回调地址是否可访问（替换为自己的服务器IP、Token和回调路径）
curl -X POST http://你的服务器公网IP:18789/qqbot/callback?token=你的QQ机器人Token -H "Content-Type: application/json" -d '{"msg":"test"}'
# 正常输出示例：{"code":200,"msg":"success","data":"test"}

# 步骤5：检查AppFlow状态（必做）
# 访问阿里云AppFlow平台，确认连接流已发布到“线上环境”，若未发布，重新发布
# 测试AppFlow连接，确保配置正确

补充提示：若仍无响应，检查回调地址是否填写正确（尤其是WebhookUrl是否复制完整）、QQ机器人IP白名单是否包含服务器公网IP和阿里云必备IP、OpenClaw与QQ机器人的Token是否一致。

问题2：QQ机器人回调验证失败（接入时最常见）

表现：配置QQ机器人回调地址时，点击“保存”提示“回调验证失败”“服务没有正确响应，请确认后重试”；
常见原因：回调URL填写错误、OpenClaw响应API未开启、Token填写错误、服务器地域限制（国内地域未备案）、QQ机器人环境配置错误；
修复步骤：

重新核对回调URL：确保填写的是AppFlow WebhookUrl，或“http://服务器IP:18789/qqbot/callback”，无填写错误、无遗漏字符；若已配置域名，确保域名已解析至服务器IP且已备案；
确认OpenClaw响应API已开启：参考本文“核心步骤一：第三步”，重新检查并开启响应API，重启服务；
重新核对Token：确保回调配置中的Token填写的是QQ机器人Token（AppID:AppSecret），与OpenClaw通道配置中的Token保持一致，无复制错误；
检查服务器地域：若服务器为国内地域（如杭州、北京），且QQ机器人已完成认证，需使用备案域名作为回调URL，未备案可更换为海外地域服务器；
检查QQ机器人环境配置：测试阶段需确保OpenClaw通道配置中的“sandbox”设为true，apiBase设为沙箱地址；

执行以下命令，修复OpenClaw回调配置：

# 重置OpenClaw回调配置（替换为自己的服务器IP和Token）
docker exec -it openclaw-2026 bash -c "echo 'QQ_CALLBACK_URL=http://你的服务器公网IP:18789/qqbot/callback' >> /opt/openclaw/.env && echo 'QQ_BOT_TOKEN=你的QQ机器人Token' >> /opt/openclaw/.env"
# 重启OpenClaw服务
docker restart openclaw-2026

问题3：AI无响应，QQ机器人回复“API错误”“模型连接失败”

表现：QQ机器人能接收指令，但回复“API密钥错误”“大模型连接失败”“无可用调用额度”，或长时间无响应；
常见原因：阿里云百炼API密钥填写错误、过期，或无可用调用额度；OpenClaw与百炼大模型对接失败；API Key地域配置错误；
修复步骤：

重新核对API密钥：登录阿里云百炼控制台，确认API密钥未过期，重新复制Access Key ID和Access Key Secret，按本文“核心步骤一：第一步”重新绑定；
检查大模型调用额度：登录阿里云百炼控制台，查看“调用额度”，若额度不足，新用户可领取免费额度，个人/企业用户可按需充值；若使用Coding Plan套餐，确认套餐未过期、额度充足；
检查API Key地域配置：确保绑定API密钥时选择的地域与API Key所属地域一致，否则会导致模型无法调用；

执行以下命令，重新对接百炼大模型：

# 重新绑定API密钥（替换为正确的凭证和地域）
docker exec -it openclaw-2026 bash -c "echo 'ACCESS_KEY_ID=你的正确Access Key ID' > /opt/openclaw/.env && echo 'ACCESS_KEY_SECRET=你的正确Access Key Secret' >> /opt/openclaw/.env && echo 'BAILIAN_REGION=你的API Key对应地域' >> /opt/openclaw/.env"
# 重启OpenClaw服务
docker restart openclaw-2026
# 验证模型连接是否正常
docker exec -it openclaw-2026 openclaw api test

问题4：QQ机器人回复乱码、格式错误

表现：QQ机器人能接收指令并响应，但回复内容乱码，或格式错乱、无卡片展示，不符合QQ交互场景；
常见原因：消息格式配置错误、OpenClaw编码问题、QQ机器人卡片权限未开通；
修复步骤：

检查OpenClaw消息格式配置：登录OpenClaw Web控制台，点击“系统配置→QQ机器人配置”，确认消息格式选择“卡片展示”，编码设置为“UTF-8”；

执行以下命令，修复OpenClaw编码配置：

# 配置OpenClaw编码为UTF-8，修复乱码问题
docker exec -it openclaw-2026 bash -c "echo 'LANG=en_US.UTF-8' >> /opt/openclaw/.env"
# 重启OpenClaw服务
docker restart openclaw-2026

检查QQ机器人权限：返回QQ开放平台机器人管理页面，确认“互动卡片实例写权限”已开通，若未开通，重新申请权限；
检查消息格式配置：确保OpenClaw通道配置中的消息格式与QQ机器人回调配置中的消息格式一致，均为JSON格式。

问题5：OpenClaw QQ机器人插件安装失败

表现：执行“openclaw plugins list”命令后，输出结果中不包含“qqbot”；执行“openclaw plugins install qqbot”命令提示安装失败；
常见原因：服务器网络不通、OpenClaw版本过低、插件源配置错误；
修复步骤：

# 步骤1：检查服务器网络连接
ping -n 5 open.qq.com
# 正常输出：无丢包、延迟稳定即为正常，若丢包需检查服务器网络

# 步骤2：升级OpenClaw到最新版本
curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/aliyun-update-openclaw.sh | bash
# 升级后重启OpenClaw服务
docker restart openclaw-2026

# 步骤3：重新安装qqbot插件
openclaw plugins install qqbot --force
# 安装完成后查看插件列表，确认安装成功
openclaw plugins list

问题6：QQ机器人提示“机器人去火星了”

表现：QQ私聊/频道中发送指令后，提示“机器人去火星了”，无法接收响应；
常见原因：QQ机器人IP白名单未配置正确、OpenClaw服务未启动、QQ机器人凭证过期；
修复步骤：

重新检查QQ机器人IP白名单：登录QQ开放平台，确认IP白名单中包含服务器公网IP和阿里云必备IP（121.40.82.220等6个IP），若未包含，重新添加并保存；

重启OpenClaw服务和QQ机器人服务：

# 重启OpenClaw服务
docker restart openclaw-2026
# 重启OpenClaw网关
openclaw gateway restart

检查QQ机器人凭证：确认AppID、AppSecret未过期，若已过期，重新生成并更新OpenClaw通道配置中的凭证，重启服务。

六、日常运维核心技巧（新手只需记5条，直接复制使用）

部署、接入成功后，日常运维无需复杂操作，新手只需记住以下5条核心命令，就能应对99%的日常使用场景，包括重启服务、查看状态、备份数据、升级版本、排查问题，所有命令可直接复制粘贴，无需手动输入，兼顾实用性与便捷性。

（一）核心运维命令（远程连接服务器后执行）

# 1. 重启OpenClaw服务（指令无响应、服务卡顿、配置修改后使用，最常用）
docker restart openclaw-2026
# 重启OpenClaw网关（通道配置修改后必用）
openclaw gateway restart

# 2. 查看OpenClaw运行状态与QQ机器人通道状态（出问题时优先查看）
docker ps | grep openclaw # 查看服务运行状态
docker exec -it openclaw-2026 openclaw channel status qq # 查看QQ机器人通道状态
openclaw plugins list # 查看插件安装状态

# 3. 查看运行日志（排查问题时使用，查看最近100条日志，定位错误原因）
docker exec -it openclaw-2026 tail -f /opt/openclaw/logs/openclaw.log -n 100

# 4. 备份OpenClaw配置与数据（重要！避免配置丢失、数据损坏，每周执行一次）
docker exec -it openclaw-2026 bash -c "tar -zcvf /opt/openclaw/backup/$(date +%Y%m%d).tar.gz /opt/openclaw/.env /opt/openclaw/config /root/.openclaw/openclaw.json"

# 5. 一键升级OpenClaw到2026最新版（保留所有配置，修复已知漏洞，适配QQ开放平台最新规则）
curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/aliyun-update-openclaw.sh | bash
# 升级后重启服务，确保生效
docker restart openclaw-2026

# 6. 重置QQ机器人通道配置（凭证错误、通道异常时使用）
docker exec -it openclaw-2026 openclaw channel reset qq

（二）QQ机器人侧日常维护（必做）

凭证轮换：定期（每3个月）轮换QQ机器人AppSecret、Token，以及OpenClaw Token、阿里云百炼API密钥，避免凭证泄露导致安全风险；轮换后需重新配置OpenClaw通道、AppFlow凭证、QQ机器人回调地址；
沙箱管理：及时更新沙箱测试账号，人员变动后，删除无关测试账号，避免未授权访问；
消息监控：定期查看QQ机器人的消息日志，了解用户使用情况，及时发现异常指令（如恶意指令、敏感词汇），调整消息过滤规则；
版本适配：QQ开放平台更新后，若出现接入异常，及时升级OpenClaw到最新版本，执行升级命令即可完成适配；关注QQ开放平台公告，及时适配相关功能调整（如2026年暂不支持群聊，后续若恢复需重新配置）。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

2026年新手小白部署OpenClaw（Clawdbot）+接入QQ机器人保姆级教程

一、部署与接入前置准备（必做，缺一不可）

（一）阿里云相关准备（部署核心）

1. 阿里云账号与实名认证

2. 阿里云百炼API密钥获取（AI能力核心）

3. 阿里云一键部署OpenClaw步骤流程

4. 阿里云轻量应用服务器准备（部署载体）

（二）QQ机器人相关准备（接入核心）

1. QQ开放平台账号与权限准备

2. QQ机器人创建与核心凭证获取（接入关键）

3. QQ机器人回调相关准备

（三）环境预检（提前避坑，必做）

（四）工具准备（辅助操作）

二、核心步骤一：阿里云OpenClaw一键部署与基础配置

第一步：绑定阿里云百炼API密钥（核心，实现AI能力）

方式1：控制台可视化配置（新手首选，简单快捷）

方式2：终端命令配置（进阶用户，快捷高效）

第二步：获取OpenClaw Token（对接QQ机器人授权凭证）

方式1：控制台可视化获取（新手首选）

方式2：终端命令获取（进阶用户）

第三步：开启OpenClaw响应API（适配QQ机器人对接，必做）

第四步：验证OpenClaw基础部署（必做，确保后续接入正常）

三、核心步骤二：OpenClaw接入QQ机器人（手把手操作，零编程）

前置说明

第一步：配置OpenClaw QQ机器人通道（关联QQ机器人凭证）

方式1：控制台可视化配置（新手首选）

方式2：终端命令配置（进阶用户，快捷高效）

第二步：创建阿里云AppFlow连接流（打通通信链路，必做）

第三步：配置QQ机器人回调地址（接入关键，必做）

第四步：绑定测试账号并测试（必做，验证接入成功）

四、OpenClaw QQ机器人接入后核心功能配置（新手必学）

五、常见问题排查（新手必看，99%问题可解决）

问题1：QQ机器人发送指令后，无任何响应（最常见）

问题2：QQ机器人回调验证失败（接入时最常见）

问题3：AI无响应，QQ机器人回复“API错误”“模型连接失败”

问题4：QQ机器人回复乱码、格式错误

问题5：OpenClaw QQ机器人插件安装失败

问题6：QQ机器人提示“机器人去火星了”

六、日常运维核心技巧（新手只需记5条，直接复制使用）

（一）核心运维命令（远程连接服务器后执行）

（二）QQ机器人侧日常维护（必做）

热门文章

最新文章

相关电子书