OpenClaw是一款可本地部署的AI Agent工具,支持文件读取、命令执行、邮件发送、消息收发等自动化能力,可作为个人数字助理或轻量化自动化助手使用。2026年版本已全面兼容macOS、Linux、Windows11系统,同时支持阿里云ECS/轻量应用服务器云端部署,可对接阿里云千问大模型与百炼Coding Plan免费API,兼顾稳定性、安全性与成本控制。本文将完整覆盖本地安装、云端部署、模型配置、安全加固、健康检查与常见问题排查,全程可复现,无额外依赖。
一、部署前核心准备与安全须知
OpenClaw具备文件读写、命令执行、外部API调用等高权限能力,部署前必须明确安全边界:
- 本地部署优先绑定127.0.0.1,禁止公网直接暴露控制面板;
- API Key单独管理,不嵌入代码、不分享他人;
- 消息渠道建议使用专用账号,避免个人主号隐私泄露;
- 云端部署必须开启防火墙,仅放行必要端口,配置访问令牌。
- 目前阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

核心环境要求
| 项⽬ | 最低配置 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS、Linux、Windows11 | 同左 |
| Node.js | ≥22.12.0 | ≥24.x |
| 内存 | 4GB | 8GB及以上 |
| 端口 | 18789(默认) | 同左 |
| 网络 | 可访问模型API | 稳定公网 |
版本检查与升级
# 检查Node版本
node -v
# 低于22版本需升级
# macOS/Linux安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# Windows11使用nvm-windows或直接官网下载安装
二、本地全平台部署(MacOS/Linux/Windows11)
(一)macOS部署流程
- 打开终端,执行一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash - 验证安装
openclaw --version # 输出openclaw/2026.x.x即为成功 - 启动配置向导并安装后台服务
openclaw onboard --install-daemon - 安全绑定本地地址
# 编辑配置文件 nano ~/.openclaw/openclaw.json # 修改canvas_host为127.0.0.1 "canvas_host": "127.0.0.1" # 保存退出:Ctrl+O → 回车 → Ctrl+X - 启动服务并获取令牌
openclaw gateway --verbose - 访问控制面板
http://127.0.0.1:18789
(二)Linux部署流程(以Ubuntu/Debian为例)
- 更新系统依赖
sudo apt update && sudo apt upgrade -y sudo apt install -y git - 安装Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash sudo apt install -y nodejs node -v - 安装OpenClaw
npm install -g openclaw@latest # 或pnpm(速度更快) pnpm add -g openclaw@latest - 初始化配置
openclaw onboard --install-daemon - 端口与防火墙配置
# 检查端口占用 lsof -i :18789 # 放行端口(Ubuntu) sudo ufw allow 18789/tcp - 安全加固与启动
# 修改本地绑定 sed -i 's/canvas_host.*/canvas_host": "127.0.0.1"/g' ~/.openclaw/openclaw.json openclaw start
(三)Windows11部署流程
- 以管理员身份打开PowerShell
- 执行安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex - 验证安装
openclaw --version - 运行配置向导
openclaw onboard --install-daemon - 修改配置文件
notepad $env:USERPROFILE\.openclaw\openclaw.json # 找到canvas_host,改为"127.0.0.1" - 启动服务并访问面板
openclaw gateway --verbose # 浏览器访问 http://127.0.0.1:18789
(四)Docker通用部署(全平台兼容)
适合服务器、无环境依赖场景:
# 拉取镜像
docker pull openclaw/openclaw:latest
# 启动容器
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
# 进入容器配置
docker exec -it openclaw bash
openclaw onboard --install-daemon
三、2026阿里云服务器部署OpenClaw完整流程
阿里云ECS/轻量应用服务器可实现7×24小时稳定运行,适合长期自动化任务。
步骤1:购买与创建实例
- 登录阿里云控制台,选择轻量应用服务器或ECS;
- 镜像选择应用镜像→OpenClaw(Clawdbot);
- 配置推荐:2核2GB起步,2核4GB更流畅,系统选择Ubuntu 22.04;
- 完成购买,获取公网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:端口放行与安全组配置
- 进入实例详情→防火墙/安全组;
- 放行TCP 18789端口,仅限必要IP访问;
- 禁止0.0.0.0/0全开放,降低暴露风险。
步骤3:服务器端部署
- SSH连接服务器
ssh root@公网IP - 检查环境并安装
node -v npm install -g openclaw@latest openclaw onboard --install-daemon - 配置公网安全访问
# 生产环境建议绑定内网IP或加Token验证 nano ~/.openclaw/openclaw.json # 设置访问令牌 "token": "自定义强密码令牌" - 启动并设置开机自启
openclaw start systemctl enable openclaw - 公网访问面板
http://公网IP:18789 # 输入令牌登录
四、AI模型API配置(千问+免费Coding Plan)
(一)阿里云千问大模型API配置
- 开通阿里云百炼Model Studio,完成实名认证;
- 进入API密钥管理,创建并复制API Key;
- 执行配置命令
openclaw config set model.provider aliyun_bailian openclaw config set model.aliyun_bailian.api_key "你的API Key" openclaw config set model.aliyun_bailian.base_url "https://dashscope.aliyuncs.com/compatible-mode/v1" openclaw config set agents.defaults.model.primary "bailian/qwen3.5-plus" - 验证连通性
openclaw doctor --repair
(二)阿里云百炼Coding Plan免费API配置
Coding Plan提供免费额度,适合测试与轻量使用,兼容OpenAI协议。
- 进入阿里云百炼→Coding Plan,开通免费套餐;
- 创建专属API Key,记录Key与Base URL;
- 配置命令
openclaw config set model.provider openai openclaw config set model.openai.api_key "Coding Plan-API-Key" openclaw config set model.openai.base_url "https://coding.dashscope.aliyuncs.com/v1" openclaw config set agents.defaults.model.primary "qwen3.5-plus" - 手动配置文件方式
nano ~/.openclaw/openclaw.json # 添加/修改如下字段 "model": { "provider": "openai", "openai": { "apiKey": "你的Key", "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "model": "qwen3.5-plus" } }
五、消息渠道配置(Telegram/WhatsApp)
Telegram配置
- 打开Telegram,搜索@BotFather;
- 发送/newbot,按提示设置名称与用户名;
- 获取Bot Token;
- 运行配置向导
openclaw onboard - 选择Telegram,粘贴Token完成绑定。
WhatsApp配置
- 运行配置向导,选择WhatsApp;
- 终端生成二维码,打开WhatsApp→设置→扫码登录;
- 建议使用专用账号,避免个人消息进入上下文。
六、健康检查与运维命令
# 全面自检并修复
openclaw doctor --repair
# 查看运行状态
openclaw status
# 重启服务
openclaw restart
# 停止服务
openclaw stop
# 查看日志
openclaw logs
# 重置配置
openclaw config reset
七、费用估算与省钱策略
OpenClaw本体免费,模型调用按量计费:
- 轻度用户(偶尔使用):月均5-15美元;
- 中度用户(日常自动化):月均20-50美元;
- 重度用户(持续任务):月均80-200美元+。
省钱技巧:
- 定期新建会话,减少上下文token消耗;
- 简单任务使用Coding Plan免费额度;
- 在模型控制台设置月度消费上限;
- 本地轻量任务优先低消耗模型。
八、2026常见问题速查
| 报错信息 | 原因 | 解决方案 |
|---|---|---|
| command not found: openclaw | npm全局路径未加入PATH | 重启终端,或手动配置环境变量 |
| Node.js version < 22 | 版本过低 | 升级至22.12.0以上 |
| Port 18789 in use | 端口被占用 | lsof -i :18789 结束占用进程 |
| API Key invalid | 密钥错误/过期 | 重新生成并复制 |
| 面板无法访问 | 绑定地址/防火墙问题 | 改为127.0.0.1,放行端口 |
| 模型调用失败 | 地址/密钥/权限错误 | 核对base_url与api_key,开通权限 |
| 消息渠道连接失败 | Token过期/配置错误 | 重新运行onboard配置 |
| Docker启动异常 | 挂载权限/端口冲突 | 检查目录权限,更换端口 |
| Token认证失败 | 令牌错误/未设置 | 重新生成并配置 |
| 服务无法自启 | 系统服务配置异常 | openclaw onboard --install-daemon |
九、部署完成总结
完成以上步骤后,你已拥有:
- 本地MacOS/Linux/Windows11稳定运行的OpenClaw;
- 阿里云云端24小时在线部署版本;
- 阿里云千问与免费Coding Plan双模型支持;
- 安全加固的本地控制面板与令牌认证;
- Telegram/WhatsApp消息渠道联动能力。
OpenClaw可通过安装Skills扩展文件管理、代码编写、日程安排、数据统计等能力,后续可进一步配置权限策略、任务流与自动化规则,打造专属私人AI助手。