2026年,AI自动化工具与国民级社交平台的深度融合,成为个人提效与轻量协作的新趋势。OpenClaw(前身为Clawdbot、Moltbot)作为阿里云生态下开源、轻量化的AI自动化代理工具,凭借“零编程基础、全场景适配、高扩展性”的核心优势,成为个人与中小企业构建专属AI助手的首选;而QQ作为覆盖全年龄段、高渗透率的社交工具,广泛应用于日常沟通、文件传输、群聊协作等场景,是天然的指令交互入口。
将OpenClaw部署在阿里云,并一键接入QQ,可实现“QQ聊天窗口直接下达指令、OpenClaw自动执行任务、结果实时反馈”的闭环体验——无需频繁切换平台,无需登录OpenClaw Web控制台,在QQ私聊、群聊中即可触发AI任务,如网页数据抓取、文档生成、日程提醒、文件整理等,真正让AI助手融入日常,大幅减少重复手工劳动,提升办公与协作效率。
此前,不少用户在部署OpenClaw并接入QQ时,常因“环境配置复杂、QQ开放平台凭证获取繁琐、对接参数错误、端口配置遗漏”等问题卡壳,甚至因版本兼容问题导致部署失败、对接失效。本文整合阿里云官方实操指南、OpenClaw最新稳定版(v2026.2.0)特性、QQ开放平台最新对接规范及全网实测经验,重写优化全流程教程,严格保留“阿里云部署+QQ接入”的核心逻辑,剔除冗余技术细节,补充可直接复制的代码命令、新手避坑要点、凭证获取详解及常见问题排查方案。
文中明确标注阿里云OpenClaw(Clawdbot)部署简单速记步骤,聚焦阿里云与OpenClaw、QQ的深度适配,从前期准备、服务器部署、API配置,到QQ机器人创建、一键对接、功能验证,每一步都拆解到位、细节拉满,确保无论是否有技术基础,都能跟着步骤顺利完成部署与对接,成功搭建专属QQ AI助手,详情 访问阿里云OpenClaw一键部署专题页面 了解。
需明确的是,OpenClaw、Clawdbot、Moltbot本质是同一套AI自动化系统,仅为品牌迭代后的名称差异——2025年11月最初命名为Clawd(因商标纠纷更名),2026年1月更名为Moltbot(因名称冷僻、域名被抢注再次更名),最终确定为OpenClaw,强调开源属性与核心标识,目前GitHub仓库已完成全面迁移,开发与部署需以“OpenClaw”为准,旧名相关命令(如clawdbot dashboard)仍可兼容使用,本文所有操作步骤、代码命令均适配三者,无需额外调整。2026年OpenClaw最新版本已优化QQ接入流程,封装好QQ对接核心功能与插件,无需额外开发,通过简单配置、安装插件即可实现一键接入,同时与阿里云轻量应用服务器、无影云电脑、百炼大模型深度适配,进一步降低部署与使用门槛。
一、核心认知:部署对接逻辑与核心优势
1. 整体操作逻辑(新手必懂)
本次“阿里云部署OpenClaw+一键接入QQ”的核心逻辑是:以阿里云轻量应用服务器(或无影云电脑)为载体,通过阿里云专属镜像一键部署OpenClaw,配置阿里云百炼API-Key激活AI推理与任务执行能力;再通过QQ开放平台注册账号、创建机器人应用,获取应用凭证(AppID、AppSecret、Token等),设置IP白名单与沙箱环境;随后在阿里云服务器中安装OpenClaw QQ对接插件,将QQ应用凭证录入OpenClaw配置文件,建立两者之间的通信连接;最后通过沙箱测试与功能验证,实现QQ端与OpenClaw的双向交互——QQ端发送自然语言指令,OpenClaw解析指令并自动执行任务,执行结果实时反馈至QQ私聊、频道或群聊中,全程无需人工干预,无需切换平台。
2. 核心优势(为什么首选阿里云+OpenClaw+QQ)
- 零技术门槛:阿里云提供OpenClaw专属镜像,提前完成运行环境、核心依赖(Node.js 22+、Docker、Python 3.9等)的安装配置,一键部署无需手动调试;OpenClaw已封装QQ对接插件与核心逻辑,无需编写代码,复制命令、填写凭证即可完成对接,纯新手也能上手操作,全程不超过30分钟。
- 交互便捷高效:QQ作为国民级社交工具,支持手机、电脑多端同步,可随时随地通过聊天窗口触发AI任务,无需登录OpenClaw Web控制台,适配个人办公、亲友协作、小型团队群聊等多种场景,指令下达即执行,结果即时反馈,大幅提升操作效率。
- 稳定可靠且成本可控:阿里云云服务器具备24小时稳定运行、弹性伸缩、故障自动恢复的优势,确保OpenClaw全天候待命,避免本地设备关机后AI助手无法使用;阿里云轻量应用服务器新用户月付低至9.9元,按需付费模式可灵活控制成本,长期不使用时可停止实例,避免资源浪费;OpenClaw开源免费,无需支付软件费用;QQ机器人对接无需额外付费,仅需完成开放平台注册与应用配置即可免费使用核心功能。
- 生态联动无缝,扩展性强:OpenClaw无缝对接阿里云百炼大模型、OSS存储等产品,新用户可领取90天免费模型调用额度(超7000万tokens),足够前期测试使用;支持安装各类技能插件(如文件管理、网页抓取、日程管理等),可根据需求扩展AI助手功能;QQ机器人支持私聊、频道、群聊多场景交互,可自定义任务执行规则,适配多元使用需求。
- 安全有保障:依托阿里云服务器的安全隔离机制,保障指令传输与数据存储安全;QQ开放平台提供完善的权限管控与IP白名单功能,可限制机器人访问范围,避免恶意调用;OpenClaw支持定期轮换凭证、安全审计,进一步提升使用安全性。
3. 适用场景(看完明确是否需要部署)
- 个人办公提效:QQ私聊发送指令,让OpenClaw自动生成工作周报、整理邮件、抓取网页资料、创建文本/表格文件,解放双手,聚焦核心工作;
- 亲友协作与日常助手:让AI助手帮忙查询天气、翻译文本、生成节日祝福、整理旅行攻略,甚至帮忙记录亲友日程提醒,简化日常事务;
- 小型团队群聊协作:在QQ群聊中@机器人,自动生成会议纪要、统计群聊任务、分享行业资讯、整理群文件,减少人工协调成本;
- 自动化场景搭建:搭建自定义工作流,如“每天固定时间抓取行业热点→整理成文本→发送到指定QQ群/频道→提醒相关人员查看”,全程无需人工干预。
二、部署对接前必做准备(5分钟搞定,缺一不可)
1. 账号准备(全部需提前注册/登录,完成实名认证)
- 注册阿里云账号:打开阿里云官网,用手机号快速注册,登录后进入“账号中心”完成实名认证——个人用户可通过支付宝刷脸或身份证验证(即时生效),企业用户需上传营业执照及法人信息(审核1-3个工作日)。未完成实名认证的账号,无法购买云服务器、开通阿里云百炼服务,进而无法完成OpenClaw部署与API配置,同时需确保账号状态正常,无欠费记录。
- QQ账号:拥有一个已完成实名认证的QQ账号(未认证账号无法通过QQ开放平台审核,无法创建机器人应用),建议使用常用QQ账号,便于后续测试与使用。
- QQ开放平台账号:访问QQ开放平台官网(
https://q.qq.com),使用已实名认证的QQ账号注册,主体类型选择“个人”(企业用户可选择“企业”),完成实名认证(个人用户需上传身份证正反面,审核1-2个工作日),审核通过后即可创建QQ机器人应用。
2. 服务器准备(新手首选轻量应用服务器)
新手优先选择阿里云轻量应用服务器,配置要求低、操作简单、成本可控,核心配置参考如下(足够流畅运行OpenClaw并对接QQ):
- 实例规格:2vCPU + 2GiB内存 + 40GiB SSD存储(最低配置,可后续弹性升级);复杂场景(如多并发任务、大量网页抓取)可升级至2核4GB内存、5Mbps带宽、40GB高效云盘,满足更高性能需求;
- 地域选择:优先选择中国香港、新加坡、美国(弗吉尼亚)等海外/港澳台地域(免ICP备案,网络稳定,无联网限制,避免QQ对接时出现通信异常);国内用户若无需使用联网搜索功能,可选择华东1(杭州)、华北2(北京)地域,但需注意国内地域(除香港)的轻量应用服务器,联网搜索功能受限;
- 系统镜像:选择“OpenClaw(原Clawdbot/Moltbot)官方镜像”(应用镜像分类下搜索即可),该镜像基于Alibaba Cloud Linux 3.2104 LTS 64位操作系统,来源于阿里云计算巢,已提前安装好OpenClaw及所有核心依赖,无需手动配置环境;
- 付费类型:新手推荐“按需付费”(测试阶段成本低,不用可随时停止),长期使用建议“包年包月”,性价比更高;
- 密码设置:设置复杂登录密码(含大小写、数字、特殊字符),保存好密码与服务器公网IP(后续远程连接、登录控制台、QQ机器人IP白名单配置需用到)。
已有阿里云服务器的用户,无需重新购买,可通过“实例详情→重置系统”,选择OpenClaw官方镜像,重置前需备份服务器内重要数据(重置系统会清除系统盘数据);使用阿里云无影云电脑的用户,可直接在无影云电脑控制台选择OpenClaw专属镜像,创建云电脑实例,启动后直接进入可视化桌面,无需远程连接,后续步骤直接在云电脑终端执行即可。
3. 工具与凭证准备(重点,后续高频使用)
- 远程连接工具:推荐FinalShell(新手首选,可视化操作,免费),或Xshell、Windows PowerShell、macOS终端,用于远程连接阿里云服务器,执行代码命令;无影云电脑用户可跳过,直接使用桌面终端;
- 浏览器:推荐Chrome/Edge最新版,用于登录阿里云控制台、QQ开放平台、OpenClaw Web控制台;
- 辅助工具:记事本(用于保存服务器公网IP、密码、阿里云百炼API-Key、QQ机器人凭证等,避免丢失)、手机QQ(用于QQ开放平台实名认证、机器人沙箱测试、扫码验证);
- 核心凭证(后续逐步获取):阿里云百炼API-Key(激活OpenClaw AI能力)、QQ机器人凭证(AppID、AppSecret、Token)、OpenClaw访问Token(登录Web控制台、配置QQ对接)。
4. 注意事项
- 网络通畅:部署与对接过程中保持网络稳定,不中断远程连接、不刷新关键配置页面,避免部署失败、凭证获取异常;海外地域服务器需确保网络可正常访问QQ开放平台,避免通信受阻;
- 端口提前知晓:需放通3个核心端口——22端口(SSH远程连接)、18789端口(OpenClaw通信端口,QQ对接核心端口)、8080端口(OpenClaw Web控制台端口),后续将详细拆解放通步骤;
- 凭证保护:所有获取的API-Key、QQ机器人凭证、OpenClaw访问Token需妥善保存,切勿泄露,泄露可能导致账号被盗用、模型调用额度流失或QQ机器人被恶意操作;QQ机器人AppSecret、Token仅生成时可完整查看,刷新页面后无法再次获取,需及时保存;
- 版本适配:确保选择的OpenClaw镜像为2026年稳定版(v2026.2.0及以上),旧版本可能存在QQ对接兼容问题,可在阿里云实例创建页面确认镜像版本;
- 权限确认:提前确认阿里云账号具备轻量应用服务器购买、百炼API-Key创建权限,QQ开放平台账号已完成实名认证,具备机器人应用创建权限。
三、阿里云OpenClaw(Clawdbot)部署简单速记步骤(4步核心,新手快速上手)
阿里云一键部署OpenClaw步骤流程
第一步:访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot


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



第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
新手无需记住复杂操作,记熟以下4步,5分钟即可完成OpenClaw基础部署,后续再进行QQ对接,快速拥有专属QQ AI助手:
- 阿里云控制台创建轻量应用服务器实例,选择OpenClaw官方镜像,完成基础配置并启动实例,记录公网IP与登录密码;
- 登录阿里云百炼控制台,创建API-Key,复制并保存(核心凭证,用于激活OpenClaw AI能力);
- 远程连接服务器,执行简单代码命令,配置百炼API-Key并生成OpenClaw访问Token,放通核心端口;
- 登录OpenClaw Web控制台,验证服务正常运行,准备进行QQ对接。
四、详细操作步骤:阿里云部署OpenClaw(含代码命令)
本次操作全程基于阿里云轻量应用服务器(OpenClaw官方镜像),所有代码命令均可直接复制粘贴,无需修改,新手逐一步骤执行即可,全程不超过15分钟,同时适配阿里云无影云电脑用户(步骤基本一致,仅服务器操作略有差异)。
第一步:创建阿里云服务器实例(5分钟,核心部署基础)
- 登录阿里云控制台,在顶部搜索框输入“轻量应用服务器”,点击进入服务页面;也可直接访问阿里云OpenClaw一键部署专题页面,点击“一键购买并部署”,直接跳转至配置界面。
- 点击页面右上角“创建实例”,进入实例购买页面,按以下配置填写(新手直接照抄):
- 地域:中国香港(推荐,免备案,网络稳定,避免QQ对接通信异常);也可根据需求选择新加坡、美国(弗吉尼亚)等海外地域;
- 镜像类型:切换至“应用镜像”,搜索“OpenClaw(原Clawdbot/Moltbot)”,选中官方认证镜像(避免第三方镜像有安全风险,确保为2026年稳定版v2026.2.0及以上);
- 实例规格:默认2vCPU+2GiB内存+40GiB SSD,新手无需修改,足够使用;基础需求较高的用户可选择2核4GB内存、5Mbps带宽、40GB高效云盘;
- 付费类型:按需付费(勾选“我已阅读并同意相关服务条款”),长期使用建议“包年包月”;短期测试可选择月付,性价比更高;
- 实例名称:自定义填写(如“OpenClaw-QQ对接”),便于后续管理;
- 点击“立即购买”,支付成功后,进入“轻量应用服务器实例管理”页面,等待实例创建完成(约1-2分钟);
- 实例创建成功后,记录页面中的“公网IP地址”(后续远程连接、QQ机器人IP白名单配置、Web控制台访问需用到),并点击“重置密码”,设置服务器登录密码(与购买时密码可一致),重置后重启实例(确保密码生效);
- (可选)无影云电脑用户操作:登录阿里云无影云电脑控制台,选择OpenClaw专属镜像,创建云电脑实例,启动后直接进入可视化桌面,无需远程连接,后续步骤直接在云电脑终端执行即可。
避坑提醒
- 镜像必须选择“OpenClaw官方镜像”,不要选错为系统镜像(如CentOS、Ubuntu),否则需手动配置依赖,新手难以完成;
- 公网IP地址务必保存好,后续多个步骤均需用到,地域一旦确定无法修改,需谨慎选择;国内地域(除香港)需完成ICP备案,且联网搜索功能受限,不推荐新手选择;
- 实例创建后,默认处于“运行中”状态,若状态为“已停止”,需点击“启动实例”;若实例创建失败,检查阿里云账号是否完成实名认证、是否有足够余额(按需付费无需提前充值,仅使用时扣费);
- 密码设置需复杂,避免简单密码被破解,建议包含大小写字母、数字、特殊字符,保存至记事本中,避免遗忘。
第二步:获取阿里云百炼API-Key(3分钟,激活AI能力)
OpenClaw本身不具备AI推理与指令解析能力,需对接阿里云百炼大模型,通过API-Key获取授权,才能实现指令解析、任务拆解与自动化执行,这是核心关键步骤,新手按以下步骤操作,同时支持两种类型的百炼API-Key配置(按Token用量计费、Coding Plan套餐专属API-Key):
- 保持服务器实例管理页面不变,打开新浏览器标签页,访问阿里云百炼大模型控制台(https://bailian.aliyun.com/),用已实名认证的阿里云账号登录(自动关联,无需重新输入密码);也可访问阿里云百炼大模型服务平台(https://dashscope.aliyuncs.com),进入“密钥管理”页面。
- 登录后,点击左侧导航栏“密钥管理”(默认地域为华北2北京,不同地域API-Key相互独立,无需修改,系统会推荐离服务器最近的百炼模型服务的API Key,时延较低);
- 点击“创建API-Key”,系统自动生成一组Access Key ID和Access Key Secret组合密钥,生成后立即点击“复制”,将两组密钥保存到记事本中(关键提醒:该密钥仅创建时可完整查看,页面刷新后Access Key Secret将隐藏,无法再次查看,若怀疑泄露,需立即禁用并重新创建);
- 领取免费额度:新用户登录后,会自动弹出“领取免费额度”提示,点击“立即领取”,即可领取90天免费模型调用额度(超7000万tokens),足够前期测试使用;若免费额度耗尽,可充值或订阅百炼Coding Plan套餐,享受固定月费与月度调用额度,性价比更高,Coding Plan仅支持抵扣qwen3-max-2026-01-23和qwen3-coder-plus模型调用费用,不支持调用多模态模型;
- 权限确认:进入百炼控制台“权限管理”页面,确保当前API-Key已关联“模型调用”权限,若未关联,手动添加并保存;若使用子账号创建API-Key,需确保子账号具备“AliyunDashScopeFullAccess”权限。
补充说明
若使用阿里云百炼Coding Plan,需生成专属API-Key,并使用对应Base URL,按地域区分如下,后续配置需用到:
- 华北2(北京):
https://coding.dashscope.aliyuncs.com/v1 - 新加坡:
https://coding-intl.dashscope.aliyuncs.com/v1 - 美国(弗吉尼亚):
https://coding-us.dashscope.aliyuncs.com/v1
未购买Coding Plan的用户,无需单独配置Base URL,使用默认地址即可(https://dashscope.aliyuncs.com/compatible-mode/v1)。
第三步:远程连接服务器,配置OpenClaw(7分钟,含代码命令)
新手优先使用FinalShell远程连接服务器,可视化操作更简单,全程复制代码命令即可,无需手动编写;无影云电脑用户可直接打开桌面终端,跳过远程连接步骤,直接执行后续命令。
1. 远程连接服务器
- 打开FinalShell,点击左上角“新建连接”,选择“SSH连接”;
- 填写连接信息:主机(粘贴服务器公网IP)、用户名(默认root)、密码(服务器登录密码)、端口(默认22);
- 点击“确定”,双击连接,弹出“连接成功”提示,即完成远程连接(若提示“连接超时”,需检查服务器实例是否运行、22端口是否放通,可在阿里云实例管理页面“防火墙”中查看);若连接失败,可尝试更换远程连接工具(如Xshell),或检查服务器地域网络是否正常。
2. 检查OpenClaw镜像配置(必做)
连接成功后,复制以下命令,粘贴到终端中,按Enter键执行,检查OpenClaw是否已正确安装、依赖是否齐全(兼容旧版Clawdbot命令):
# 检查OpenClaw版本(兼容旧版Clawdbot命令)
openclaw --version
# 若提示command not found,切换旧命令
clawdbot --version
# 检查Node.js版本(需≥22,OpenClaw运行核心依赖)
node --version
# 检查Docker版本(镜像已预装,用于容器管理)
docker --version
# 查看OpenClaw服务状态(输出active(running)即为正常)
systemctl status openclaw
成功输出OpenClaw版本(如v2026.2.0)、Node.js版本(如v22.0.0)、Docker版本(如26.0.0),且OpenClaw服务状态为active(running),说明镜像配置正常;若Node.js版本过低,执行以下命令升级;若服务未运行,执行systemctl start openclaw启动服务:
# 升级Node.js至22版本
npm install -g n
n 22
# 验证升级结果
node --version
# 启动OpenClaw服务(若未运行)
systemctl start openclaw
# 设置OpenClaw开机自启,避免服务器重启后服务失效
systemctl enable openclaw
# 一键更新系统依赖,确保环境兼容性
yum update -y
3. 配置百炼API-Key(核心命令,激活AI能力)
复制以下命令,粘贴到终端执行,配置OpenClaw对接阿里云百炼大模型(替换命令中的“你的Access Key ID”和“你的地域Base URL”为实际信息,若未购买Coding Plan,无需修改Base URL):
# 进入OpenClaw配置目录
cd /root/.openclaw
# 编辑配置文件(中文注释,新手可直接复制,无需修改其他参数)
cat > openclaw.json << EOF
{
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "你的Access Key ID",
"api": "openai-completions",
"models": [
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max-thinking",
"reasoning": false
}
]
}
}
},
"gateway": {
"port": 18789,
"host": "0.0.0.0"
},
"channels": {
"qq": {
"enabled": false, # 暂设为false,后续QQ对接时改为true
"appId": "", # 后续填写QQ机器人AppID
"appSecret": "", # 后续填写QQ机器人AppSecret
"token": "", # 后续填写QQ机器人Token
"sandbox": true, # 开启沙箱测试模式,测试完成后可改为false
"allowPrivateChat": true, # 允许私聊交互
"allowGroupAt": true # 允许群聊@机器人交互
}
}
}
EOF
配置说明
- baseUrl:根据服务器地域选择,未购买Coding Plan的用户,华北2(北京)地域填写
https://dashscope.aliyuncs.com/compatible-mode/v1,新加坡地域填写https://dashscope-intl.aliyuncs.com/compatible-mode/v1;购买Coding Plan的用户,替换为对应地域的Coding Plan Base URL; - apiKey:粘贴第二步获取的Access Key ID,务必填写正确,否则无法调用百炼大模型;
- reasoning:必须设置为false,否则会导致回复内容为空,这是OpenClaw对接百炼模型的关键配置;
- qq相关配置:目前暂不填写,后续QQ对接时再补充,enabled设为false避免配置错误导致服务异常;sandbox设为true,开启沙箱测试模式,仅沙箱成员可测试机器人,测试完成后可改为false,开放给所有用户使用。
4. 重启OpenClaw服务,生成访问Token
配置完成后,重启OpenClaw服务使配置生效,并生成访问Token(用于登录Web控制台、后续QQ对接配置),复制以下命令执行:
# 重启OpenClaw服务,使API-Key配置生效
systemctl restart openclaw
# 查看服务运行状态(确保状态为active(running))
systemctl status openclaw
# 生成OpenClaw访问Token(用于登录Web控制台)
openclaw token generate
# 若使用旧版命令,切换为
clawdbot token generate
# 查看Token配置(可选,确认Token生成成功)
cat /root/.openclaw/openclaw.json | grep token
执行完成后,终端会输出一串随机字符串(即访问Token),复制并保存到记事本中(丢失后可重新执行generate命令生成),同时可执行以下命令验证API-Key配置是否生效:
# 进入OpenClaw容器环境(可选,用于验证配置)
docker exec -it openclaw-core /bin/bash
# 验证API-Key配置(输出API-Key即为成功)
openclaw config get models.providers.bailian.apiKey
# 退出容器环境
exit
5. 放通核心端口(必做,否则无法访问Web控制台、QQ对接失败)
OpenClaw Web控制台、QQ对接需依赖18789、8080端口,需手动放通端口(阿里云控制台可视化操作,无需执行命令,也可通过命令放通):
- 回到阿里云轻量应用服务器实例管理页面,点击左侧“防火墙”;
- 点击“添加规则”,分别添加以下3个端口的入站规则(确保QQ对接与Web控制台访问正常):
- 端口:22,协议:TCP,来源:0.0.0.0/0(已默认放通,若未放通则添加,用于远程连接);
- 端口:18789,协议:TCP,来源:0.0.0.0/0(OpenClaw通信端口,QQ对接核心端口);
- 端口:8080,协议:TCP,来源:0.0.0.0/0(OpenClaw Web控制台端口);
- 保存规则,端口放通完成;也可通过以下命令手动放通端口(Alibaba Cloud Linux/CentOS系统),同时验证端口放通状态:
# 手动放通核心端口(永久生效) firewall-cmd --add-port=18789/tcp --permanent firewall-cmd --add-port=8080/tcp --permanent firewall-cmd --reload # 验证端口放通状态(输出对应端口即为成功) firewall-cmd --list-ports | grep 18789 firewall-cmd --list-ports | grep 8080 # 查看端口占用情况(排查端口冲突) netstat -tlnp | grep 18789 netstat -tlnp | grep 8080
避坑提醒
- 执行配置命令时,确保复制完整,不要遗漏字符或空格,否则会配置失败,若配置错误,可删除配置文件重新执行命令(rm -rf /root/.openclaw/openclaw.json);
- 若启动服务提示“失败”,执行以下命令查看错误日志,针对性解决:
# 查看OpenClaw服务错误日志 journalctl -u openclaw # 查看OpenClaw运行日志(排查错误) openclaw logs # 重启服务 systemctl restart openclaw - 端口必须全部放通,缺少任意一个端口,都会导致Web控制台无法访问或QQ对接失败;若端口被占用,可通过netstat命令查看占用进程,关闭对应进程后重新启动服务;
- 若使用旧版命令clawdbot启动失败,可替换命令为clawdbot gateway run,确保服务正常运行;
- 海外地域服务器放通端口后,需确保网络可正常访问QQ开放平台,避免通信受阻。
第四步:验证OpenClaw部署成功(1分钟,必做)
- 打开浏览器,输入地址:
http://你的服务器公网IP:8080,跳转至OpenClaw登录页面; - 粘贴第三步生成的访问Token,点击“登录”,即可进入OpenClaw全中文Web控制台(左侧为对话窗口,右侧为功能菜单,新手易上手);
- 在Web控制台左侧对话窗口,发送以下测试指令,验证AI能力是否激活(即API-Key配置是否正确):
- 基础指令:“帮我生成一份个人工作周报模板,包含本周工作、下周计划,用中文分点列出”;
- 文档生成指令:“帮我创建一个名为‘OpenClaw部署测试’的文本文件,内容为‘阿里云部署OpenClaw成功,准备对接QQ’”;
- 简单查询指令:“帮我查询今天的天气情况,用简洁的语言回复”。
- 若OpenClaw能快速响应,生成符合要求的内容,说明部署成功,AI能力已激活;若提示“模型调用失败”,需检查API-Key填写是否正确、Base URL是否匹配,或百炼免费额度是否耗尽,排查无误后重新配置并重启服务。
五、详细操作步骤:OpenClaw一键接入QQ(含代码命令)
完成OpenClaw部署后,进入核心对接环节,全程分为“QQ开放平台注册与实名认证→创建QQ机器人应用→获取QQ机器人凭证→配置QQ机器人IP白名单与沙箱环境→安装OpenClaw QQ对接插件→配置OpenClaw QQ对接→验证对接效果”7步,无需编写代码,复制命令、填写凭证即可完成,新手逐一步骤执行,全程不超过15分钟。
第一步:QQ开放平台注册与实名认证(3分钟)
- 打开浏览器,访问QQ开放平台官网(
https://q.qq.com),点击右上角“注册”,使用已实名认证的QQ账号登录(建议使用常用QQ账号,便于后续测试与管理); - 登录后,进入“账号中心”,完成开放平台实名认证——个人用户选择“个人主体”,上传身份证正反面照片,填写个人信息(姓名、身份证号),完成人脸验证,审核1-2个工作日(通常当天即可审核通过);企业用户选择“企业主体”,上传营业执照、法人身份证等资料,审核3-5个工作日;
- 审核通过后,返回开放平台首页,确认账号状态为“已认证”,即可创建QQ机器人应用。
避坑提醒
- 必须使用已实名认证的QQ账号注册开放平台,未认证账号无法通过审核,无法创建机器人应用;
- 身份证照片需清晰、无遮挡,个人信息需与身份证一致,否则会审核失败;
- 审核期间可正常浏览开放平台,但无法创建机器人应用,需等待审核通过后再进行后续操作。
第二步:创建QQ机器人应用(3分钟,获取对接凭证基础)
- 审核通过后,登录QQ开放平台,点击顶部导航栏“机器人”,进入机器人管理页面,点击“创建机器人”;
- 填写机器人基本信息,按要求完成配置:
- 机器人名称:自定义填写(如“OpenClaw-AI助手”),将显示在QQ机器人列表、聊天窗口中;
- 机器人简介:简要填写(如“阿里云部署的OpenClaw AI助手,可通过QQ指令自动执行任务”);
- 机器人头像:可选,上传自定义图标(建议240×240px以上,无圆角,便于在QQ中识别);
- 主体类型:选择“个人”(与开放平台实名认证主体一致);
- 服务范围:选择“私聊+频道”(新手推荐,支持私聊与QQ频道交互;若需支持群聊,可额外勾选“群聊”,但需完成更多权限配置);
- 填写完成后,点击“创建”,完成机器人应用创建,系统自动跳转至机器人开发管理页面;
- 点击左侧导航栏“添加能力”,找到“消息接收与发送”能力,点击“添加”,启用该能力(QQ对接的核心能力,用于接收QQ指令、反馈执行结果);若需支持群聊,需额外添加“群聊消息处理”能力。
避坑提醒
- 机器人名称、简介需合规,不得包含违规、敏感词汇,否则会创建失败;
- 主体类型需与开放平台实名认证主体一致,否则无法创建机器人应用;
- “消息接收与发送”能力必须添加,否则机器人无法接收指令、反馈结果;若需扩展功能,可根据需求添加其他能力(如文件传输、日程管理等)。
第三步:获取QQ机器人凭证(2分钟,核心对接凭证)
QQ机器人凭证是OpenClaw与QQ对接的核心身份凭证,包括AppID、AppSecret、Token,需在QQ机器人开发管理页面获取,全部复制保存到记事本中(后续配置需用到),步骤如下:
- 在QQ机器人开发管理页面,点击左侧导航栏“开发管理”,找到“应用凭证”模块,复制“AppID”和“AppSecret”(这两个凭证用于OpenClaw与QQ的身份认证,确保通信安全);
- 在“开发管理”页面,找到“Token管理”,点击“生成Token”,系统自动生成一串Token(格式通常为“AppID:AppSecret”),生成后立即点击“复制”,保存到记事本中(该Token用于OpenClaw与QQ的通信加密,仅生成时可完整查看,刷新页面后无法再次获取,若丢失,需重新生成并更新OpenClaw配置);
- 核对凭证:确保3个凭证(AppID、AppSecret、Token)全部获取,无遗漏、无拼写错误,粘贴到记事本中,后续配置直接复制使用,避免手动输入出错。
避坑提醒
- 3个凭证务必保存完整,切勿泄露,泄露可能导致QQ机器人被恶意操作、指令被篡改;
- AppSecret、Token仅生成时可完整查看,刷新页面后无法再次获取,若丢失,需重新生成并更新OpenClaw配置;
- 凭证区分大小写,复制时不要遗漏空格、特殊字符,否则会导致对接失败;
- 若后续凭证泄露,可在“Token管理”页面点击“重置Token”,重新生成Token后,需及时更新OpenClaw配置文件中的Token信息。
第四步:配置QQ机器人IP白名单与沙箱环境(2分钟,确保对接安全、测试正常)
- IP白名单配置:在QQ机器人开发管理页面,点击左侧导航栏“安全配置”,找到“IP白名单”模块,点击“添加IP”,粘贴阿里云服务器公网IP(步骤一记录的公网IP),点击“保存”;IP白名单用于限制可访问机器人的服务器IP,避免恶意调用,只有添加了服务器公网IP,OpenClaw才能与QQ机器人正常通信;
- 沙箱环境配置:点击左侧导航栏“沙箱测试”,进入沙箱配置页面,点击“添加沙箱成员”,输入个人常用QQ账号(仅沙箱成员可测试机器人,2026年1月31日后无法添加QQ群ID,仅支持频道与私聊);
- 打开手机QQ,创建一个自定义频道(名称自定义,如“OpenClaw测试频道”),返回沙箱配置页面,选择该频道完成绑定,确保机器人可接收频道消息;
- 启用沙箱模式:在沙箱配置页面,点击“启用沙箱模式”,沙箱模式下,机器人仅对沙箱成员可见,仅能接收沙箱成员发送的指令,便于测试对接功能,避免误操作影响其他用户。
避坑提醒
- IP白名单必须添加阿里云服务器公网IP,否则OpenClaw无法与QQ机器人正常通信,对接会失败;若服务器公网IP变更,需及时更新IP白名单;
- 沙箱成员需添加个人常用QQ账号,且该账号需已完成实名认证,否则无法接收机器人消息;
- 沙箱模式建议在测试阶段启用,测试完成后可关闭沙箱模式,开放给所有用户使用;
- 若测试时提示“机器人去火星了”,优先排查IP白名单是否正确、沙箱成员是否添加成功。
第五步:安装OpenClaw QQ对接插件(2分钟,含代码命令)
回到远程连接终端(或无影云电脑终端),OpenClaw需安装QQ对接插件,才能实现与QQ机器人的通信,复制以下命令执行,全程自动安装,无需手动干预:
# 进入OpenClaw目录
cd /root/.openclaw
# 下载QQ插件(来源于OpenClaw官方仓库,确保兼容性)
git clone https://github.com/sliverp/qqbot.git
# 安装QQ插件
openclaw plugins install ./qqbot
# 查看已安装插件,确认QQ插件安装成功(输出qqbot即为成功)
openclaw plugins list
# 若安装失败,执行以下命令更新插件管理器,重新安装
openclaw plugins update-manager
openclaw plugins install ./qqbot
避坑提醒
- 若提示“git: command not found”,说明服务器未安装git,执行以下命令安装git后,重新执行插件安装命令:
yum install git -y - 插件安装过程中,确保网络稳定,不中断终端连接,否则会安装失败;
- 若安装失败,可查看错误日志(openclaw logs --module plugins),针对性解决,或重新下载插件并安装;
- 确保安装的QQ插件与OpenClaw版本兼容(v2026.2.0版本适配最新版QQ插件),避免版本不兼容导致对接失败。
第六步:配置OpenClaw QQ对接(2分钟,含代码命令)
插件安装完成后,将QQ机器人凭证录入OpenClaw配置文件,启用QQ对接功能,复制以下命令执行(替换命令中的3个凭证为实际获取的QQ机器人凭证,直接复制粘贴,无需修改其他参数):
# 进入OpenClaw配置目录
cd /root/.openclaw
# 编辑配置文件,补充QQ对接配置(覆盖原有qq相关配置)
cat > openclaw.json << EOF
{
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "你的Access Key ID",
"api": "openai-completions",
"models": [
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max-thinking",
"reasoning": false
}
]
}
}
},
"gateway": {
"port": 18789,
"host": "0.0.0.0"
},
"channels": {
"qq": {
"enabled": true, # 启用QQ对接功能
"appId": "你的QQ机器人AppID", # 粘贴QQ机器人AppID
"appSecret": "你的QQ机器人AppSecret", # 粘贴QQ机器人AppSecret
"token": "你的QQ机器人Token", # 粘贴QQ机器人Token
"sandbox": true, # 开启沙箱测试模式,测试完成后可改为false
"allowPrivateChat": true, # 允许私聊交互
"allowGroupAt": true, # 允许群聊@机器人交互
"replyTimeout": 30000 # 回复超时时间(30秒),避免长时间等待
}
}
}
EOF
配置说明
- enabled:设为true,启用QQ对接功能,此前设为false是为了避免配置错误导致服务异常;
- appId、appSecret、token:粘贴第三步获取的QQ机器人凭证,务必填写正确,否则无法与QQ机器人正常通信;
- sandbox:保持true,开启沙箱测试模式,仅沙箱成员可测试机器人,测试完成后可改为false,开放给所有用户使用;
- allowPrivateChat、allowGroupAt:均设为true,分别允许私聊交互、群聊@机器人交互,若无需支持群聊,可设为false;
- replyTimeout:设置为30000(单位:毫秒),即30秒,避免指令执行时间过长导致回复超时。
配置完成后,重启OpenClaw服务与QQ插件,使QQ对接配置生效,复制以下命令执行:
# 重启OpenClaw服务
systemctl restart openclaw
# 重启QQ插件
openclaw plugins restart qqbot
# 查看QQ插件运行状态(确保无报错)
openclaw plugins status qqbot
# 查看QQ对接日志,确认无异常(可选)
openclaw logs --module qq
若服务启动正常、插件运行正常、日志无报错,说明OpenClaw QQ对接配置完成;若启动失败,检查QQ凭证是否填写正确、插件是否安装成功,排查无误后重新配置并重启服务。
第七步:验证QQ对接效果(1分钟,必做,确认对接成功)
对接完成后,通过QQ私聊、频道测试指令接收与结果反馈,确保对接成功,步骤如下(仅沙箱成员可测试,测试完成后可关闭沙箱模式):
1. 私聊测试(新手首选,简单易操作)
- 打开手机QQ或电脑QQ,登录沙箱成员账号(第四步添加的个人QQ账号);
- 在QQ中搜索创建的机器人名称(如“OpenClaw-AI助手”),找到机器人并添加好友,进入单聊窗口;
- 发送以下测试指令,查看机器人是否能正常响应、反馈结果:
- 指令1:“帮我生成一份个人工作周报模板,包含本周总结、下周计划、问题与改进”;
- 指令2:“帮我抓取阿里云轻量应用服务器的最新优惠,整理成文本发送给我”;
- 指令3:“帮我翻译一句话:‘阿里云部署OpenClaw一键接入QQ,高效又便捷’,翻译成英文”;
- 指令4:“帮我查询明天的天气情况,简洁回复”。
- 若机器人能在30秒内响应,反馈符合要求的结果(如周报模板、优惠信息、翻译结果、天气情况),说明单聊对接成功;若无响应,检查QQ凭证是否填写正确、IP白名单是否添加、OpenClaw服务与QQ插件是否正常运行,排查无误后重新测试。
2. 频道测试(可选,适配频道协作场景)
- 打开手机QQ,进入第四步创建的测试频道(如“OpenClaw测试频道”);
- 在频道聊天窗口中@机器人,发送测试指令(如“@OpenClaw 帮我创建一个文本文件,标题为‘QQ对接测试’,内容为‘对接成功,可正常使用’”);
- 若机器人能正常响应,反馈执行结果(如“文件创建成功”),说明频道对接成功;若无响应,检查频道是否已绑定沙箱环境、机器人是否已加入频道,排查无误后重新测试。
3. 群聊测试(可选,适配团队场景)
- 若已添加“群聊消息处理”能力,创建一个QQ群,邀请机器人与沙箱成员加入;
- 在群聊中@机器人,发送测试指令(如“@OpenClaw 统计当前群聊成员数量,分点列出”);
- 若机器人能正常响应,仅回复@它的指令,说明群聊对接成功;若群聊中未@机器人也回复,检查OpenClaw配置中的allowGroupAt是否设为true,或修改配置限制群聊回复规则。
4. 功能扩展测试(可选,提升实用性)
安装QQ相关扩展技能,提升对接实用性,复制以下命令执行(通过ClawHub技能市场安装):
# 安装ClawHub CLI工具(用于技能管理)
npm i -g clawhub
# 登录ClawHub(使用OpenClaw访问Token)
clawhub login --token 你的访问Token
# 安装文件传输技能(支持通过QQ发送/接收文件)
clawhub install qq-file-transfer
# 安装网页抓取技能(支持通过QQ指令抓取网页资料)
clawhub install web-scraper
# 安装日程管理技能(支持通过QQ指令创建日程提醒)
clawhub install calendar-manager
# 重启OpenClaw服务与QQ插件,使技能生效
systemctl restart openclaw
openclaw plugins restart qqbot
技能安装完成后,发送指令“@OpenClaw 帮我抓取阿里云官网的最新活动资讯,整理成文本发送给我”,测试网页抓取功能;或发送“@OpenClaw 帮我创建明天10点的日程提醒,备注‘OpenClaw使用培训’”,测试日程管理功能,确保技能正常使用。
六、日常运维与基础使用技巧(新手必看)
1. 常用运维命令(复制即用,管理OpenClaw与服务器)
后续需管理OpenClaw服务、升级版本、排查问题、管理QQ插件时,可使用以下命令,无需复杂操作,同时可添加日志清理定时任务,优化服务器性能:
# 重启OpenClaw服务(配置修改、技能安装后必执行)
systemctl restart openclaw
# 停止OpenClaw服务(长期不使用时)
systemctl stop openclaw
# 查看OpenClaw运行日志(排查错误,按模块查看)
openclaw logs
openclaw logs --module qq # 仅查看QQ对接日志
openclaw logs --module model # 仅查看模型调用日志
openclaw logs --module plugins # 仅查看插件日志
# 升级OpenClaw至最新版本(修复bug,优化QQ适配)
openclaw update
# 重新生成OpenClaw访问Token(丢失后使用)
openclaw token generate
# 重新生成QQ机器人对接凭证(可选,若凭证泄露)
openclaw plugins restart qqbot --regenerate-token
# 查看服务器CPU/内存占用(确保运行流畅)
top
# 查看端口占用情况(排查端口冲突)
netstat -tlnp | grep 18789
netstat -tlnp | grep 8080
# 安装git(插件下载失败时使用)
yum install git -y
# 更新系统依赖
yum update -y
# 添加日志清理定时任务(每天凌晨0点清理日志)
echo "0 0 * * * rm -rf /root/.openclaw/logs/*.log" >> /etc/crontab
crontab /etc/crontab
# 优化OpenClaw性能(可选)
openclaw config set database.poolSize 20 # 数据库连接池大小20
openclaw config set database.cache.enable true # 开启数据库缓存
systemctl restart openclaw
# 卸载QQ插件(如需)
openclaw plugins uninstall qqbot
2. QQ端使用技巧(提升使用效率)
- 指令格式:单聊中可直接发送指令,无需@机器人;群聊中必须@机器人,否则机器人不响应,指令需简洁明了,避免模糊表述(如“帮我生成周报”比“周报”更易识别);
- 常用指令示例(直接复制发送即可):
- 文档类:“帮我创建一份文本文件,标题为‘2026年3月工作计划’,分点列出核心任务”;
- 数据类:“帮我抓取本周行业热点,整理成文本,发送给我”;
- 翻译类:“帮我翻译‘AI automation makes work more efficient’,翻译成中文”;
- 日常类:“帮我查询明天的天气,帮我生成一条节日祝福,帮我整理一份旅行攻略”;
- 协作类:“@OpenClaw 帮我统计当前群聊中未完成的任务,提醒相关人员”;
- 技能管理:QQ端发送指令“@OpenClaw 列出当前已安装的技能”“@OpenClaw 安装网页抓取技能”,可远程管理OpenClaw技能,无需登录Web控制台;
- 问题反馈:发送指令“@OpenClaw 查看最近的错误日志”,可快速排查QQ对接、指令执行中的问题;若机器人无响应,可发送“@OpenClaw 重启插件”,尝试重启QQ插件。
3. 成本控制技巧(新手必看,避免额外费用)
- 服务器成本:按需付费用户,长期不使用时,进入阿里云实例管理页面,点击“停止实例”,停止后不产生租赁费用,后续可随时启动;长期使用建议选择“包年包月”,性价比更高;新手避免过度升级实例规格,先使用2核2G测试,不够用再弹性升级(无需重新部署);
- 模型调用成本:优先使用阿里云百炼免费额度,简单任务用轻量模型(如qwen-plus),复杂任务用通义千问3-Max,避免滥用高成本模型;登录百炼控制台,设置每月最大消费限额(新手建议50元/月),避免超额费用;启用缓存功能,节省重复查询成本;
- 资源优化:若OpenClaw执行复杂任务(如多线程网页抓取、大量文档生成)时卡顿,可通过阿里云控制台弹性升级服务器配置(如2核2G升级为2核4G),或执行性能优化命令,无需重新部署与对接;定期清理服务器日志,释放存储空间;
- 免费资源:关注阿里云新手优惠,定期领取轻量应用服务器、百炼免费额度;OpenClaw开源免费,QQ对接无需付费,最大化降低使用成本。
4. 安全防护建议(避免凭证泄露、服务异常)
- 凭证保护:定期更换服务器密码、阿里云百炼API-Key、OpenClaw访问Token、QQ机器人凭证(建议每3个月一次),不要随意分享,防止他人误操作、恶意调用;QQ机器人Token泄露后,需立即重置并更新OpenClaw配置;
- 端口限制:测试完成后,可将端口来源改为个人常用IP段或沙箱成员IP段,减少安全风险,避免无关人员访问OpenClaw Web控制台、篡改配置;
- 数据备份:定期备份OpenClaw配置文件、QQ机器人应用配置,执行以下命令备份OpenClaw配置:
# 备份OpenClaw配置文件(包含API-Key、QQ凭证等) cp /root/.openclaw/openclaw.json /root/.openclaw/openclaw_backup.json # 备份OpenClaw日志(排查问题用) cp -r /root/.openclaw/logs /root/.openclaw/logs_backup - 安全审计:定期执行以下命令,排查安全风险,确保服务正常运行:
openclaw security audit --deep # 检查QQ对接安全配置(可选) openclaw plugins check-security qqbot - 版本更新:定期升级OpenClaw至最新版本、QQ插件至最新版本,修复已知bug、提升安全性、优化QQ适配性,执行openclaw update、openclaw plugins update qqbot命令即可完成升级,升级前建议备份配置文件。
七、常见问题排查(90%问题可解决,新手无需联系客服)
新手在部署OpenClaw、对接QQ的过程中,可能会遇到一些小问题,无需慌张,以下是最常见的10个问题,附上具体解决方案,覆盖部署失败、服务异常、QQ对接失效等核心场景,兼顾阿里云、OpenClaw、QQ的适配特点,新手可对照排查,快速解决问题,同时可通过相关命令查看日志定位问题。
问题1:远程连接服务器失败,提示“连接超时”
- 症状:使用FinalShell连接服务器,提示“连接超时”“无法连接到主机”;
- 原因:① 服务器实例未启动;② 22端口未放通;③ 公网IP输入错误;④ 服务器地域网络异常;⑤ 国内地域未完成ICP备案;
- 解决方案:
- 回到阿里云实例管理页面,确认实例状态为“运行中”,若为“已停止”,点击“启动实例”;
- 检查防火墙规则,确保22端口已放通(TCP协议,来源0.0.0.0/0);
- 核对服务器公网IP,避免拼写错误,可在实例管理页面重新复制;
- 若为国内地域服务器,检查是否已完成ICP备案(未备案无法远程连接),新手推荐选择。