OpenClaw 阿里云轻量服务器部署+QQ机器人搭建｜零代码命令速通+常见问题解答

2026年，OpenClaw（原Clawdbot）凭借轻量化部署、多平台接入与灵活的Skill扩展能力，成为个人与团队搭建专属AI助手的首选工具。对于新手而言，阿里云轻量服务器是部署OpenClaw的最优选择——成本低、稳定性强、7×24小时在线，搭配QQ可快速搭建能聊天、执行指令、自动处理任务的AI机器人，满足日常沟通、信息查询、任务管理等需求。

本文专为零基础用户打造，基于2026年OpenClaw最新稳定版（v2026.4.5），完整覆盖新手零基础阿里云上部署OpenClaw简单步骤、本地MacOS/Linux/Windows11部署、阿里云千问大模型API配置、Coding Plan免费API配置、QQ机器人接入、全场景避坑指南、常见问题解答七大核心模块，所有代码命令可直接复制执行，确保新手看完就能上手，一次部署成功。阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心前置准备（新手必看，零失败基础）

（一）OpenClaw与QQ基础认知

• OpenClaw：开源AI自动化框架，通过配置大模型API与接入不同平台（如QQ），实现自然语言交互、任务执行、Skill扩展等能力，可理解为“AI机器人的操作系统”。
• QQ机器人：在QQ平台运行的自动化账号，OpenClaw通过QQ开放平台提供的AppID与AppSecret接入，即可让AI助手在QQ好友、群聊中响应消息、执行指令。
• 核心依赖：OpenClaw运行需Node.js 22+、Git；接入QQ需在QQ开放平台创建机器人并获取AppID、AppSecret；调用AI能力需阿里云千问或Coding Plan免费API密钥。

（二）新手必备账号与工具

1. 阿里云账号：注册阿里云账号完成实名认证，可购买轻量应用服务器（新手推荐2核2G，年付低至38元）。
2. QQ开放平台账号：注册并完成个人认证，拥有创建QQ机器人的权限（免费）。
3. 远程连接工具：FinalShell（新手首选，可视化操作，免费）、Xshell或系统自带终端。
4. 文本编辑器：Notepad++、VS Code或系统自带记事本，用于保存密钥、Token等信息。

（三）关键信息提前记录（避免后续遗漏）

• 阿里云轻量服务器公网IP、登录密码（root用户）。
• QQ机器人AppID、AppSecret（仅显示一次，务必保存）。
• 阿里云千问API Access Key ID、Access Key Secret 或 Coding Plan免费API Key。
• OpenClaw 管理员Token（Web控制台登录凭证）。

二、新手零基础阿里云轻量服务器部署OpenClaw（15分钟速通）

阿里云轻量服务器部署是新手最优方案，无需复杂环境配置，依托官方应用镜像可一键完成基础部署，后续仅需简单配置即可接入QQ。

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

第一步：点击打开访问阿里云OpenClaw一键部署专题页面。

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

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

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

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

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

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

• 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
  
• 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
  
• 在服务器概览页面单击应用详情页签，进入服务器详情页面。
  
• 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
  
• 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
  
• 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
  
  

（一）步骤1：购买并创建轻量应用服务器（核心第一步）

1. 登录阿里云控制台，进入「轻量应用服务器」页面，点击「创建实例」。
2. 配置核心参数（新手直接照搬，零修改）：
   • 镜像：选择「应用镜像→OpenClaw(Clawdbot) 2026.4.5 官方版」（预装Node.js 22、Git与基础环境，无需手动安装）。
   • 实例规格：2核2G内存+40GiB ESSD系统盘（满足OpenClaw+QQ+基础Skill运行，成本最低）。
   • 地域：优先选择「中国香港」「新加坡」（免备案，QQ开放平台访问无限制，网络延迟低）。
   • 登录方式：设置密码登录（包含大小写、数字、特殊符号，如OpenClaw@2026），务必牢记。
   • 购买时长：月付/年付均可，新手推荐年付（性价比更高）。
3. 点击「确认购买」，完成支付，等待实例创建（1-3分钟，阿里云自动部署OpenClaw基础环境）。
4. 实例创建完成后，复制公网IP，保存至记事本（后续远程连接、访问Web控制台必备）。

（二）步骤2：放通核心端口（必做，否则无法访问与通信）

OpenClaw默认使用18789端口（Web控制台+服务通信），QQ接入需保障网络通畅，必须在阿里云防火墙放通该端口。

1. 进入轻量服务器实例详情页，点击左侧「防火墙」→「添加规则」。
2. 配置端口规则：
   • 协议：TCP
   • 端口范围：18789
   • 授权对象：0.0.0.0/0（测试阶段开放所有IP，后续可根据需求限制）
   • 描述：OpenClaw Web控制台与服务端口
3. 点击「确定」，完成端口放通（立即生效，无需重启服务器）。
4. 验证端口放通（可选，新手可跳过）：
   远程连接服务器后执行以下命令，确认端口已开放：

# 查看防火墙开放端口，验证18789是否存在
firewall-cmd --list-ports | grep 18789
# 输出包含18789/tcp即为成功

（三）步骤3：远程连接服务器并初始化OpenClaw（核心操作）

3.1 远程连接服务器（FinalShell操作，新手零难度）

1. 下载并安装FinalShell（官网：https://www.hostbuf.com/，免费使用）。
2. 打开FinalShell，点击左上角「新建连接」→选择「SSH连接」。
3. 填写连接信息：
   • 主机：粘贴阿里云轻量服务器公网IP
   • 用户名：root（阿里云轻量服务器默认登录用户，无需修改）
   • 密码：粘贴步骤1设置的服务器登录密码
4. 点击「确定」→「连接」，首次连接会提示“是否保存密钥”，选择「是」，成功进入服务器命令行界面。

3.2 初始化OpenClaw（复制命令，一键执行）

远程连接成功后，依次执行以下命令，完成OpenClaw初始化、服务启动与管理员Token生成（所有命令直接复制，无需修改）：

# 1. 进入OpenClaw安装目录（官方默认路径）
cd /opt/openclaw

# 2. 切换国内npm镜像，加速依赖下载（国内用户必做）
npm config set registry https://registry.npmmirror.com/

# 3. 一键初始化OpenClaw（非交互式，自动配置基础环境）
openclaw init --non-interactive --accept-risk --enable-skill-market

# 4. 安装ClawHub客户端（Skill扩展必备，新手必装）
npm install -g clawhub-cli

# 5. 后台启动OpenClaw网关服务（支持QQ接入与Web访问）
openclaw gateway start --daemon

# 6. 生成管理员Token（Web控制台登录凭证，复制保存）
openclaw token generate --admin --allow-ip 0.0.0.0/0

• 执行第6条命令后，终端会输出类似token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...的字符串，完整复制并保存（后续访问Web控制台必备）。

（四）步骤4：访问OpenClaw Web控制台（验证部署成功）

1. 打开浏览器，输入访问地址：http://你的阿里云公网IP:18789?token=你的管理员Token。
2. 若页面正常加载，显示OpenClaw管理界面（包含模型配置、渠道管理、Skill市场等模块），则阿里云部署OpenClaw成功。

（五）阿里云部署避坑指南（新手90%踩坑点，提前规避）

1. 坑1：地域选择内地，QQ开放平台访问失败
   • 现象：部署成功，但QQ机器人无法连接、消息无响应。
   • 原因：内地地域服务器访问QQ开放平台存在网络限制，无法正常通信。
   • 避坑：必须选择中国香港、新加坡地域，避免内地地域。
2. 坑2：未放通18789端口，Web控制台无法访问
   • 现象：输入访问地址后，提示“无法连接”“连接超时”。
   • 原因：阿里云防火墙未放行18789端口，服务器拦截访问请求。
   • 避坑：严格执行步骤2，放通18789端口；若已放通仍无法访问，执行firewall-cmd --add-port=18789/tcp --permanent && firewall-cmd --reload永久开放端口，重启浏览器重试。
3. 坑3：服务器密码错误，远程连接失败
   • 现象：FinalShell连接时提示“认证失败”。
   • 原因：密码输入错误、包含特殊符号未正确输入，或复制时带有空格。
   • 避坑：手动输入密码（避免复制空格），或在阿里云控制台重置密码后重试。
4. 坑4：Node.js版本过低，初始化失败
   • 现象：执行openclaw init时提示“Node.js版本需≥22.0.0”。
   • 原因：应用镜像未预装正确版本Node.js，或环境异常。
   • 避坑：选择官方OpenClaw应用镜像；若仍报错，执行以下命令升级Node.js：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v # 验证版本≥22.0.0

1. 坑5：管理员Token丢失，无法登录控制台
   • 现象：Token未保存，无法访问Web控制台。
   • 避坑：重新执行openclaw token generate --admin生成新Token，立即保存。

三、本地MacOS/Linux/Windows11部署OpenClaw（2026最新，备用方案）

若需本地调试、隐私场景使用，可在本地设备部署OpenClaw，三大系统流程统一，仅命令略有差异，部署完成后可接入QQ本地测试。

（一）通用前置准备（所有系统必做）

1. 安装Node.js 22+：官网下载对应系统安装包，完成安装后验证：node -v（≥22.0.0）。
2. 安装Git：官网下载安装，验证：git --version。
3. 配置国内npm镜像（加速依赖下载，避免超时）：

npm config set registry https://registry.npmmirror.com

（二）MacOS本地部署（Intel/M芯片通用）

1. 打开终端，执行以下命令：

# 国内镜像一键安装OpenClaw
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

# 验证安装版本（需≥2026.4.5）
openclaw --version

# 安装ClawHub客户端
npm install -g clawhub-cli

# 初始化并后台启动服务
openclaw init --non-interactive --accept-risk --enable-skill-market
openclaw gateway start --daemon

# 生成管理员Token
openclaw token generate --admin

1. 访问Web控制台：http://localhost:18789?token=生成的Token。

（三）Linux本地部署（Ubuntu/CentOS通用）

1. Ubuntu系统执行：

# 安装核心依赖
sudo apt update && sudo apt install -y nodejs npm git

# 升级npm与Node.js
npm install -g npm@latest
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 安装并启动OpenClaw
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
npm install -g clawhub-cli
openclaw init --non-interactive --accept-risk --enable-skill-market
openclaw gateway start --daemon

1. CentOS系统替换依赖安装命令：

sudo yum install -y nodejs npm git

（四）Windows11本地部署（PowerShell管理员执行）

1. 以管理员身份打开PowerShell，解锁执行策略：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入Y确认

1. 执行安装命令：

# 一键安装OpenClaw
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

# 验证版本
openclaw --version

# 安装ClawHub并启动服务
npm install -g clawhub-cli
openclaw init --non-interactive --accept-risk --enable-skill-market
openclaw gateway start --daemon

# 生成管理员Token
openclaw token generate --admin

1. 访问Web控制台：http://localhost:18789?token=生成的Token。

（五）本地部署验证

执行以下命令，确认服务正常运行：

# 查看OpenClaw服务状态
openclaw gateway status
# 验证ClawHub安装
clawhub --version

四、大模型API配置（千问+Coding Plan免费版，二选一即可）

OpenClaw的AI能力依赖大模型API，提供两种方案：阿里云千问（性能优先，推荐）、Coding Plan免费版（零成本，新手入门），配置后QQ机器人才能正常响应消息。

（一）阿里云千问大模型API配置（推荐，稳定高效）

4.1 获取千问API凭证

1. 访问登录阿里云百炼大模型服务平台，进入「密钥管理」页面。
2. 点击「创建API Key」，输入名称（如“OpenClaw-QQ”），点击「确认」。
3. 复制Access Key ID与Access Key Secret（仅显示一次，务必保存）。
4. 选择模型：qwen3.5-plus（免费额度充足，支持QQ多场景交互）。

4.2 配置千问API（代码命令直接复制）

1. 远程连接阿里云服务器（或本地终端），进入OpenClaw配置目录：

# 阿里云/MacOS/Linux
cd ~/.openclaw
# Windows11
cd C:\Users\你的用户名\.openclaw

1. 编辑配置文件openclaw.json：

# 阿里云/MacOS/Linux
nano openclaw.json
# Windows11
notepad openclaw.json

1. 添加千问API配置（替换为自己的凭证）：

{
   
  "models": {
   
    "default": "qwen3.5-plus",
    "providers": {
   
      "aliyun-qwen": {
   
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "你的Access Key ID",
        "secret": "你的Access Key Secret",
        "modelName": "qwen3.5-plus",
        "maxTokens": 2048,
        "temperature": 0.7
      }
    }
  },
  "skillMarket": {
   
    "enabled": true,
    "registry": "https://clawhub.ai"
  },
  "gateway": {
   
    "port": 18789,
    "host": "0.0.0.0"
  }
}

1. 重启OpenClaw服务并验证：

openclaw gateway restart
# 测试模型调用（输出“模型调用成功”即为配置成功）
openclaw model test

（二）Coding Plan免费大模型API配置（零成本，新手入门）

4.3 获取Coding Plan免费API凭证

1. 访问登录阿里云百炼大模型服务平台，进入「Coding Plan」专区，注册免费套餐。
2. 进入「API管理」，创建API-Key，复制专属API-Key（格式：sk-sp-xxx）。
3. 记录API地址：https://coding.dashscope.aliyuncs.com/v1。

4.4 配置Coding Plan API

1. 编辑openclaw.json，添加以下配置（替换为自己的API-Key）：

{
   
  "models": {
   
    "default": "coding-plan-free",
    "providers": {
   
      "coding-plan": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "你的Coding Plan API-Key",
        "modelName": "coding-plan-free",
        "maxTokens": 1024,
        "temperature": 0.8
      }
    }
  },
  "skillMarket": {
   
    "enabled": true,
    "registry": "https://clawhub.ai"
  },
  "gateway": {
   
    "port": 18789,
    "host": "0.0.0.0"
  }
}

1. 重启服务并验证：

openclaw gateway restart
openclaw model test
# 输出“模型调用成功”即为完成

（三）大模型配置避坑指南

1. 坑1：API凭证复制错误，模型调用失败
   • 现象：提示“API-Key无效”“模型连接失败”。
   • 避坑：核对Access Key ID/Secret或Coding Plan API-Key，确保无空格、换行符；重新生成凭证并配置。
2. 坑2：Coding Plan免费额度不足，响应失败
   • 现象：提示“额度耗尽”，无法生成回复。
   • 避坑：等待次日免费额度刷新；高频使用切换为千问API；降低maxTokens至1024以下，减少消耗。
3. 坑3：配置文件格式错误，服务无法启动
   • 现象：执行openclaw gateway restart时提示“配置文件解析失败”。
   • 避坑：严格按照JSON格式编写，确保引号、逗号正确；复制示例配置后仅替换凭证内容，不修改结构。

五、OpenClaw接入QQ机器人（10分钟完成，核心功能）

完成OpenClaw部署与大模型配置后，即可接入QQ，让AI助手在QQ中运行。核心流程：创建QQ机器人→获取AppID与AppSecret→OpenClaw安装QQ插件→配置QQ通道→测试。

（一）步骤1：创建QQ机器人并获取凭证（QQ开放平台操作）

1. 打开QQ开放平台：https://q.qq.com/，用手机QQ扫码登录。
2. 完成个人实名认证（扫码、人脸识别），进入「机器人管理」页面。
3. 点击「创建机器人」，填写机器人名称、描述、头像，提交创建。
4. 获取关键凭证：创建成功后，在机器人详情页复制AppID；点击「生成AppSecret」，复制生成的AppSecret（仅显示一次，务必保存）。
5. 配置沙箱白名单：在机器人「开发管理」页面，添加自己的QQ号到沙箱白名单（测试阶段必需，否则机器人无响应）。

（二）步骤2：OpenClaw安装QQ插件并配置通道（命令行操作）

远程连接阿里云服务器（或本地终端），依次执行以下命令，完成QQ插件安装与通道配置（新手直接复制，无需修改）：

# 1. 安装QQ Bot官方插件（最新版）
openclaw plugins install @sliverp/qqbot@latest

# 2. 验证插件安装成功（输出包含@sliverp/qqbot即为成功）
openclaw plugins list

# 3. 添加QQ通道（替换为你的AppID:AppSecret）
openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

# 4. 重启OpenClaw服务，使配置生效
openclaw gateway restart

（三）步骤3：测试QQ机器人（验证接入成功）

1. 打开手机QQ，添加机器人QQ号为好友（机器人创建后自动生成QQ号）。
2. 向机器人发送消息：你好。
3. 若机器人正常回复（如“你好！我是OpenClaw AI助手，有什么可以帮你的？”），则QQ接入成功。

（四）QQ接入避坑指南

1. 坑1：未添加QQ号到沙箱白名单，机器人提示“去火星了”
   • 现象：发送消息后，机器人回复“该机器人去火星了，稍后再试吧”。
   • 原因：未在QQ开放平台将自己的QQ号添加到沙箱白名单。
   • 避坑：登录QQ开放平台，进入机器人「开发管理」页面，添加测试QQ号到白名单。
2. 坑2：AppID或AppSecret错误，QQ通道连接失败
   • 现象：OpenClaw日志提示“QQ token invalid”。
   • 原因：AppID或AppSecret复制错误，包含空格或换行符。
   • 避坑：重新复制凭证，执行openclaw channels add --channel qqbot --token "正确的AppID:正确的AppSecret"重新配置。
3. 坑3：插件安装失败，提示依赖缺失
   • 现象：执行openclaw plugins install时提示“npm install failed”。
   • 原因：未切换国内npm镜像，依赖下载失败。
   • 避坑：先执行npm config set registry https://registry.npmmirror.com/切换镜像，再重新安装插件。
4. 坑4：网络问题，QQ通道断开连接
   • 现象：OpenClaw日志提示“QQ gateway connection timeout”。
   • 原因：阿里云服务器地域选择内地，或本地网络无法访问QQ开放平台。
   • 避坑：阿里云服务器选择中国香港/新加坡地域；本地部署确保网络通畅；重启OpenClaw服务。

六、OpenClaw Skill扩展（进阶玩法，提升QQ机器人能力）

OpenClaw核心优势是Skill扩展（类似“应用商店”），通过安装Skill可让QQ机器人实现更多功能，如自动回复、信息查询、任务管理等。

1. 安装Skill（以新闻查询Skill为例）：

   # 安装新闻查询Skill
   clawhub install kenxcomp/ai-news-collectors
   # 重启服务生效
   openclaw gateway restart
   

2. 使用Skill：在QQ中向机器人发送指令：查询今日科技新闻，机器人将自动返回新闻内容。
3. Skill管理命令：

   # 查看已安装Skill
   clawhub list
   # 更新所有Skill
   clawhub update --all
   # 卸载Skill
   clawhub uninstall kenxcomp/ai-news-collectors
   

七、2026年常见问题解答（全场景覆盖，新手无忧）

（一）部署类问题

1. 问题：阿里云部署后，Web控制台无法访问，提示“连接超时”
   • 解决方案：检查18789端口是否放通；服务器地域是否为中国香港/新加坡；重启OpenClaw服务：openclaw gateway restart；清除浏览器缓存重试。
2. 问题：本地部署时，执行安装命令提示“网络超时”
   • 解决方案：配置国内npm镜像：npm config set registry https://registry.npmmirror.com；重新执行安装命令。
3. 问题：OpenClaw服务启动失败，提示“端口被占用”
   • 解决方案：修改默认端口（如18790），编辑openclaw.json中gateway.port，重启服务；或关闭占用18789端口的程序。

（二）QQ接入类问题

1. 问题：QQ机器人添加好友后，发送消息无响应
   • 解决方案：检查是否添加到沙箱白名单；核对AppID与AppSecret；重启OpenClaw服务；检查QQ插件是否安装成功。
2. 问题：机器人回复缓慢，或频繁断开连接
   • 解决方案：升级阿里云服务器配置（2核4G及以上）；降低大模型maxTokens；选择网络更稳定的地域；重启服务。

（三）大模型配置类问题

1. 问题：千问API调用失败，提示“账号欠费”
   • 解决方案：登录阿里云百炼平台，充值或领取免费额度；核对API凭证是否正确。
2. 问题：Coding Plan免费API无响应，提示“请求频繁”
   • 解决方案：降低消息发送频率；等待额度刷新；切换为千问API。

（四）通用问题

1. 问题：如何查看OpenClaw日志（排查问题）
   • 解决方案：执行openclaw logs --follow，实时查看服务日志，定位错误原因。
2. 问题：如何更新OpenClaw至最新版本
   • 解决方案：执行npm update -g openclaw@latest，重启服务：openclaw gateway restart。
3. 问题：如何备份OpenClaw配置
   • 解决方案：复制配置文件：cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw-backup.json（阿里云/MacOS/Linux）；Windows系统手动复制C:\Users\你的用户名\.openclaw\openclaw.json。

八、总结

2026年，阿里云轻量服务器部署OpenClaw接入QQ是新手搭建AI机器人的最优路径——成本低、操作简单、稳定性强，从部署到接入仅需30分钟，搭配千问或Coding Plan免费API，即可拥有专属AI助手。

本文完整覆盖阿里云部署、本地部署、大模型配置、QQ接入、Skill扩展、避坑指南、常见问题全流程，所有代码命令可直接复制执行，零基础用户无需编程基础，严格按照步骤操作即可一次成功。建议新手优先选择阿里云轻量服务器（中国香港/新加坡地域），搭配千问3.5-plus大模型，从基础聊天功能入手，逐步安装Skill扩展能力，让QQ机器人成为个人/团队的高效AI助手。