OpenClaw(原Clawdbot)是一款开源跨平台AI交互框架,支持对接LINE、Discord、Telegram等主流IM工具,可绑定通义千问、Coding Plan等大模型API,实现AI对话、自动化任务处理等能力。本文将完整覆盖2026年阿里云服务器部署、本地MacOS/Linux/Windows11部署、阿里云千问与免费Coding Plan API配置、LINE全流程接入及高频问题排查,所有步骤可直接复现,无冗余推广内容。
一、部署前置准备
1.1 基础环境要求
- 服务器:海外地域轻量应用服务器(推荐2核2G起步,支持7×24小时稳定运行)
- 本地设备:Windows11 64位、macOS 12+、Linux(Ubuntu20.04+/CentOS7+)
- 网络:稳定公网访问,LINE相关服务需确保网络连通性
- 账号:LINE账号、阿里云账号(注册阿里云账号,已完成实名认证)、大模型API账号
1.2 核心工具准备
- 终端工具:Windows用PowerShell、macOS/Linux用系统终端
- 代码编辑器:VS Code、Vim等(用于修改配置文件)
- 必备依赖:Node.js≥v22.0.0、Git、Python3(部分系统需手动安装)
二、2026年阿里云部署OpenClaw完整流程
2.1 阿里云轻量应用服务器创建
- 登录阿里云控制台,进入轻量应用服务器购买页面
- 选择应用镜像,搜索并选中OpenClaw(Clawdbot)专属镜像
- 地域优先选择新加坡、美国等海外免备案节点
- 配置选择:2核2G内存+40G ESSD,满足基础运行需求
- 设置登录密码,勾选服务协议,完成支付创建实例
- 等待1-3分钟,实例状态变为运行中,记录公网IP地址
阿里云用户零基础部署 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 的地址。


2.2 安全组端口放行(必做)
- 进入实例详情页,找到安全组→入方向规则
- 新增规则,协议选择TCP,放行以下端口:
- 80、443端口(LINE Webhook HTTPS访问)
- 18789端口(OpenClaw网关默认端口)
- 自定义反向代理端口(后续Caddy配置使用)
- 授权对象填写0.0.0.0/0,确认保存规则
2.3 服务器远程登录与初始化
- 控制台点击实例登录,使用密码免密连接服务器
- 更新系统依赖:
apt update && apt upgrade -y apt install -y curl wget git vim - 验证OpenClaw基础服务:
出现版本号即表示镜像部署正常openclaw --version
2.4 阿里云部署核心配置
- 安装LINE插件:
openclaw plugins install @openclaw/line - 查看网关监听端口:
记录输出端口号(如20051),用于后续反向代理配置ss -nutlp | grep openclaw-gateway
三、本地全平台部署OpenClaw(MacOS/Linux/Windows11)
3.1 Windows11部署流程
安装Node.js
- 访问Node.js官网,下载v22.0.0+64位安装包
- 运行安装包,勾选Add to PATH,完成一键安装
- 验证安装:打开PowerShell,输入
node -v、npm -v,显示版本号即成功
一键安装OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex- 初始化配置
openclaw onboard --install-daemon - 启动网关服务
openclaw gateway start
3.2 macOS部署流程
- 安装Homebrew(已安装可跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装Node.js
brew install node@22 - 配置npm国内镜像
npm config set registry https://registry.npmmirror.com - 全局安装OpenClaw
npm install -g openclaw - 初始化并启动
openclaw config set gateway.mode local openclaw gateway start
3.3 Linux(Ubuntu/Debian)部署流程
- 安装系统依赖
sudo apt update && sudo apt install -y git python3 python3-pip gcc g++ libssl-dev - 安装Node.js
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash - sudo apt install -y nodejs - 官方脚本安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash - 启动服务
openclaw gateway start
四、大模型API配置(阿里云千问+免费Coding Plan)
4.1 阿里云通义千问API配置
- 访问登录阿里云百炼大模型服务平台
- 进入API密钥管理,点击创建API Key,保存AccessKey ID与Secret
- 开通通义千问3.5 Plus、Qwen3-Max模型调用权限
- 编辑OpenClaw配置文件
- 路径:Linux/macOS→
~/.openclaw/openclaw.json - Windows→
C:\Users\用户名\.openclaw\openclaw.json
- 路径:Linux/macOS→
- 添加模型配置:
"models": { "default": "qwen3.5-plus", "providers": { "aliyun-bailian": { "apiKey": "你的百炼API Key", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "models": [ { "id": "qwen3.5-plus", "name": "通义千问3.5 Plus", "contextWindow": 128000 }, { "id": "qwen3-max", "name": "通义千问3 Max", "contextWindow": 1000000 } ] } } } - 重启网关生效
openclaw gateway restart
4.2 免费Coding Plan API配置(零成本方案)
- 阿里云百炼平台进入Coding Plan页面,订阅免费套餐
- 生成专属API Key(格式以sk-sp-开头,区分通用API Key)
- 获取Coding Plan专属Base URL:
https://coding.dashscope.aliyuncs.com/v1 - 配置文件添加Coding Plan模型:
"models": { "default": "qwen-coder", "providers": { "coding-plan": { "apiKey": "你的Coding Plan API Key", "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "api": "openai-completions", "models": [ { "id": "qwen-coder", "name": "通义千问Coder", "contextWindow": 65536 } ] } } } - 重启服务完成配置
五、OpenClaw接入LINE完整流程
5.1 获取LINE开发者凭证
- 打开LINE Developers官网,使用LINE账号扫码登录
- 创建Developers账号,填写名称与邮箱,完成注册
- 新建Provider,选择Messaging API渠道
- 创建LINE Official Account,完成手机号验证(大陆手机号可多次尝试)
- 进入渠道设置,开启Messaging API功能
- 记录Channel Secret(渠道密钥)
- 关闭自动回复,开启Webhook功能
- 点击Issue生成Channel Access Token(渠道访问令牌)
- Webhook URL填写格式:
https://你的公网IP/line/webhook
5.2 OpenClaw LINE渠道配置
- 远程登录服务器/本地终端,编辑配置文件
vim ~/.openclaw/openclaw.json - 在顶层添加channels配置(与meta、models同级):
"channels": { "line": { "enabled": true, "channelAccessToken": "你的LINE Channel Access Token", "channelSecret": "你的LINE Channel Secret", "dmPolicy": "pairing" } } - 保存退出,重启OpenClaw网关
openclaw gateway restart
5.3 Caddy反向代理与HTTPS配置(LINE强制要求)
1. 安装Caddy与ACME证书工具
apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' > /etc/apt/sources.list.d/caddy-stable.list
apt update && apt install caddy -y
curl https://get.acme.sh | sh
source ~/.bashrc
2. 申请Let's Encrypt IP证书(替换为公网IP)
systemctl stop caddy
acme.sh --issue \
--standalone \
-d 你的公网IP \
--server letsencrypt \
--cert-profile shortlived
3. 证书安装与权限配置
mkdir -p /opt/openclaw-line-ip-webhook/live/你的公网IP
chmod 755 /opt
chmod 755 /opt/openclaw-line-ip-webhook
chmod 755 /opt/openclaw-line-ip-webhook/live
chmod 755 /opt/openclaw-line-ip-webhook/live/你的公网IP
acme.sh --install-cert -d 你的公网IP \
--ecc \
--key-file /opt/openclaw-line-ip-webhook/live/你的公网IP/privkey.pem \
--fullchain-file /opt/openclaw-line-ip-webhook/live/你的公网IP/fullchain.pem \
--reloadcmd "chown root:caddy /opt/openclaw-line-ip-webhook/live/你的公网IP/privkey.pem /opt/openclaw-line-ip-webhook/live/你的公网IP/fullchain.pem && chmod 644 /opt/openclaw-line-ip-webhook/live/你的公网IP/fullchain.pem && chmod 640 /opt/openclaw-line-ip-webhook/live/你的公网IP/privkey.pem && systemctl restart caddy"
4. 配置Caddy反向代理(替换IP与端口)
vim /etc/caddy/Caddyfile
写入配置:
{
admin off
default_sni 你的公网IP
}
https://你的公网IP {
tls /opt/openclaw-line-ip-webhook/live/你的公网IP/fullchain.pem /opt/openclaw-line-ip-webhook/live/你的公网IP/privkey.pem
reverse_proxy http://127.0.0.1:你的网关端口
}
5. 启动Caddy服务
systemctl restart caddy
systemctl status caddy --no-pager
显示active即配置成功
5.4 LINE机器人配对与对话测试
- 在LINE中添加创建的Official Account为好友
- 发送任意消息,收到配对码
- 终端执行配对命令(替换为实际配对码)
openclaw pairing approve line 你的配对码 - 再次发送消息,机器人正常AI回复即接入完成
六、高频问题与解决方案
6.1 部署启动类问题
OpenClaw网关启动失败
- 排查:端口被占用、依赖缺失、配置文件语法错误
- 解决:
ss -nutlp检查端口占用,openclaw doctor自动修复,验证JSON格式
Caddy启动失败/证书申请失败
- 排查:80端口被占用、IP无公网访问、地域限制
- 解决:停止占用80端口服务,确认服务器为公网IP,更换证书服务商
6.2 LINE接入类问题
LINE Webhook验证失败
- 原因:URL非HTTPS、密钥错误、端口未放行
- 解决:确认URL为https格式,核对Channel Secret/Token,放行443端口
机器人收不到消息/无响应
- 排查:Webhook未开启、配对失败、模型API Key错误
- 解决:LINE后台开启Webhook,重新执行配对命令,测试模型API连通性
签名验证错误(Invalid signature)
- 原因:Channel Secret配置错误
- 解决:复制LINE后台完整密钥,去除空格换行,重启网关
6.3 模型配置类问题
大模型调用失败/无回复
- 排查:API Key错误、额度耗尽、Base URL错误
- 解决:核对密钥信息,检查账户额度,确认Base URL与模型匹配
Coding Plan无法调用
- 原因:混用通用API Key、套餐未生效
- 解决:使用sk-sp-开头专属Key,等待套餐生效后重试
6.4 本地部署类问题
Windows11权限不足
- 解决:以管理员身份运行PowerShell,重新执行安装命令
macOS无法安装Homebrew
- 解决:切换国内镜像源,关闭网络代理后重试
Linux依赖安装失败
- 解决:更新系统源,安装build-essential基础编译工具
七、总结
本文完整覆盖2026年OpenClaw阿里云服务器部署、本地MacOS/Linux/Windows11三系统部署、阿里云通义千问与免费Coding Plan大模型配置、LINE全流程接入,包含所有命令行代码与配置文件示例,可直接用于生产环境与个人测试。遵循步骤操作即可实现稳定运行,遇到问题可通过openclaw doctor、日志排查、密钥核对等方式快速解决,满足跨平台AI交互需求。