2026年保姆级教程：阿里云部署OpenClaw（Clawdbot）+接入QQ指南

在2026年AI自动化办公与社交协同深度融合的时代，OpenClaw（原Clawdbot，曾用名Moltbot）作为阿里云生态下开源的轻量级AI自动化代理工具，凭借自然语言交互、全场景任务自动化、插件化扩展的核心优势，成为个人办公提效、轻量团队协同、私域服务升级的优选工具。与传统聊天机器人不同，OpenClaw并非单纯的对话助手，而是能实现“需求解析-任务规划-工具调用-结果反馈”的完整自动化系统，可轻松完成文档生成、日程管理、网页抓取、多工具协同、信息汇总等实操任务，真正实现解放双手、提升协作与服务效率的核心需求。

QQ作为国民级社交与协同工具，覆盖个人聊天、群聊协作、频道互动、文件传输等全场景，用户基数庞大、操作门槛极低。将OpenClaw与QQ无缝集成后，可打造“24小时值守的AI智能助手”——无需切换工具，在QQ单聊、群聊、频道中直接@机器人即可下达自动化指令，实现指令实时响应、任务自动执行、结果快速反馈，适配个人办公、团队协同、私域客户服务、社群管理等各类场景，兼顾实用性与便捷性，无需任何技术基础，小白也能快速落地使用，详情 访问阿里云OpenClaw一键部署专题页面 了解。

本文以零基础小白视角，结合2026年阿里云最新操作界面、OpenClaw（Clawdbot）最新稳定版本（stable-2026.02）及QQ开放平台最新规则，整合全网最细致的实操步骤与搜索资料，全程拆解“阿里云部署OpenClaw”+“OpenClaw接入QQ”两大核心流程，包含前置准备、服务器配置、部署实操、代码命令、接入配置、功能验证、避坑指南及后续维护。所有代码均可直接复制粘贴，无需手动编写，确保每一位小白都能跟着操作、一次落地成功，同时兼顾实用性与可操作性，适配个人、轻量团队及中小企业的使用需求，全程贴合2026年最新技术规范与平台规则。

一、前置准备（保姆级自查，缺一不可，全程免费/低成本）

在正式开始部署和接入操作前，我们需要完成4项核心准备工作，分别是阿里云相关账号与服务开通、QQ相关权限与机器人创建、必备工具安装、核心凭证获取。所有准备工作均为小白友好型，无需任何技术基础，全程耗时约15-20分钟，每一步都有详细指引，确保不遗漏关键环节，为后续部署和接入扫清障碍，同时结合QQ开放平台2026年最新要求，补充沙箱配置、IP白名单等关键前置操作，避免后续接入失败。

（一）阿里云账号与服务开通（部署核心前提）

OpenClaw的部署依赖阿里云服务器（轻量应用服务器/ECS均可，小白首选轻量应用服务器，操作更简洁），同时需要开通阿里云百炼大模型服务（为OpenClaw提供AI能力支持），具体操作步骤如下，全程贴合阿里云2026年最新界面与权限要求：

1. 阿里云账号注册与实名认证：
   • 注册并登录阿里云账号，点击右上角“注册”按钮，选择“个人账号注册”，通过手机号或邮箱完成注册（推荐手机号，更便捷），设置登录密码后，即可完成账号注册。
   • 实名认证操作：注册完成后，自动跳转至阿里云控制台首页，右上角会提示“未实名认证”，点击提示进入实名认证页面。小白优先选择“个人实名认证”（企业用户可选择企业认证），认证方式支持“身份证认证”“人脸识别认证”，推荐人脸识别认证，全程5分钟内可完成。
   • 操作细节：上传身份证正反面照片（确保清晰、无遮挡），然后进行人脸识别，跟随系统提示完成点头、眨眼等动作，验证通过后，等待1-2分钟，实名认证即可生效。实名认证是使用阿里云所有服务的前提，未认证账号无法创建服务器实例、开通百炼服务，同时无法获取API-Key用于OpenClaw的AI能力激活。
2. 核心服务权限开通：
   • 实名认证完成后，返回阿里云控制台，在顶部搜索框依次搜索“轻量应用服务器”“阿里云百炼”“AppFlow”（用于OpenClaw与QQ对接，后续接入环节需用到，可实现无代码对接，小白首选），点击进入对应服务页面，点击“立即开通”，三项服务均为免费开通，无需提前缴费（后续仅需支付轻量服务器的租赁费用，测试阶段可选择按需付费，成本极低）。
3. 账号欠费检查与资源准备：
   • 进入阿里云“费用中心”，查看账号余额，确保无欠费记录（若欠费，可充值少量金额用于测试，后续可按需续费或退订），避免因欠费导致服务器创建失败、服务中断，影响部署流程。
   • 提前了解阿里云百炼API-Key的两种计费模式：按Token用量计费、Coding Plan套餐专属API Key（固定月费，提供月度请求额度，可避免超出预期费用），小白可根据自身需求选择，测试阶段推荐按Token用量计费，成本更可控。

（二）QQ相关权限与机器人创建（接入核心前提）

要实现OpenClaw与QQ的接入，需要提前在QQ开放平台创建机器人应用、获取对接凭证，同时确保拥有实名认证的QQ账号与QQ开放平台账号，具体操作步骤如下，严格遵循QQ开放平台2026年最新规则（重点补充沙箱配置、IP白名单等关键步骤，小白易遗漏）：

1. QQ相关账号准备：
   • QQ账号：需准备完成实名认证的QQ账号（未认证账号无法通过QQ开放平台审核，无法创建机器人），建议使用常用QQ账号，便于后续测试与管理。
   • QQ开放平台账号注册：访问QQ开放平台官网（https://q.qq.com/），点击右上角“立即注册”，完成账号注册（QQ开放平台账号与QQ账号独立，需单独注册，注册后可绑定QQ账号用于扫码登录）。注册完成后，需完成主体实名认证（个人主体上传身份证正反面，企业主体上传营业执照），审核1-2个工作日即可通过，审核通过后才可创建机器人。
2. QQ机器人创建（获取AppID/ AppSecret/ Token，核心凭证）：
   • 登录QQ开放平台，点击顶部“机器人”模块，进入机器人管理页面，点击“创建机器人”，填写机器人基础信息：机器人名称（自定义，如“OpenClaw-AI助手”）、机器人简介（如“阿里云OpenClaw对接QQ，实现自动化办公、信息查询等功能”）、上传机器人头像（建议240×240px以上，无圆角，可自定义或使用OpenClaw官方图标），选择主体类型（个人/企业，与实名认证一致），点击“创建”完成机器人创建。
   • 机器人创建完成后，进入机器人详情管理页面，点击左侧导航栏“开发→开发管理”，记录“AppID”（机器人ID）和“AppSecret”（机器人密钥）——重点提醒：AppSecret首次查看需点击“生成”，并通过管理员QQ扫码验证，生成后仅显示一次，务必保存至文本编辑工具中，后续遗忘需重新生成；同时生成机器人Token（格式通常为“AppID:AppSecret”），同样保存至文本编辑工具，这三类凭证是OpenClaw与QQ对接的核心，切勿泄露，避免机器人被滥用。
3. QQ机器人权限配置与沙箱设置（2026年最新要求，必做）：
   • 权限配置：在机器人详情页面，点击左侧导航栏“权限管理”，找到并开启以下核心权限（缺一不可，未开启权限会导致无法接收/发送消息、无法执行指令）：
     • 消息相关权限：im:message（消息发送/接收权限）、im:chat（群聊/频道访问权限）、im:message.group_at_msg:readonly（群聊@消息读取权限）、im:message.p2p_msg:readonly（单聊消息读取权限）；
     • 机器人相关权限：bot:chat:send（机器人发送消息权限）、bot:chat:receive（机器人接收消息权限）；
     • 可选权限：docs:document.content:read（文档内容读取权限）、file:upload（文件上传权限），用于实现文档解析、文件传输等进阶功能。
   • 沙箱配置（2026年QQ开放平台强制要求，测试必备）：点击左侧导航栏“开发→沙箱配置”，在消息列表配置中点击“添加成员”，输入个人QQ账号（仅沙箱成员可测试机器人，2026年1月31日后暂不支持添加QQ群ID，仅支持频道与私聊测试）；打开手机QQ，创建一个自定义频道（如“OpenClaw测试频道”），返回沙箱配置页面，选择该频道完成绑定，确保机器人可接收频道消息，未配置沙箱将无法测试机器人功能。
4. IP白名单配置（提前设置，避免对接失败）：
   • 在机器人详情页面，点击左侧导航栏“开发→开发管理”，找到“IP白名单”模块，点击“编辑”，将后续创建的阿里云服务器公网IP添加到白名单中（格式：47.xxx.xxx.xxx/32），同时可添加阿里云AppFlow相关常用IP（121.40.82.220、47.97.73.42等，可直接复制添加），点击“保存”，避免非授权IP访问导致机器人无法响应。

（三）必备工具安装（本地设备操作，全部免费）

部署和接入过程中，我们需要使用4款核心工具，分别用于远程连接服务器、执行代码命令、编辑配置文件、抓取凭证信息，小白可根据自己的本地设备（Windows、Mac、Linux）选择对应版本安装，全程下一步即可完成，无需复杂配置，同时结合2026年最新工具版本，确保兼容性：

1. 远程连接工具：FinalShell（跨平台，Windows/Mac/Linux通用，最新版本）
   • 推荐小白使用FinalShell，跨平台适配，操作更简洁，无需额外配置密钥，根据自己的本地设备系统选择对应版本（如Windows 64位、MacOS），下载完成后双击安装，全程默认下一步即可，安装完成后无需启动，后续部署时再使用。若使用Xshell等其他SSH工具，操作流程一致，可自行选择。
2. 文本编辑工具：Notepad++（Windows）、TextEdit（Mac默认自带）
   • 用于保存核心凭证（如阿里云百炼API-Key、QQ机器人AppID/AppSecret/Token、服务器密码）、编辑配置文件，避免因系统自带记事本格式错乱导致配置失败。Windows用户可在官网（https://notepad-plus-plus.org/downloads/）下载Notepad++最新版本，安装后默认即可使用；Mac用户直接使用自带的TextEdit，打开后选择“纯文本模式”即可，避免格式错乱。
3. 浏览器：推荐Chrome、Edge浏览器（最新版本）
   • 用于访问阿里云控制台、QQ开放平台、OpenClaw官方文档、下载相关依赖，避免因浏览器兼容问题导致操作异常（如旧版浏览器可能无法正常显示QQ开放平台的沙箱配置界面、阿里云控制台的应用详情页面），同时确保浏览器可正常访问GitHub、阿里云镜像源，避免后续插件安装、源码下载失败。
4. 辅助工具：微信截图、QQ截图（默认自带）、手机QQ（最新版本）
   • 截图工具：用于抓取服务器公网IP、凭证信息（如API-Key、AppID），方便后续复制粘贴，避免手动输入出错；
   • 手机QQ：用于QQ开放平台的扫码验证、机器人沙箱测试、机器人配对授权，必须安装最新版本，否则可能无法完成沙箱绑定、指令测试等操作。

（四）核心凭证获取（关键！部署+接入必用，妥善保存）

核心凭证主要包括阿里云百炼API-Key（用于激活OpenClaw的AI能力）、QQ机器人AppID/AppSecret/Token（用于OpenClaw与QQ对接），这两类凭证缺一不可，具体获取步骤如下（QQ机器人凭证已在前面获取，此处重点说明阿里云百炼API-Key获取，结合2026年最新获取流程）：

1. 阿里云百炼API-Key获取（核心，部署必用）：
   • OpenClaw本身不具备独立的大语言模型推理能力，需对接阿里云百炼大模型平台，通过API-Key获取授权，调用通义千问系列模型（如qwen3-max、qwen-plus，2026年推荐使用qwen3-max-2026-01-23版本，兼容性最佳），才能实现自然语言理解与自动化任务执行。
   • 具体步骤：访问阿里云百炼大模型服务平台，使用刚刚完成实名认证的阿里云账号登录；登录后，点击左侧导航栏“密钥管理”，进入密钥管理页面，点击右上角“创建API-Key”；在弹出的窗口中，输入API-Key名称（自定义，如“OpenClaw-API”），选择计费模式（按Token用量/ Coding Plan），无需修改其他配置，点击“确定”；系统会自动生成一组API-Key（包含Access Key ID和Access Key Secret），点击“复制”按钮，将两组密钥粘贴到Notepad++/TextEdit中保存，切勿泄露给他人（否则可能导致AI能力被滥用、产生不必要的费用），后续部署时会频繁使用。
   • 补充说明：若选择Coding Plan套餐专属API Key，需确保该API Key仅支持抵扣qwen3-max-2026-01-23和qwen3-coder-plus模型调用费用，不支持多模态模型，小白测试阶段可优先选择按Token用量计费。

（五）前置准备检查清单（小白自查，避免遗漏）

1. 阿里云账号已完成实名认证，且开通“轻量应用服务器”“阿里云百炼”“AppFlow”三项服务，账号无欠费，已获取阿里云百炼API-Key（Access Key ID和Access Key Secret）。
2. 已完成QQ开放平台账号注册与主体实名认证，创建QQ机器人并获取App ID、App Secret、Token，开启核心权限，完成沙箱配置与IP白名单设置（暂留服务器公网IP填写位置）。
3. 本地设备已安装FinalShell（或Xshell）、Notepad++（或TextEdit），浏览器已更新至最新版本，截图工具可正常使用，手机QQ已安装最新版本并登录。
4. 所有核心凭证（阿里云百炼API-Key、QQ机器人AppID/AppSecret/Token）均已保存至文本编辑工具中，无遗漏、无错误。
5. 确保本地设备网络通畅，可正常访问阿里云官网、QQ开放平台、GitHub（用于下载OpenClaw相关插件，国内用户可通过阿里云镜像源规避访问限制）。

（五）阿里云一键部署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对话页面。

二、阿里云OpenClaw（Clawdbot）部署简单步骤（保姆级实操，小白全程复制粘贴）

完成前置准备后，正式进入OpenClaw部署环节，这是本文的核心内容之一。考虑到小白零基础，我们优先选择“阿里云轻量应用服务器+OpenClaw专属镜像”的部署方案——阿里云已预置OpenClaw专属应用镜像，集成了Node.js、Python、Docker等所有依赖，无需手动配置环境，全程可视化操作+少量代码复制粘贴，简化部署流程，小白可在10-15分钟内完成部署，贴合2026年阿里云最新一键部署规范。

同时，本文也补充了“手动部署方案”（适合已有服务器、不想使用专属镜像的用户），两种方案均可实现部署，小白首选专属镜像部署方案，省时省力。全程分为5个简单步骤，每一步都有详细说明和代码命令，确保不出错，同时补充环境预检、版本验证等关键步骤，避免部署中途失败。

（一）方案一：小白首选——轻量应用服务器+专属镜像一键部署（最简单，推荐）

步骤1：购买阿里云轻量应用服务器（高性价比配置，小白直接照搬）

1. 访问阿里云轻量应用服务器控制台，点击右上角“创建服务器”，进入服务器购买页面；也可直接访问阿里云OpenClaw一键部署专题页面，点击“一键购买并部署”，直接跳转至配置界面，更便捷，无需手动选择镜像。
2. 根据页面提示完成资源配置，具体配置项说明如下（小白直接照搬，无需修改，兼顾流畅度与低成本，结合2026年最新配置推荐）：

1. 配置完成后，点击页面底部“立即购买”，进入支付页面，选择支付方式（支付宝、微信均可），完成支付后，返回轻量应用服务器控制台，等待3-5分钟，服务器状态由“准备中”变为“运行中”，此时轻量服务器实例创建成功，同时OpenClaw专属镜像已自动部署完成，后续仅需完成简单配置（API-Key、Token）即可使用。

步骤2：服务器基础配置（端口放行+密码重置，必做）

服务器创建成功后，需要完成两项基础配置：重置登录密码（用于远程连接服务器，后续调试、维护需用到）、放行OpenClaw核心端口（用于OpenClaw服务访问、与QQ对接），具体操作步骤如下，结合2026年阿里云服务器最新防火墙配置规则：

1. 重置服务器登录密码（核心，远程连接必备）：

   • 在轻量应用服务器控制台，找到刚刚创建的服务器实例，点击实例名称，进入实例详情页面。
   • 点击左侧导航栏“重置密码”，进入密码重置页面，输入新密码（建议设置复杂密码，包含大小写字母、数字、特殊符号，如Abc123!@#），确认密码后，点击“确定”。
   • 系统会提示“重置密码成功，需重启服务器生效”，点击页面提示的“重启服务器”，等待2-3分钟，服务器重启完成后，新密码即可生效，将密码保存至Notepad++/TextEdit中，后续远程连接服务器时需要使用，切勿忘记。

2. 放行OpenClaw核心端口（18789端口，必做，对接QQ关键）：

   • OpenClaw服务默认使用18789端口，同时该端口也是与QQ对接的核心通信端口，若未放行该端口，后续将无法访问OpenClaw控制台，也无法实现与QQ的对接，需同时配置服务器内部防火墙和阿里云控制台防火墙，具体操作如下，两步缺一不可：
   • （1）阿里云控制台防火墙配置（放行端口）：在服务器实例详情页面，点击左侧导航栏“防火墙”，进入防火墙配置页面；点击“添加规则”，在弹出的窗口中，按以下配置填写：端口范围：18789（OpenClaw核心端口，不可修改）；协议：TCP（默认即可）；授权对象：0.0.0.0/0（允许所有IP访问，小白首选，测试阶段便捷；若需提高安全性，可填写自己本地设备的公网IP或企业IP段，同时添加QQ开放平台相关IP）；备注：自定义（如“OpenClaw核心端口，用于对接QQ机器人”）；填写完成后，点击“确定”，即可完成端口放行，此时防火墙规则列表中会显示“18789/TCP”，状态为“已放行”。小白也可点击“一键放通”按钮，自动配置端口放行规则，更便捷。
   • （2）服务器内部防火墙配置（补充放行，避免端口被拦截）：后续远程连接服务器后，需执行代码命令放行内部防火墙端口，此处先提前说明代码，后续远程连接后直接复制粘贴即可，无需手动编写，适配Alibaba Cloud Linux系统：

     # 1. 查看服务器内部防火墙状态（Alibaba Cloud Linux系统默认使用firewalld）
     systemctl status firewalld
     # 2. 放行18789/TCP端口（永久放行，重启服务器后仍生效）
     firewall-cmd --add-port=18789/tcp --permanent
     # 3. 放行80端口（备用，用于QQ回调配置，可选但推荐）
     firewall-cmd --add-port=80/tcp --permanent
     # 4. 重新加载防火墙规则，使端口放行生效
     firewall-cmd --reload
     # 5. 验证端口是否放行成功（输出18789/tcp、80/tcp即为成功）
     firewall-cmd --list-ports | grep -E "18789|80"
     

步骤3：远程连接服务器，完成OpenClaw核心配置（API-Key+Token）

1. 远程连接服务器：

   • 打开本地设备安装的FinalShell工具，首次打开会提示“新建连接”，点击“新建”，选择“SSH连接”。
   • 在弹出的连接配置窗口中，按以下信息填写（信息均来自服务器实例详情页面和之前保存的文本工具）：
     • 名称：自定义（如“OpenClaw服务器-QQ对接”）
     • 主机：填写服务器的“公网IP”（在实例详情页面顶部，如47.xxx.xxx.xxx，复制完整IP，无多余空格）
     • 端口：22（默认端口，无需修改，若修改过默认端口，需填写对应端口）
     • 用户名：root（阿里云轻量服务器默认登录用户名，不可修改）
     • 密码：填写之前重置的服务器登录密码（保存至文本工具中的密码）
   • 填写完成后，点击“确定”，然后在FinalShell左侧“会话管理”中，找到刚刚创建的连接，双击连接，弹出“是否信任此主机”提示，点击“信任”，等待1-2秒，即可成功连接到服务器（连接成功后，终端会显示“[root@xxx ~]#”，表示已进入服务器命令行界面）。若连接失败，检查公网IP、密码是否正确，或服务器是否已重启生效。

2. 执行环境预检脚本（避免部署中途出错，小白必做）：

   • 连接成功后，复制粘贴以下代码，执行OpenClaw专属环境预检脚本，检查服务器是否满足部署条件（系统版本、内存、端口、网络等），有问题提前修复，避免后续配置出错，2026年最新预检脚本，适配OpenClaw stable-2026.02版本：

     # 执行2026版OpenClaw环境预检脚本（直接复制回车，无需修改）
     curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/aliyun_precheck.sh | bash
     

   • 预检通过会显示以下结果（有(×)需先修复，再进行下一步，修复方法脚本会自动提示）：
     • (√) 系统版本适配：Alibaba Cloud Linux 3.2104 LTS 64位
     • (√) 内存/存储满足要求：2核2GB/40GB ESSD
     • (√) 18789端口未被占用（OpenClaw默认Web服务端口）
     • (√) 外网访问正常，可连接阿里云百炼API、QQ开放平台
     • (√) 服务器地域与百炼API-Key地域匹配
     • (√) 核心依赖（Node.js、Python、Docker）已预装完成

3. 配置阿里云百炼API-Key（激活OpenClaw AI能力，必做）：

   • 这一步是核心，若未配置API-Key，OpenClaw将无法使用AI自动化功能，也无法响应QQ指令，全程代码复制粘贴，无需手动编写配置文件，小白可轻松操作：
   • 首先执行以下代码，进入OpenClaw配置目录（专属镜像已默认创建该目录，无需手动创建）：

     # 进入OpenClaw配置目录
     cd /root/.openclaw
     # 编辑配置文件（使用nano编辑器，小白友好，无需复杂操作）
     nano config.json
     

   • 打开配置文件后，找到“models.providers.bailian”节点，将之前获取的阿里云百炼API-Key（Access Key ID和Access Key Secret）填写到对应位置，修改后的内容如下（替换括号内的内容，保留双引号，不要删除任何原有符号，避免配置出错）：

     "models": {
            
     "providers": {
            
     "bailian": {
            
     "accessKeyId": "你的阿里云百炼Access Key ID",
     "accessKeySecret": "你的阿里云百炼Access Key Secret",
     "defaultModel": "bailian/qwen3-max-2026-01-23" // 2026年推荐默认模型
     }
     },
     "default": "bailian/qwen3-max-2026-01-23"
     }
     

   • 填写完成后，按“Ctrl+O”保存配置（输入O，不是0），按“Ctrl+X”退出编辑器，返回终端界面。
   • 执行以下代码，重启OpenClaw服务，使API-Key配置生效，同时查看服务状态，确保服务正常运行：

     # 重启OpenClaw服务（专属镜像默认已安装服务，直接执行命令即可）
     systemctl restart openclaw
     # 查看OpenClaw服务状态（输出active(running)即为正常，若为errored需排查问题）
     systemctl status openclaw
     

   • 补充说明：若查看服务状态显示异常，大概率是API-Key填写错误，可重新进入配置文件修改，再次重启服务即可。

4. 获取OpenClaw访问Token（登录控制台、对接QQ必用）：

   • Token是OpenClaw控制台登录的核心凭证，同时也是与QQ对接时的身份验证凭证，执行以下代码，获取Token并保存，无需手动生成，专属镜像会自动生成Token：

     # 生成并查看OpenClaw访问Token（核心命令，直接复制执行）
     cat /root/.openclaw/config.json | grep token
     # 示例输出："token": "abcdef1234567890abcdef1234567890"（复制该token，不含双引号）
     

   • 将生成的Token复制到Notepad++/TextEdit中保存，后续登录OpenClaw控制台、配置QQ对接时会用到，切勿泄露，若不慎泄露，可执行以下代码重新生成Token：

     # 重新生成OpenClaw访问Token（泄露后必做）
     openclaw token regenerate
     # 查看新Token
     cat /root/.openclaw/config.json | grep token
     

步骤4：访问OpenClaw控制台，验证部署是否成功

1. 保持FinalShell终端连接（无需关闭），打开本地设备的Chrome/Edge浏览器，在地址栏输入：http://服务器公网IP:18789（替换为自己服务器的公网IP，如http://47.xxx.xxx.xxx:18789），按下回车键，进入OpenClaw登录页面（2026年汉化版界面，小白可轻松操作）。
2. 在登录页面的“Token输入框”中，粘贴之前获取的OpenClaw访问Token，点击“登录”，即可成功进入OpenClaw控制台，控制台左侧为对话窗口，右侧为功能配置模块，小白无需额外配置，默认即可使用。
3. 部署验证（小白必做，确保部署成功）：
   • 进入控制台后，在左侧对话窗口中，输入以下指令（任意一条均可），测试AI能力是否正常，验证部署是否成功：
     • 指令1：“帮我生成一份简单的周工作计划，包含工作目标、每日任务、总结要求”
     • 指令2：“帮我抓取阿里云官网的首页标题和核心服务介绍，整理成文本”
     • 指令3：“帮我编写一段Python代码，实现简单的数字求和功能，并解释代码含义”
     • 指令4：“帮我生成一段QQ群公告，主题为‘OpenClaw机器人测试通知’，50字左右”
   • 输入指令后，点击“发送”，等待1-3秒（取决于网络速度和AI响应速度），若OpenClaw能返回对应的结果（结构化的周工作计划、网页抓取内容、Python代码+解释或QQ群公告），说明部署完全成功，OpenClaw可正常使用所有功能；若返回“AI模型调用失败”，请检查API-Key是否配置正确，或重新执行“systemctl restart openclaw”重启服务，再次测试。

步骤5：设置OpenClaw开机自启（长期使用必做）

为了确保服务器重启后，OpenClaw服务能自动启动，无需手动重启（避免影响QQ机器人响应），执行以下代码，设置开机自启，后续服务器重启后，OpenClaw会自动运行，无需手动操作：

# 设置OpenClaw开机自启（核心命令）
systemctl enable openclaw
# 验证开机自启设置是否成功（输出enabled即为成功，disabled为失败）
systemctl is-enabled openclaw

- 补充说明：若验证失败，重新执行设置开机自启的命令，确保命令输入正确，无多余空格。

（二）方案二：手动部署方案（适合已有服务器、不想使用专属镜像的用户）

若你已有阿里云轻量应用服务器/ECS，且不想使用OpenClaw专属镜像，可选择手动部署方案，全程需手动安装依赖、克隆源码、配置环境，步骤稍繁琐，但小白可跟随代码复制粘贴完成，具体步骤如下（核心步骤，简化非必要环节，结合2026年最新手动部署流程，适配OpenClaw stable-2026.02版本）：

步骤1：远程连接服务器（同方案一步骤3-1，此处不再重复，确保连接成功）

步骤2：安装OpenClaw必备依赖（复制粘贴代码，一键安装，避免依赖缺失）

# 1. 更新系统依赖（避免依赖版本过低，导致安装失败，适配Alibaba Cloud Linux）
yum update -y --disablerepo=* --enablerepo=aliyunos,epel
yum install -y wget curl gcc gcc-c++ make

# 2. 安装Node.js（22.0.0版本，OpenClaw官方推荐，2026年最新兼容版本）
wget https://npmmirror.com/mirrors/node/v22.0.0/node-v22.0.0-linux-x64.tar.xz
tar -xvf node-v22.0.0-linux-x64.tar.xz
mv node-v22.0.0-linux-x64 /usr/local/node
echo "export PATH=/usr/local/node/bin:\$PATH" >> /etc/profile
source /etc/profile
node -v # 验证，输出版本号v22.0.0即为成功
npm -v # 验证，输出版本号≥10.5.0即为成功

# 3. 安装pnpm（包管理工具，OpenClaw官方推荐，替代npm，下载速度更快）
npm install -g pnpm@latest
pnpm -v # 验证，输出版本号≥9.0.0即为成功

# 4. 安装Git（用于克隆OpenClaw源码，国内用户使用阿里云镜像源）
yum install -y git
git --version # 验证，输出版本号≥2.0.0即为成功

# 5. 安装Docker（可选，容器化部署，推荐，便于后续维护和升级）
yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum install -y docker-ce docker-ce-cli containerd.io
systemctl start docker
systemctl enable docker
docker -v # 验证，输出版本号即为成功

# 6. 安装OpenClaw核心包（一键安装，简化操作，2026年最新版本）
pnpm add -g openclaw@latest
openclaw -v # 验证，输出版本号即为成功（需与stable-2026.02一致）

# 7. 放行18789端口和80端口（同方案一步骤2-2，必做）
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --add-port=80/tcp --permanent
firewall-cmd --reload
firewall-cmd --list-ports | grep -E "18789|80"

步骤3：初始化OpenClaw并配置API-Key（激活AI能力，核心步骤）

# 1. 初始化OpenClaw（启动安装向导，简化配置，小白友好）
openclaw onboard

# 2. 跟随向导提示，完成基础配置（无需手动输入，复制粘贴凭证即可）
# 步骤1：选择语言，输入1（中文），回车
# 步骤2：选择模型提供商，输入bailian（阿里云百炼），回车
# 步骤3：粘贴阿里云百炼Access Key ID和Access Key Secret，依次回车（粘贴后回车确认）
# 步骤4：设置默认模型，直接回车（默认bailian/qwen3-max-2026-01-23，无需修改）
# 步骤5：初始化完成，提示“OpenClaw初始化成功”，即可进入下一步

# 3. 启动OpenClaw服务（开发模式，用于测试，小白首选）
pnpm dev
# 若需后台启动（长期使用，推荐），执行以下命令：
# pnpm install -g pm2
# pm2 start src/index.js --name openclaw
# pm2 enable openclaw # 设置pm2开机自启，避免服务中断

步骤4：获取Token、验证部署（同方案一步骤3-4至步骤4，此处不再重复，确保能正常登录控制台、AI指令能正常响应）

（三）OpenClaw部署总结（小白必看）

两种部署方案均可实现OpenClaw的正常运行，小白首选“方案一：专属镜像一键部署”，省时省力，无需手动配置环境，全程可视化操作+少量代码，10-15分钟即可完成，适配2026年阿里云最新操作规范，成功率最高；已有服务器、不想使用专属镜像的用户，可选择“方案二：手动部署方案”，跟随代码复制粘贴，也能顺利完成部署，重点注意依赖安装和API-Key配置，避免出现依赖缺失、服务启动失败等问题。

部署成功后，OpenClaw已具备完整的AI自动化功能，后续仅需完成与QQ的接入，安装QQ插件、配置对接凭证，即可在QQ中调用OpenClaw的各项功能，实现办公自动化、社群管理自动化，真正解放双手、提升效率。

三、OpenClaw（Clawdbot）接入QQ保姆级步骤（核心环节，全程实操，贴合2026年最新规则）

完成OpenClaw部署后，正式进入核心接入环节——将OpenClaw与QQ对接，实现“QQ@机器人，即可下达自动化指令”的功能。本环节依托阿里云AppFlow服务（无需手动编写对接代码，小白友好），同时结合OpenClaw官方QQ插件（2026年最新版本），全程分为6个步骤，包含QQ机器人补充配置、OpenClaw QQ插件安装、AppFlow连接流创建、对接凭证配置、功能验证，每一步都有详细指引和代码命令，确保接入成功，同时补充代码调试方案（适合接入失败时排查问题），结合QQ开放平台2026年最新要求，重点解决沙箱测试、IP白名单、回调配置等核心问题。

步骤1：QQ机器人补充配置（接入前置，必做，完善对接基础）

1. 访问QQ开放平台（https://q.qq.com/），使用QQ开放平台账号登录，找到之前创建的“OpenClaw-AI助手”机器人，进入机器人详情管理页面。
2. 补充IP白名单（关键，之前未填写服务器公网IP的必做）：
   • 点击左侧导航栏“开发→开发管理”，找到“IP白名单”模块，点击“编辑”，将阿里云轻量服务器的公网IP添加到白名单中（格式：47.xxx.xxx.xxx/32），同时添加阿里云AppFlow相关常用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），点击“保存”，确保QQ机器人能正常接收来自OpenClaw服务器的请求，避免出现“机器人去火星了”的提示。
3. 配置回调地址（核心，OpenClaw与QQ通信的关键，2026年最新规则）：
   • 点击左侧导航栏“开发→开发管理”，找到“回调配置”模块，点击“编辑”，暂时不填写具体回调地址（后续从AppFlow中获取地址，此处先记住位置），同时开启“消息加密”（可选，提高安全性），记录加密密钥（若开启，后续配置需用到，小白可暂不开启，简化配置），回调模式选择“Webhook模式”，点击“保存”。
4. 完善沙箱配置（确保测试正常，2026年强制要求）：
   • 点击左侧导航栏“开发→沙箱配置”，确认已添加个人QQ账号为沙箱成员，已绑定测试频道；若未绑定，重新添加成员、创建频道并绑定，确保沙箱配置生效，未配置沙箱将无法测试机器人功能，QQ开放平台2026年已关闭未配置沙箱的机器人测试权限。
5. 发布QQ机器人（测试阶段，仅自己可见）：
   • 点击左侧导航栏“版本管理与发布”，点击“创建新版本”，填写版本号（如1.0.0）、版本描述（如“OpenClaw对接QQ测试，实现自动化指令执行”），选择可见范围（测试阶段选“仅自己可见”），点击“保存→直接发布”，等待5-10秒生效（未发布应用，无法接收消息，小白易遗漏此步骤），发布后无需审核，可直接用于测试。

步骤2：安装OpenClaw QQ插件（对接核心，必做，实现消息互通）

OpenClaw与QQ的对接需要依赖官方QQ插件，通过插件可快速实现消息互通、指令映射、机器人配对，无需手动编写对接代码，小白全程复制粘贴代码即可完成安装，适配2026年OpenClaw最新版本，同时提供阿里云镜像源，避免插件下载失败：

# 远程连接阿里云轻量服务器（FinalShell已连接可直接执行）
# 1. 进入OpenClaw配置目录（确保目录正确）
cd /root/.openclaw

# 2. 更换OpenClaw插件镜像源（国内用户必做，避免下载缓慢、安装失败）
openclaw config set plugins.registry https://mirror.aliyun.com/npm/@openclaw/

# 3. 安装OpenClaw QQ官方插件（2026年最新版本，适配QQ开放平台新规）
openclaw plugins install @openclaw/qq

# 4. 验证插件安装是否成功（输出版本号即为成功，如1.0.2）
openclaw plugins list | grep qq

# 5. 启动OpenClaw网关（用于与QQ长连接通信，必做，对接核心）
openclaw gateway start

# 6. 查看网关运行状态（输出running即为正常，若为stopped需重启）
openclaw gateway status

# 7. 若网关启动失败，执行以下命令重启（排查问题）
openclaw gateway restart

• 补充说明：若插件安装失败，提示“网络超时”“依赖缺失”，可执行以下命令重新安装，确保网络通畅，同时检查Node.js版本是否为22.0.0：

  # 卸载已安装的QQ插件（失败后必做）
  openclaw plugins uninstall @openclaw/qq
  # 重新安装QQ插件（强制安装，解决依赖缺失问题）
  openclaw plugins install @openclaw/qq --force
  

步骤3：创建阿里云AppFlow连接流（无需写代码，小白首选，实现无代码对接）

阿里云AppFlow是一款无代码集成工具，可快速实现OpenClaw与QQ的对接，无需手动编写对接代码，小白全程可视化操作，贴合2026年阿里云AppFlow最新界面与配置规则，具体步骤如下：

1. 登录阿里云控制台，搜索“AppFlow”，进入AppFlow工作台（https://appflow.aliyun.com/），点击右上角“创建连接流”，进入连接流创建页面。
2. 配置连接流基础信息：
   • 连接流名称：自定义（如“OpenClaw-QQ对接连接流”）
   • 描述：自定义（如“实现OpenClaw与QQ的消息互通，接收QQ指令，返回执行结果”）
   • 触发方式：选择“Webhook触发”（QQ发送消息后，通过Webhook触发OpenClaw执行指令），点击“下一步”。
3. 配置Webhook触发（获取回调地址，用于QQ机器人配置）：
   • 系统会自动生成一个Webhook URL（格式：https://xxxxx.appflow.aliyunnest.com/webhook/xxxxxxxxx），点击“复制”按钮，将该URL保存至文本编辑工具中（这就是QQ机器人中需要填写的“回调地址”），点击“下一步”，不要关闭当前页面。
4. 添加执行动作（对接OpenClaw，核心步骤）：
   • 点击“添加执行动作”，在搜索框中搜索“OpenClaw”，选择“OpenClaw 执行指令”动作（阿里云官方预置，无需手动添加，适配2026年最新版本），点击“下一步”。
5. 配置OpenClaw连接凭证（确保对接成功）：
   • 在弹出的配置窗口中，填写以下信息（均来自之前保存的凭证，复制粘贴，避免出错）：
     • 连接名称：自定义（如“OpenClaw连接”）
     • 服务器地址：http://阿里云轻量服务器公网IP:18789（如http://47.xxx.xxx.xxx:18789，复制完整地址，无多余空格）
     • Token：填写之前获取的OpenClaw访问Token
   • 填写完成后，点击“测试连接”，若提示“连接成功”，说明OpenClaw与AppFlow已成功对接；若提示“连接失败”，请检查服务器地址、Token是否正确，或OpenClaw服务、网关是否正常运行（执行“systemctl status openclaw”“openclaw gateway status”验证），修复后重新测试。
6. 配置指令映射（QQ消息转OpenClaw指令，小白默认配置即可）：
   • 测试连接成功后，点击“下一步”，进入指令映射配置页面，设置“QQ消息→OpenClaw指令”的映射规则（小白默认配置即可，无需修改，确保指令能正常传递）：
     • 指令来源：选择“Webhook请求参数”
     • 指令内容：填写“${webhook.body.text}”（表示将QQ发送的消息内容，直接作为OpenClaw的指令，支持自然语言指令，无需特殊格式）
   • 配置完成后，点击“下一步”，进入结果返回配置页面，设置“OpenClaw执行结果→QQ消息”的返回规则（默认配置即可，将执行结果直接返回给QQ，支持文本、卡片两种返回格式，小白默认文本格式），点击“下一步”。
7. 保存并发布连接流（必做，确保配置生效）：
   • 核对所有配置无误后，点击“保存”，然后点击页面顶部“发布”按钮，选择“发布到生产环境”，等待3-5分钟，连接流发布成功，此时AppFlow对接配置已完成，可关闭AppFlow页面，返回QQ开放平台配置回调地址。

步骤4：完善QQ机器人与OpenClaw对接配置（闭环配置，必做，确保对接成功）

1. 配置QQ机器人回调地址（闭环关键，必做）：
   • 返回QQ开放平台，找到之前创建的机器人，进入“开发→开发管理→回调配置”页面，将之前从AppFlow中复制的Webhook URL粘贴到“回调地址”输入框中，若之前开启了“消息加密”，此处需填写对应的加密密钥，点击“保存”，确保QQ发送的消息能通过回调地址传递给OpenClaw。
2. 配置OpenClaw QQ凭证（核心，确保机器人能正常响应）：
   • 远程连接阿里云轻量服务器（FinalShell），执行以下代码，进入OpenClaw配置目录，编辑配置文件，添加QQ对接相关配置，粘贴QQ机器人凭证，实现OpenClaw与QQ的身份验证：

     # 进入OpenClaw配置目录
     cd /root/.openclaw
     # 编辑配置文件（nano编辑器，小白友好）
     nano config.json
     

   • 在配置文件中，添加以下QQ对接配置（放在config.json文件末尾，与其他节点同级），替换括号内的QQ机器人凭证信息（复制之前保存的AppID、AppSecret、Token，确保无错误）：

     "channels": {
            
     "qq": {
            
     "enabled": true,
     "accounts": {
            
     "main": {
            
       "appId": "你的QQ机器人AppID",
       "appSecret": "你的QQ机器人AppSecret",
       "token": "你的QQ机器人Token",
       "botName": "OpenClaw-AI助手", // 与QQ机器人名称一致
       "sandbox": true, // 测试阶段开启沙箱模式，正式发布后可改为false
       "allowPrivateChat": true, // 允许单聊，开启后可私聊机器人
       "allowGroupAt": true, // 允许群聊@机器人，开启后可在群聊中使用
       "replyType": "text" // 回复类型，可选text（文本）、card（卡片），小白默认text
     }
     },
     "webhookUrl": "你的AppFlow Webhook URL", // 复制之前保存的Webhook地址
     "timeout": 30000 // 超时时间，30秒，避免指令执行超时无响应
     }
     }
     

3. 保存配置并重启相关服务，使配置生效（必做，所有配置修改后均需重启）：

   # 保存配置后，重启OpenClaw服务（核心，确保QQ配置生效）
   systemctl restart openclaw
   # 重启OpenClaw网关（确保与QQ的长连接正常）
   openclaw gateway restart
   # 查看网关状态（确保为running，若为stopped需重新启动）
   openclaw gateway status
   # 查看OpenClaw服务状态（确保为active(running)）
   systemctl status openclaw
   # 重启AppFlow连接流（可选，若配置未生效，执行此操作）
   # 阿里云控制台AppFlow中，找到对应连接流，点击“重启”即可
   

4. QQ机器人配对授权（2026年最新要求，必做，避免无法响应）：
   • 打开手机QQ（最新版本），找到已发布的“OpenClaw-AI助手”机器人（在沙箱成员列表中），进入单聊窗口，发送任意一条测试消息（如“你好”“测试连接”），机器人会返回一个配对码（如“123456”，随机生成）。
   • 回到FinalShell终端，执行以下代码，批准配对，完成OpenClaw与QQ机器人的身份绑定，未完成配对将无法响应指令：

     # 批准QQ机器人配对（替换123456为实际配对码，复制执行）
     openclaw pairing approve qq 123456
     # 配对成功会提示：QQ pairing approved successfully（若提示失败，检查配对码是否正确）
     

步骤5：接入功能验证（小白必做，多场景测试，确保对接成功）

完成所有接入配置后，必须进行功能验证，确保QQ能正常发送指令、OpenClaw能正常响应并返回结果，结合2026年QQ开放平台最新规则（仅支持沙箱成员测试、频道测试），具体验证步骤如下（多场景测试，确保无异常）：

场景1：QQ单聊机器人，发送指令测试（最基础，必做）

1. 打开手机QQ/电脑QQ，找到沙箱中的“OpenClaw-AI助手”机器人，进入私聊窗口（若未找到，可在QQ搜索机器人名称，或通过沙箱配置页面的“添加机器人”扫码添加）。
2. 发送指令（任意一条OpenClaw支持的指令），例如：
   • 指令1：“帮我生成一份50字左右的工作日报，包含今日工作、明日计划”
   • 指令2：“帮我查询明天杭州的天气，整理成简洁文本”
   • 指令3：“帮我编写一段QQ群公告，主题为‘周末加班安排’”
   • 指令4：“帮我抓取阿里云官网的核心服务介绍，整理成3条关键信息”
3. 发送指令后，等待1-3秒，若机器人能正常返回对应结果（文本形式），说明私聊对接成功；若未响应，参考后续“避坑指南”排查问题（优先检查配对是否成功、服务是否正常运行）。

场景2：QQ频道@机器人，发送指令测试（2026年重点测试场景，必做）

1. 打开手机QQ/电脑QQ，进入之前绑定的测试频道（沙箱配置中绑定的频道），确保机器人已加入该频道（若未加入，在频道设置中添加机器人）。
2. 在频道聊天窗口中@机器人，发送指令，例如：“@OpenClaw-AI助手 帮我整理一份简单的团队周会纪要模板”。
3. 发送后，若机器人能正常返回周会纪要模板，说明频道对接成功；若出现“处理中”后无响应，或直接无反应，需排查配置问题（参考避坑指南，优先检查IP白名单、回调地址是否正确）。