2026年阿里云部署OpenClaw（Clawdbot）一键接入WhatsApp喂饭级教程

2026年，OpenClaw（前身为Clawdbot、Moltbot）凭借开源轻量化架构、跨平台无缝适配能力及强大的AI自动化执行功能，成为个人、跨境团队及中小企业搭建专属AI助手的首选工具。其核心优势在于无需复杂开发，即可快速对接WhatsApp等全球主流通信平台，实现“WhatsApp发送自然语言指令→阿里云服务器运行OpenClaw执行任务→结果实时反馈至WhatsApp”的闭环，适配跨境沟通、客户服务、远程协作、日常办公等多场景，彻底打破“AI工具与日常沟通脱节”的痛点。

WhatsApp作为全球覆盖最广的即时通信工具，拥有超20亿活跃用户，其简洁易用、跨终端同步、端到端加密的特性，成为个人与跨境团队沟通的核心载体。而阿里云作为国内领先的云计算服务商，提供OpenClaw专属一键部署方案，提前封装运行环境与核心依赖，配合稳定的海外节点算力支撑，彻底解决了“OpenClaw部署复杂、WhatsApp跨境通信不稳定、本地设备运行受限”等用户常见痛点。

此前，多数用户在部署OpenClaw并接入WhatsApp时，常因“阿里云服务器配置繁琐、OpenClaw环境依赖缺失、WhatsApp对接凭证获取困难、跨境网络通信异常、指令响应失败”等问题卡壳，即便有一定技术基础，也需花费数小时排查调试。本文整合阿里云官方最新部署规范、OpenClaw v2026.2.3稳定版特性、WhatsApp 2026年最新对接规则及多场景实测经验，重写优化全流程喂饭级教程，严格保留“阿里云部署OpenClaw+一键接入WhatsApp”的核心逻辑，剔除冗余技术细节，补充可直接复制的代码命令、新手避坑要点、凭证获取详解及高频问题排查方案，全程不含任何无关云厂商信息，同时新增阿里云OpenClaw（Clawdbot）快速部署步骤，确保无论是否有技术基础，都能跟着步骤逐一点击、复制命令，顺利完成部署与对接，一次上手、一次成功，全程不超过60分钟，详情 访问阿里云OpenClaw一键部署专题页面 了解。

需明确的是，OpenClaw、Clawdbot、Moltbot本质是同一套AI自动化系统，仅为品牌迭代后的名称差异——2025年11月最初命名为Clawd（因商标纠纷更名），2026年1月更名为Moltbot（因名称冷僻、域名被抢注再次更名），最终确定为OpenClaw，强调开源属性与核心标识，目前GitHub仓库已完成全面迁移，开发与部署需以“OpenClaw”为准，旧名相关命令（如clawdbot gateway run）仍可兼容使用，本文所有操作步骤、代码命令均适配三者，无需额外调整。2026年OpenClaw最新版本已内置WhatsApp官方对接插件，无需编写原生代码，无需申请复杂的WhatsApp Business API权限，通过简单的扫码绑定或凭证配置，即可实现WhatsApp消息收发、指令响应与任务执行，同时与阿里云轻量应用服务器、ECS云服务器、百炼大模型深度适配，进一步降低部署与使用门槛，尤其优化了跨境网络适配能力，确保阿里云海外节点与WhatsApp服务器的通信稳定，消息延迟控制在100ms以内。

一、核心认知：部署对接逻辑与核心优势

（一）整体操作逻辑（新手必懂，喂饭级解析）

本次“阿里云部署OpenClaw+一键接入WhatsApp”的核心逻辑是：以阿里云轻量应用服务器（或ECS云服务器，优先推荐海外节点）为运行载体，通过阿里云OpenClaw专属镜像一键部署，配置阿里云百炼API-Key激活AI推理与任务执行能力；随后在阿里云服务器中启动OpenClaw的WhatsApp对接功能，通过扫码绑定或凭证填写的方式，建立OpenClaw与WhatsApp账号的通信连接；最后通过WhatsApp发送测试指令，验证对接效果，实现“WhatsApp发指令→OpenClaw解析执行→结果实时反馈至WhatsApp”的全流程自动化，全程无需人工干预，适配WhatsApp全终端（手机端、网页端、桌面端）使用场景，无需占用本地设备资源。

（二）核心优势（为什么首选阿里云+OpenClaw+WhatsApp）

1. 零技术门槛，新手可直接抄作业：阿里云提供OpenClaw专属镜像，提前完成运行环境、核心依赖（Node.js 22+、Docker、Python 3.9、git等）的安装配置，一键部署无需手动调试依赖、解决版本冲突问题；OpenClaw已封装WhatsApp对接插件与核心通信逻辑，无需编写代码，无需申请复杂的API权限，通过扫码或简单命令即可完成绑定；全程步骤清晰，每一步均标注操作细节与复制命令，纯新手也能轻松上手，无需专业技术储备。
2. 跨境网络稳定，适配全球沟通场景：阿里云新加坡、美国硅谷、德国法兰克福、中国香港等海外/港澳台节点，直连WhatsApp全球服务器，优化跨境网络传输链路，避免国内网络访问受限、断连、延迟过高问题，消息延迟＜100ms，完美适配跨境团队沟通、海外客户服务、全球远程协作等场景，无论身处何地，都能通过WhatsApp快速调用OpenClaw的AI能力。
3. 云端稳定运行，无本地设备限制：阿里云云服务器具备24小时稳定运行、弹性伸缩、故障自动恢复的优势，确保OpenClaw全天候待命，避免本地设备关机、断网后AI助手无法使用；无需占用本地设备CPU、内存资源，即便本地手机、电脑关机，只要阿里云服务器正常运行，WhatsApp指令仍可正常接收、执行，结果实时反馈至WhatsApp聊天窗口，实现“随时随地调用AI”。
4. 安全可靠，保障信息与隐私安全：依托阿里云服务器的安全隔离、数据加密、日志审计等能力，结合WhatsApp本身的端到端加密特性，确保指令内容、执行结果、聊天记录的安全，避免敏感信息泄露；OpenClaw支持权限管控，可设置仅允许指定手机号发送指令触发AI响应，进一步保障使用安全，适配企业客户服务、私密办公等场景。
5. 成本可控，开源免费无额外费用：OpenClaw开源免费，无需支付软件授权费用，可永久使用核心功能，后续可免费升级版本、安装扩展插件；WhatsApp本身免费使用，对接OpenClaw无需额外付费；阿里云轻量应用服务器新用户月付低至9.9元，按需付费模式可灵活控制成本，长期不使用时可停止实例，避免资源浪费；新用户还可领取阿里云百炼免费模型调用额度（90天免费，超7000万tokens），足够前期测试与日常轻度使用，进一步降低初期使用成本。
6. 扩展性强，适配多场景需求：OpenClaw无缝对接阿里云百炼大模型、OSS存储等产品，可实现复杂指令解析、多模态任务执行、数据持久化存储；支持安装各类扩展插件（如文档生成、任务管理、翻译、文件转换、信息查询等），可根据个人、团队需求扩展AI助手功能，适配日常办公、客户服务、研发辅助、跨境翻译等多种场景，一站式解决多类重复性工作。
7. 交互便捷，贴合日常使用习惯：无需切换APP，直接在WhatsApp聊天窗口发送自然语言指令，即可调用OpenClaw的AI能力，无需学习新工具的操作逻辑，贴合大众日常聊天习惯；支持连续对话，OpenClaw可记忆上下文语境，后续指令无需重复说明背景，交互更流畅，提升使用体验。

（三）适用场景（看完明确是否需要部署）

1. 跨境团队协作：跨境办公、全球分布式团队，通过WhatsApp发送指令，让OpenClaw自动生成会议纪要、整理项目文档、同步任务进度、翻译多语言文本（适配多语言沟通场景），打破地域与语言壁垒，提升协作效率。
2. 海外客户服务：企业对接海外客户时，通过WhatsApp让OpenClaw自动回复客户常见问题、整理客户咨询记录、生成客户需求报告，减轻客服工作量，提升客户响应效率，适配外贸、跨境电商等行业。
3. 个人日常办公：通过WhatsApp发送指令，让OpenClaw生成文档、整理待办事项、设置日程提醒、查询信息（天气、汇率、资讯等）、转换文件格式，替代重复性手动工作，提升办公效率。
4. 研发与创业团队：小型研发、创业团队，无需投入成本开发专属AI助手，通过阿里云部署OpenClaw并对接WhatsApp，快速拥有专属AI工具，辅助生成代码、排查简单代码错误、整理技术文档，降低团队运营成本。
5. 生活服务场景：通过WhatsApp发送指令，让OpenClaw查询出行攻略、生成购物清单、计算账单、翻译外文，便捷解决日常生活中的各类需求，实现“聊天即调用AI”。

二、部署对接前必做准备（5分钟搞定，缺一不可）

（一）账号准备（全部需提前注册/登录，完成实名认证与权限配置）

1. 注册阿里云账号：打开阿里云官网，用手机号快速注册，登录后进入“账号中心”完成实名认证——个人用户可通过支付宝刷脸或身份证验证（即时生效），企业用户需上传营业执照及法人信息（审核1-3个工作日）。未完成实名认证的账号，无法购买云服务器、开通阿里云百炼服务，进而无法完成OpenClaw部署与API配置，同时需确保账号状态正常，无欠费、违规记录。
2. WhatsApp账号：拥有一个正常使用的WhatsApp账号，确保该账号已绑定手机号、可正常登录（手机端已登录，能接收验证码、正常发送/接收消息）；建议使用专用WhatsApp账号对接OpenClaw，避免个人聊天与AI指令混淆；若需用于企业客户服务，可使用WhatsApp Business账号，对接流程一致，功能无差异。
3. 补充说明：个人测试可使用个人WhatsApp账号，企业使用建议由管理员统一注册、管理WhatsApp账号与阿里云账号，确保权限可控，避免无关人员操作导致配置异常。

（二）设备与服务器准备（核心载体，缺一不可）

1. 阿里云服务器准备（新手首选轻量应用服务器，优先海外节点）：新手优先选择阿里云轻量应用服务器，操作简单、性价比高，核心配置参考如下（足够流畅运行OpenClaw并对接WhatsApp，无需额外升级）：

   • 实例规格：2vCPU + 2GiB内存 + 40GiB SSD存储（最低配置，可满足基础使用；复杂场景如多并发指令、大量文件生成，可升级至4vCPU+4GiB内存）；
   • 地域选择：优先选择海外/港澳台地域（美国硅谷、新加坡、中国香港、德国法兰克福等），免ICP备案，购买后可直接使用，且能正常直连WhatsApp服务器，避免跨境网络异常；国内用户若有合规备案需求，可选择华东1（杭州）、华北2（北京）等国内地域，但需完成ICP备案后才能正常公网访问，且可能需要额外配置网络才能访问WhatsApp，不推荐新手选择国内地域；
   • 系统镜像：选择“OpenClaw（原Clawdbot/Moltbot）官方镜像”（应用镜像分类下搜索即可），该镜像基于Alibaba Cloud Linux 3.2104 LTS 64位操作系统，来源于阿里云计算巢，已提前安装好OpenClaw及所有核心依赖（Node.js 22+、Docker、Python 3.9、git等），优化了跨境网络适配，2026年默认版本为v2026.2.3，兼容性更强、稳定性更高，无需手动配置环境。
   • 付费类型：新手推荐“按需付费”（测试阶段成本低，不用可随时停止实例，按实际使用时长计费），长期使用建议“包年包月”，海外节点年付性价比提升30%；
   • 密码设置：设置复杂登录密码（含大小写字母、数字、特殊字符），保存好密码与服务器公网IP（后续远程连接、配置对接需高频使用，切勿遗忘）。

   已有阿里云服务器的用户，无需重新购买，可通过“实例详情→重置系统”，选择OpenClaw官方镜像，重置前需备份服务器内重要数据（重置系统会清除系统盘所有数据）；使用阿里云ECS云服务器的用户，步骤与轻量应用服务器基本一致，仅服务器操作界面略有差异，可参考本文步骤执行，核心命令与配置完全通用。

2. 本地设备准备：需具备一台安装了最新版Chrome/Edge浏览器的电脑（Windows、macOS、Linux均可），用于登录阿里云控制台、完成服务器配置、远程连接服务器；安装SSH远程连接工具（推荐FinalShell，新手首选，可视化操作，免费易用，无需记住复杂命令），用于远程连接阿里云服务器，执行代码命令；准备一部已登录WhatsApp账号的手机（用于后续扫码绑定、测试指令发送与接收）；确保本地网络通畅，能够正常访问阿里云官网、WhatsApp（手机端），避免网络波动导致部署中断、对接失败。

（三）工具与凭证准备（重点，后续高频使用，提前准备好）

1. 远程连接工具：FinalShell（新手首选）、Xshell、Windows PowerShell、macOS终端（任选其一），用于远程连接阿里云服务器，执行代码命令、配置对接参数。
2. 浏览器：Chrome/Edge最新版，用于登录阿里云控制台、阿里云百炼控制台、OpenClaw Web控制台，完成服务器配置、API-Key获取、部署验证等操作。
3. 辅助工具：加密记事本（用于保存服务器公网IP、登录密码、阿里云百炼API-Key、OpenClaw访问Token等敏感凭证，避免丢失与泄露）、截图工具（用于记录部署过程中的关键参数与步骤，便于后续核对）、手机（已登录WhatsApp账号，用于扫码绑定与测试）。
4. 核心凭证（后续逐步获取，提前知晓用途）：阿里云百炼API-Key（激活OpenClaw AI能力，相当于“AI大脑的钥匙”）、OpenClaw访问Token（登录Web控制台、配置对接参数的凭证）、WhatsApp账号（用于绑定与发送指令）。

（四）注意事项（新手必看，避免踩坑，节省排查时间）

1. 网络通畅：部署与对接过程中，保持本地设备、阿里云服务器网络稳定，不中断远程连接、不刷新关键配置页面，避免部署失败、参数配置异常；阿里云海外服务器需确保能正常访问WhatsApp服务器，手机端WhatsApp需确保网络通畅，能够正常接收消息。
2. 端口提前知晓：需放通3个核心端口——22端口（SSH远程连接，默认放通）、18789端口（OpenClaw通信端口，WhatsApp对接核心端口）、8080端口（OpenClaw Web控制台端口），后续将详细拆解放通步骤，缺少任意一个端口，都会导致远程连接失败、Web控制台无法访问、WhatsApp对接失败。
3. 凭证保护：所有获取的API-Key、OpenClaw访问Token、服务器密码等敏感凭证，需妥善保存至加密记事本，切勿泄露，泄露可能导致账号被盗用、模型调用额度流失、AI助手被恶意操控、敏感信息泄露；凭证仅生成时可完整查看，刷新页面后无法再次获取，需及时保存，建议定期（每3个月）轮换阿里云百炼API-Key与OpenClaw访问Token，提升安全性。
4. 版本适配：确保选择的OpenClaw镜像为2026年稳定版（v2026.2.3及以上），旧版本可能存在WhatsApp对接兼容问题、跨境网络适配缺陷，可在阿里云实例创建页面确认镜像版本；避免使用旧版命令导致操作失败，本文所有命令均适配最新版与旧版兼容。
5. 地域选择：优先选择阿里云海外/港澳台地域服务器（美国硅谷、新加坡、中国香港等），免备案、跨境网络稳定，可直接访问WhatsApp服务器，是对接WhatsApp的核心前提；国内地域（除香港）需完成ICP备案，且可能无法正常访问WhatsApp服务器，不推荐新手选择；服务器地域需与自身主要使用区域匹配，降低网络延迟。
6. 权限确认：提前确认阿里云账号具备轻量应用服务器购买、百炼API-Key创建、服务器配置的权限；个人用户默认拥有全部权限，企业用户需确认主账号已为当前子账号分配对应权限，避免因权限不足导致部署与对接失败。

三、阿里云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基础部署，后续再进行WhatsApp对接，快速拥有适配全球沟通的专属AI助手，步骤简洁明了，直接照做即可，无需额外操作：

1. 登录阿里云控制台，创建轻量应用服务器实例（优先选择海外/港澳台地域），选择OpenClaw官方镜像，完成基础配置（密码、付费类型）并启动实例，记录服务器公网IP与登录密码；
2. 登录阿里云百炼控制台，创建API-Key，复制并保存至加密记事本（核心凭证，用于激活OpenClaw AI能力）；
3. 用远程连接工具（FinalShell）连接服务器，复制本文提供的代码命令，配置百炼API-Key并生成OpenClaw访问Token，放通核心端口；
4. 打开浏览器，访问http://服务器公网IP:8080，通过访问Token登录OpenClaw Web控制台，发送简单测试指令，验证服务正常运行，准备进行WhatsApp对接。

四、详细操作步骤：阿里云部署OpenClaw（含代码命令，复制即用）

本次操作全程基于阿里云轻量应用服务器（OpenClaw官方海外版镜像），所有代码命令均可直接复制粘贴，无需修改参数（除明确标注需替换的内容外），新手逐一步骤执行即可，全程不超过20分钟，同时适配阿里云ECS云服务器用户（步骤基本一致，仅服务器操作界面略有差异），每一步均标注避坑要点，确保部署一次成功。

第一步：创建阿里云服务器实例（5分钟，核心部署基础，载体搭建）

1. 登录阿里云控制台，在顶部搜索框输入“轻量应用服务器”，点击进入服务页面；也可直接访问阿里云OpenClaw一键部署专题页面，点击“一键购买并部署”，直接跳转至配置界面，节省操作时间，无需手动搜索镜像。
   
2. 点击页面右上角“创建实例”，进入实例购买页面，按以下配置填写（新手直接照抄，无需修改默认配置，重点关注地域与镜像选择，这是对接WhatsApp的关键）：
   • 地域：优先选择新加坡、美国硅谷、中国香港（推荐，免备案，跨境网络稳定，直连WhatsApp服务器）；也可根据自身使用区域选择德国法兰克福、日本东京等海外地域；国内有备案需求的用户可选择华东1（杭州）、华北2（北京）等国内地域，但需完成ICP备案后才能正常使用，且可能无法正常访问WhatsApp，不推荐新手选择。
   • 镜像类型：切换至“应用镜像”，在搜索框输入“OpenClaw（原Clawdbot/Moltbot）”，选中官方认证镜像（避免第三方镜像有安全风险，确保为2026年稳定版v2026.2.3及以上，海外版镜像优先选择，已优化跨境网络适配）；该镜像已提前预装所有核心依赖，无需手动配置Node.js、Docker等，部署完成后可直接启动服务。
   • 实例规格：默认2vCPU+2GiB内存+40GiB SSD+200Mbps带宽，新手无需修改，足够日常使用；若需处理复杂任务（如多并发指令、大量文件生成、多插件同时运行），可选择4vCPU+4GiB内存，后续无需重新部署，可直接弹性升级配置。
   • 付费类型：勾选“按需付费”，勾选“我已阅读并同意相关服务条款”；长期使用建议“包年包月”，新用户可领取新手专属优惠，进一步降低成本；按需付费无需提前充值，仅按实际使用时长计费，测试阶段更划算。
   • 实例名称：自定义填写（如“OpenClaw-WhatsApp对接”“AI助手服务器”），便于后续管理，可根据使用场景命名，无需复杂格式。
3. 点击“立即购买”，根据提示完成支付（按需付费首次支付金额极低，仅扣除少量押金），支付成功后，进入“轻量应用服务器实例管理”页面，等待实例创建完成（约1-2分钟）；实例创建过程中无需操作，耐心等待即可，页面会显示“初始化中”，完成后变为“运行中”。
4. 实例创建成功后，重点记录页面中的“公网IP地址”（后续远程连接、Web控制台访问、对接配置均需用到，务必保存好），并点击“重置密码”，设置服务器登录密码（与购买时密码可一致，建议设置复杂密码，包含大小写、数字、特殊字符），重置密码后需重启实例（点击“重启实例”），确保密码生效；重启实例约需30秒，重启完成后实例状态恢复为“运行中”。

避坑提醒

• 镜像必须选择“OpenClaw官方镜像”，不要选错为CentOS、Ubuntu等纯系统镜像，否则需手动配置所有依赖，新手难以完成，且容易出现依赖冲突、跨境网络适配问题，导致部署失败；
• 公网IP地址务必保存至加密记事本，后续多个步骤均需用到，地域一旦确定无法修改，需谨慎选择，优先海外/港澳台地域；
• 实例创建后，默认处于“运行中”状态，若状态为“已停止”，需点击“启动实例”才能继续操作；若实例创建失败，检查阿里云账号是否完成实名认证、是否有足够余额（按需付费无需提前充值）、所选地域是否有可用资源，排查无误后重新创建；
• 密码设置需复杂，避免简单密码被破解，建议包含大小写字母、数字、特殊字符，保存至加密记事本中，避免遗忘；服务器登录密码是远程连接的核心凭证，切勿泄露给无关人员。
  

第二步：获取阿里云百炼API-Key（3分钟，激活AI能力，核心关键）

OpenClaw本身不具备AI推理、指令解析与任务执行能力，需对接阿里云百炼大模型，通过API-Key获取授权，才能实现“接收指令→解析指令→执行任务→反馈结果”的全流程，这是部署过程中的核心关键步骤，新手按以下步骤操作，同时支持两种类型的百炼API-Key配置（按Token用量计费、Coding Plan套餐专属API-Key），新手优先选择按Token用量计费的API-Key，成本更可控，操作更简单。

1. 保持服务器实例管理页面不变，打开新浏览器标签页，访问阿里云百炼大模型服务平台，用已实名认证的阿里云账号登录（自动关联，无需重新输入密码，登录后即可看到百炼服务首页）；进入“密钥管理”页面，两种方式均可获取API-Key，步骤一致。
2. 登录后，点击左侧导航栏“密钥管理”（默认地域为华北2北京，不同地域API-Key相互独立，无需修改，系统会自动匹配离服务器最近的百炼模型服务节点，降低延迟）；
3. 点击“创建API-Key”，系统会自动生成一组Access Key ID和Access Key Secret组合密钥（即API-Key），生成后立即点击“复制”按钮，将两组密钥（Access Key ID和Access Key Secret）全部复制，保存到加密记事本中（关键提醒：该密钥仅创建时可完整查看，页面刷新后Access Key Secret将隐藏，无法再次查看，若怀疑泄露，需立即点击“禁用”，并重新创建新的API-Key，避免被他人滥用产生高额费用）；
4. 领取免费额度：新用户登录百炼控制台后，会自动弹出“领取免费额度”提示，点击“立即领取”，即可领取90天免费模型调用额度（超7000万tokens），足够前期测试与日常轻度使用；若免费额度耗尽，可充值或订阅百炼Coding Plan套餐，享受固定月费与月度调用额度，性价比更高（Coding Plan仅支持抵扣qwen3-max-2026-01-23和qwen3-coder-plus模型调用费用，不支持调用多模态模型，新手无需额外订阅）；
5. 权限确认：进入百炼控制台“权限管理”页面，确保当前API-Key已关联“模型调用”权限，若未关联，手动添加“AliyunDashScopeFullAccess”权限并保存；若使用子账号创建API-Key，需确保子账号具备“AliyunDashScopeFullAccess”权限，否则无法正常调用百炼大模型，导致OpenClaw无法激活AI能力。

补充说明（新手可选，了解即可，无需额外操作）

若使用阿里云百炼Coding Plan套餐，需生成专属API-Key，并使用对应地域的Base URL，按地域区分如下，后续配置OpenClaw时需替换对应Base URL，新手无需额外配置，默认使用按Token用量计费的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远程连接服务器，可视化操作更简单，无需记住复杂的SSH命令，全程复制本文提供的代码命令即可，无需手动编写、修改，阿里云ECS云服务器用户操作步骤一致，仅实例管理页面略有差异。

1. 远程连接服务器（新手重点，步骤详细，避免连接失败）

1. 打开FinalShell工具（已安装的前提下），点击左上角“新建连接”，在下拉菜单中选择“SSH连接”；
2. 在弹出的连接配置窗口中，填写以下信息（全部为之前保存的参数，直接粘贴即可）：
   • 主机：粘贴服务器公网IP地址（从阿里云实例管理页面复制，确保无空格、无多余字符）；
   • 用户名：默认root（无需修改，阿里云轻量应用服务器、ECS默认登录用户均为root）；
   • 密码：粘贴服务器登录密码（之前重置的复杂密码，确保填写正确，区分大小写）；
   • 端口：默认22（无需修改，SSH远程连接默认端口，已默认放通）；
     填写完成后，可点击“测试连接”，若弹出“连接成功”提示，说明参数填写正确，再点击“确定”保存连接配置；若提示“连接超时”“密码错误”，检查公网IP是否正确、密码是否填写正确、服务器是否处于“运行中”状态。
3. 保存连接后，双击该连接，弹出“连接成功”提示，即可进入阿里云服务器远程终端界面（黑色窗口，可输入、执行代码命令）；若连接失败，可尝试更换远程连接工具（如Xshell），或检查服务器地域网络是否正常，海外服务器可尝试切换本地网络（如手机热点）。

2. 检查OpenClaw镜像配置（必做，确保环境正常，避免后续踩坑）

连接成功后，复制以下命令，依次粘贴到终端中，按Enter键执行，检查OpenClaw是否已正确安装、核心依赖是否齐全（兼容旧版Clawdbot命令，新手无需区分，直接复制执行即可，无需修改命令）：

# 检查OpenClaw版本（兼容旧版Clawdbot命令，两种命令任选其一）
openclaw --version
# 若提示command not found，切换旧版Clawdbot命令
clawdbot --version
# 检查Node.js版本（需≥22，OpenClaw运行核心依赖，镜像已预装）
node --version
# 检查Docker版本（镜像已预装，用于容器管理，保障服务稳定运行）
docker --version
# 查看OpenClaw服务状态（输出active(running)即为正常运行）
systemctl status openclaw

成功输出OpenClaw版本（如v2026.2.3）、Node.js版本（如v22.0.0）、Docker版本（如26.0.0），且OpenClaw服务状态为active(running)，说明镜像配置正常，环境无问题；若Node.js版本过低（＜22），执行以下命令升级；若服务未运行（显示inactive），执行systemctl start openclaw启动服务：

# 升级Node.js至22版本（若版本过低）
npm install -g n
n 22
# 验证升级结果，确认版本≥22
node --version
# 启动OpenClaw服务（若未运行）
systemctl start openclaw
# 设置OpenClaw开机自启，避免服务器重启后服务失效
systemctl enable openclaw
# 一键更新系统依赖，确保环境兼容性，优化跨境网络源（可选，推荐执行）
yum update -y --disablerepo=* --enablerepo=aliyunos,epel

3. 配置百炼API-Key（核心命令，激活OpenClaw AI能力）

复制以下命令，粘贴到终端执行，配置OpenClaw对接阿里云百炼大模型（仅需替换命令中的“你的Access Key ID”为第二步获取的Access Key ID，若未购买Coding Plan，无需修改Base URL，新手直接替换后复制执行即可，无需修改其他参数）：

# 进入OpenClaw配置目录（兼容旧版Clawdbot目录，无需修改）
cd /root/.openclaw
# 编辑配置文件（中文注释，新手可直接复制，仅替换Access Key ID即可）
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": {
    "whatsapp": {
      "enabled": false, # 暂设为false，后续WhatsApp对接时改为true
      "phoneNumber": "", # 后续填写WhatsApp手机号
      "replyTimeout": 30000 # 回复超时时间（30秒），避免长时间等待
    }
  }
}
EOF

配置说明（新手必看，避免配置错误，导致AI能力无法激活）

• baseUrl：未购买Coding Plan的用户，无需修改，默认填写的地址可正常调用百炼大模型；购买Coding Plan的用户，需替换为对应地域的Coding Plan Base URL（参考第二步补充说明）；
• apiKey：务必粘贴第二步获取的Access Key ID，填写错误会导致无法调用百炼大模型，AI能力无法激活，新手粘贴后可再次核对，确保无空格、无多余字符；
• reasoning：必须设置为false，否则会导致OpenClaw无法正常响应指令，回复内容为空，这是OpenClaw对接百炼模型的关键配置，新手切勿修改；
• whatsapp相关配置：目前暂不填写，后续WhatsApp对接时再补充，enabled设为false避免配置错误导致服务异常；replyTimeout设置为30000（单位：毫秒），即30秒，避免指令执行时间过长导致回复超时，适配WhatsApp聊天场景，若网络延迟较高，可后续修改为60000毫秒。

4. 重启OpenClaw服务，生成访问Token

配置完成后，需重启OpenClaw服务，使API-Key配置生效，并生成OpenClaw访问Token（用于登录Web控制台、后续WhatsApp对接配置），复制以下命令执行，所有命令可直接复制，依次执行即可，无需修改：

# 重启OpenClaw服务，使API-Key配置生效
systemctl restart openclaw
# 查看服务运行状态（确保状态为active(running)，无报错）
systemctl status openclaw
# 生成OpenClaw访问Token（用于登录Web控制台，核心凭证）
openclaw token generate
# 若使用旧版Clawdbot命令，切换为以下命令生成Token
clawdbot token generate
# 查看Token配置（可选，确认Token生成成功，可看到生成的Token字符串）
cat /root/.openclaw/openclaw.json | grep token

执行完成后，终端会输出一串随机字符串（即OpenClaw访问Token），复制该Token并保存到加密记事本中（丢失后可重新执行generate命令生成，无需重新配置其他参数）；同时可执行以下命令，验证API-Key配置是否生效，确保AI能力已激活：

# 进入OpenClaw容器环境（可选，用于验证配置）
docker exec -it openclaw-core /bin/bash
# 验证API-Key配置（输出填写的Access Key ID即为成功）
openclaw config get models.providers.bailian.apiKey
# 退出容器环境，返回服务器终端
exit

5. 放通核心端口（必做，否则无法访问Web控制台、WhatsApp对接失败）

OpenClaw Web控制台访问、WhatsApp对接，需依赖18789、8080两个核心端口（22端口默认已放通），需手动放通这两个端口（阿里云控制台可视化操作，无需执行复杂命令，新手优先选择控制台操作，更简单；有技术基础的用户可选择命令放通）：

1. 回到阿里云轻量应用服务器实例管理页面，点击左侧导航栏“防火墙”；
2. 点击“添加规则”，分别添加以下2个端口的入站规则（确保Web控制台访问与WhatsApp对接正常，步骤一致，重复两次添加）：
   • 端口：18789，协议：TCP，来源：0.0.0.0/0（OpenClaw通信端口，WhatsApp对接核心端口，不可遗漏）；
   • 端口：8080，协议：TCP，来源：0.0.0.0/0（OpenClaw Web控制台端口，用于登录验证部署）；
     填写完成后，点击“保存”，端口放通完成；若22端口未放通，按同样步骤添加22端口规则（一般默认已放通，无需额外操作）。
3. （可选，有技术基础用户）通过以下命令手动放通端口（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服务提示“失败”，执行以下命令查看错误日志，针对性解决，新手可根据日志提示排查问题，无需联系客服，90%的问题可通过日志解决：

  # 查看OpenClaw服务错误日志（重点排查API-Key、依赖相关错误）
  journalctl -u openclaw
  # 查看OpenClaw运行日志（排查详细错误信息）
  openclaw logs
  # 重启服务，尝试解决临时异常
  systemctl restart openclaw
  

• 18789端口必须放通，这是OpenClaw与WhatsApp通信的核心端口，缺少该端口会导致对接失败；若端口被占用，可通过netstat -tlnp | grep 18789查看占用进程，执行kill -9 进程ID关闭对应进程后，重新启动OpenClaw服务；
• 若使用旧版命令clawdbot启动失败、生成Token失败，可替换命令为clawdbot gateway run，确保服务正常运行、Token正常生成；
• 海外地域服务器放通端口后，需确保网络可正常访问WhatsApp服务器，可通过ping whatsapp.com命令测试网络连通性，若无法ping通，检查服务器地域是否正确，或切换地域重新创建实例。

第四步：验证OpenClaw部署成功（1分钟，必做，避免后续对接踩坑）

部署完成后，需验证OpenClaw是否正常运行、AI能力是否已激活，避免后续对接WhatsApp后，因部署问题导致指令无响应，步骤简单，新手直接照做即可：

1. 打开浏览器，在地址栏输入地址：http://你的服务器公网IP:8080（替换“你的服务器公网IP”为之前保存的服务器公网IP，确保无空格、无错误），按Enter键跳转至OpenClaw登录页面；
2. 粘贴第三步生成的OpenClaw访问Token（完整复制，无空格、无多余字符），点击“登录”，即可进入OpenClaw全中文Web控制台（左侧为对话窗口，右侧为功能菜单，界面简洁，新手易上手）；
3. 在Web控制台左侧对话窗口，发送以下测试指令，验证AI能力是否激活（即API-Key配置是否正确），新手可发送贴合WhatsApp使用场景的指令，便于后续对接后快速适应：
   • 基础指令：“帮我生成一份每日待办清单模板，包含工作、生活两类，用中文分点列出，简洁明了，适配WhatsApp发送格式”；
   • 文档生成指令：“帮我创建一个名为‘OpenClaw-WhatsApp对接测试’的文本文件，内容为‘阿里云部署OpenClaw成功，准备对接WhatsApp，助力全球沟通与办公提效’”；
   • 简单查询指令：“帮我查询今日美元兑人民币汇率，整理成简洁文本，适配WhatsApp发送格式，包含汇率、涨跌情况”；
   • 翻译指令：“帮我将‘阿里云部署OpenClaw成功，可通过WhatsApp调用AI能力’翻译成英文，简洁准确，适配跨境沟通”。
4. 若OpenClaw能在30秒内快速响应，生成符合要求的内容，说明部署成功，AI能力已激活；若提示“模型调用失败”“API-Key无效”，需检查API-Key填写是否正确、Base URL是否匹配，或百炼免费额度是否耗尽，排查无误后重新配置并重启服务；若无法登录Web控制台，检查8080端口是否放通、访问Token是否正确、服务器是否正常运行。

五、详细操作步骤：OpenClaw一键接入WhatsApp（含代码命令，喂饭级拆解）

完成OpenClaw部署与AI能力激活后，进入核心对接环节，全程分为“启动OpenClaw WhatsApp对接功能→绑定WhatsApp账号→配置对接参数→验证对接效果→扩展功能安装”5步，无需编写代码，无需申请复杂的API权限，通过扫码或简单命令即可完成，新手逐一步骤执行，全程不超过30分钟，每一步均标注操作细节、复制命令与避坑要点，确保一次对接成功，适配2026年OpenClaw最新版本与WhatsApp最新规则。

第一步：启动OpenClaw WhatsApp对接功能（5分钟，核心对接基础）

回到阿里云服务器远程连接终端（已连接成功的状态），启动OpenClaw内置的WhatsApp对接插件，准备进行账号绑定，所有命令可直接复制粘贴，无需修改，新手直接执行即可，兼容旧版Clawdbot命令：

1. 确保终端已连接服务器，复制以下命令，依次粘贴执行，安装WhatsApp对接插件（若镜像已预装，执行命令会提示已安装，无需担心，不影响操作）：

   # 安装OpenClaw WhatsApp对接插件（官方最新版，适配v2026.2.3）
   openclaw add-channel whatsapp
   # 若使用旧版Clawdbot命令，切换为以下命令
   clawdbot add-channel whatsapp
   # 启动WhatsApp对接服务（后台运行，避免关闭终端后服务停止）
   nohup openclaw channel start whatsapp &
   # 若使用旧版Clawdbot命令，切换为以下命令
   nohup clawdbot channel start whatsapp &
   # 查看WhatsApp对接服务运行状态，输出“running”即为成功
   openclaw channel status whatsapp
   # 若使用旧版Clawdbot命令，切换为以下命令
   clawdbot channel status whatsapp
   

2. 执行完成后，若终端输出“whatsapp channel is running”，说明WhatsApp对接服务已成功启动；若提示“plugin not found”“channel not exist”，说明OpenClaw版本过低，执行以下命令升级版本后，重新执行上述命令：

   # 升级OpenClaw至最新版本（兼容旧版Clawdbot）
   openclaw update
   # 若使用旧版Clawdbot命令，切换为
   clawdbot update
   # 升级完成后，重新启动WhatsApp对接服务
   nohup openclaw channel start whatsapp &
   # 查看服务状态
   openclaw channel status whatsapp
   

避坑提醒

• 插件安装过程中，确保网络稳定，不中断终端连接，否则会导致插件安装失败；若安装失败，可多次执行openclaw add-channel whatsapp命令，重新安装；
• 启动对接服务后，不要关闭远程终端（若关闭，可重新连接服务器，执行openclaw channel status whatsapp查看服务状态，若已停止，重新执行启动命令即可）；
• 若提示“port 18789 occupied”，说明18789端口被占用，执行netstat -tlnp | grep 18789查看占用进程，关闭对应进程后，重新启动WhatsApp对接服务与OpenClaw服务。

第二步：绑定WhatsApp账号（10分钟，核心步骤，扫码即可完成）

启动WhatsApp对接服务后，需将个人/企业WhatsApp账号与OpenClaw绑定，建立两者之间的通信连接，无需申请复杂的API权限，通过手机扫码即可完成绑定，步骤简单，新手直接照做，同时适配WhatsApp个人账号与Business账号：

1. 回到阿里云服务器远程终端，复制以下命令执行，生成WhatsApp绑定二维码（用于手机扫码绑定）：

   # 生成WhatsApp绑定二维码（核心命令，复制执行即可）
   openclaw channel qr whatsapp
   # 若使用旧版Clawdbot命令，切换为以下命令
   clawdbot channel qr whatsapp
   

2. 执行命令后，终端会显示一个二维码（ASCII格式，清晰可见），此时打开手机端WhatsApp（已登录需要绑定的账号），按以下步骤操作扫码：
   • 打开手机WhatsApp，点击右上角“更多”（三个点图标），在下拉菜单中选择“Linked Devices”（关联设备）；
   • 点击“Link a Device”（关联设备），此时手机会弹出扫码界面，允许访问相机；
   • 用手机相机对准终端显示的二维码，缓慢移动手机，确保二维码完整出现在扫码框中，无需放大、缩小，扫码成功后，手机会提示“Device linked successfully”（设备关联成功）；
3. 扫码绑定成功后，终端会输出“whatsapp account linked successfully”（WhatsApp账号绑定成功）的提示，同时会显示绑定的WhatsApp手机号（国际区号格式，如+86138xxxx8888），复制该手机号并保存到加密记事本中，后续配置需用到；
4. 若扫码后无响应、绑定失败，按以下步骤排查：
   • 检查手机WhatsApp网络是否通畅，确保能正常访问WhatsApp服务器；
   • 检查服务器网络是否正常，可执行ping whatsapp.com测试连通性，若无法ping通，切换服务器地域；
   • 重新生成二维码：执行openclaw channel qr whatsapp命令，重新生成二维码，再次扫码尝试；
   • 检查OpenClaw WhatsApp对接服务是否正常运行，执行openclaw channel status whatsapp，若未运行，重新启动服务后再扫码。

补充方案（若扫码绑定失败，新手可尝试，备选方案）

若扫码绑定失败（如终端无法生成二维码、手机扫码无响应），可通过填写手机号与凭证的方式手动绑定，复制以下命令执行，替换对应参数即可，步骤如下：

# 手动绑定WhatsApp账号（替换命令中的手机号为自己的WhatsApp手机号，国际区号格式）
openclaw channel config whatsapp phoneNumber +86138xxxx8888
# 若使用旧版Clawdbot命令，切换为
clawdbot channel config whatsapp phoneNumber +86138xxxx8888
# 启动手动绑定流程，按终端提示输入验证码（验证码会发送至WhatsApp账号）
openclaw channel bind whatsapp
# 若使用旧版Clawdbot命令，切换为
clawdbot channel bind whatsapp

执行命令后，终端会提示“verify code sent to your whatsapp”（验证码已发送至你的WhatsApp），此时打开手机WhatsApp，会收到一条来自OpenClaw的验证码消息（6位数字），将验证码输入终端，按Enter键，即可完成手动绑定，终端会提示绑定成功。

避坑提醒

• 绑定的WhatsApp账号需正常使用，无违规记录，否则会导致绑定失败、无法接收指令；
• 扫码时，确保终端中的二维码清晰可见，手机相机无遮挡，网络通畅，避免扫码失败；
• 绑定成功后，不要随意解绑，若需更换WhatsApp账号，需先执行openclaw channel unbind whatsapp命令解绑旧账号，再绑定新账号；
• 手动绑定输入验证码时，确保输入正确，若输入错误，可重新执行绑定命令，获取新的验证码。

第三步：配置OpenClaw WhatsApp对接参数（5分钟，含代码命令，复制即用）

绑定WhatsApp账号后，需将绑定的手机号录入OpenClaw配置文件，启用WhatsApp对接功能，优化对接参数，确保指令响应流畅、无延迟，复制以下命令执行（替换命令中的“你的WhatsApp手机号”为第二步绑定的手机号，国际区号格式，直接复制粘贴，无需修改其他参数，新手可直接替换）：

# 进入OpenClaw配置目录
cd /root/.openclaw
# 编辑配置文件，补充WhatsApp对接配置（覆盖原有whatsapp相关配置）
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": {
    "whatsapp": {
      "enabled": true, # 启用WhatsApp对接功能（关键，改为true）
      "phoneNumber": "你的WhatsApp手机号", # 粘贴绑定的WhatsApp手机号（国际区号格式）
      "replyTimeout": 30000, # 回复超时时间（30秒），可根据网络延迟调整
      "requireMention": false, # 无需@，直接发送指令即可响应，新手无需修改
      "allowFrom": [] # 允许所有手机号发送指令，若需限制，填写手机号白名单（如["+86138xxxx8888"]）
    }
  }
}
EOF

配置说明（新手必看，避免配置错误，确保对接流畅）

• enabled：必须设为true，启用WhatsApp对接功能，此前设为false是为了避免配置错误导致服务异常，这是对接成功的关键配置；
• phoneNumber：务必粘贴第二步绑定的WhatsApp手机号，国际区号格式（如+86138xxxx8888），填写错误会导致OpenClaw无法接收、发送WhatsApp消息，新手粘贴后再次核对，确保无错误；
• replyTimeout：默认30秒，若跨境网络延迟较高，可修改为60000（60秒），避免指令执行时间过长导致回复超时，适配跨境沟通场景；
• requireMention：设为false，无需@任何账号，直接在WhatsApp聊天窗口发送指令，OpenClaw即可响应，简化操作，新手无需修改；若设为true，需@绑定的WhatsApp账号才能响应指令，适合多人共用场景；
• allowFrom：默认允许所有手机号发送指令，若需限制仅指定手机号可调用AI，可填写手机号白名单（如["+86138xxxx8888", "+86139xxxx9999"]），新手无需修改，保持默认即可，方便测试与日常使用。

配置完成后，重启OpenClaw服务与WhatsApp对接服务，使配置生效，复制以下命令执行，依次执行即可，确保服务正常运行：

# 重启OpenClaw服务，使WhatsApp对接配置生效
systemctl restart openclaw
# 查看OpenClaw服务运行状态（确保状态为active(running)，无报错）
systemctl status openclaw
# 重启WhatsApp对接服务，确保与配置同步
pkill -f openclaw channel
nohup openclaw channel start whatsapp &
# 查看WhatsApp对接服务运行状态（输出running即为成功）
openclaw channel status whatsapp
# 验证WhatsApp对接配置是否生效，输出绑定的手机号即为成功
openclaw config get channels.whatsapp.phoneNumber
# 查看OpenClaw WhatsApp对接日志，确认无异常（可选，新手可跳过）
openclaw logs --module whatsapp

若服务启动正常、日志无报错（无“phone number error”“connection failed”等错误信息），说明OpenClaw WhatsApp对接配置完成；若启动失败，检查WhatsApp手机号是否填写正确、插件是否安装成功、核心端口是否放通，排查无误后重新配置并重启服务，新手可通过查看日志排查具体错误原因。

避坑提醒

• 重启服务后，若服务状态异常，执行journalctl -u openclaw查看错误日志，重点关注“whatsapp”相关错误，若提示“invalid phone number”，说明手机号填写错误，重新粘贴正确手机号并重启服务；
• 若日志提示“connection to whatsapp server failed”，说明服务器无法连接WhatsApp服务器，检查服务器地域是否正确、网络是否通畅，或切换地域重新创建实例；
• 若日志提示“plugin error”，说明WhatsApp对接插件未安装成功，重新执行openclaw add-channel whatsapp命令安装插件，再重启服务。

第四步：验证对接效果（5分钟，必做，确认对接成功，喂饭级测试）

对接完成后，通过手机WhatsApp发送指令，验证OpenClaw与WhatsApp的对接效果，确保指令能正常接收、执行，结果能实时反馈至WhatsApp聊天窗口，步骤如下（新手可直接照做，测试指令贴合日常使用、跨境沟通场景，后续可直接用于实际使用）：

1. 基础指令测试（新手首选，简单易操作，优先测试，确认核心功能正常）

1. 打开手机WhatsApp，确保已登录绑定的账号，进入任意聊天窗口（可新建聊天、打开现有聊天，无需专门创建群聊，一对一聊天即可测试）；
2. 发送以下测试指令，查看是否能在30秒内收到OpenClaw的反馈结果，结果是否符合指令要求。