一、前言
2026年4月,OpenClaw(原Clawdbot)凭借可扩展的Skills技能体系,成为主流的本地/云端AI数字员工平台,能实现任务自动化、流程编排与多场景协作。很多新手因部署流程不清晰、端口配置错误、模型API对接失败、Skills安装混乱,导致服务无法正常运行。本文基于最新官方实践,提供阿里云计算巢一键部署、本地MacOS/Linux/Windows11全平台安装、阿里云千问/Coding Plan模型配置、Skills安全集成、新手避坑指南,所有命令可直接复制,零基础也能快速搭建稳定可用的OpenClaw服务。
二、OpenClaw核心价值与Skills体系
OpenClaw不是简单的对话工具,而是可自定义、可持久化、可扩展的AI助理,核心能力由Skills(技能) 决定。Skills是标准化的任务执行脚本,无需编写复杂代码,安装后即可让AI完成文档处理、信息检索、工作流编排、消息中转等专业任务,大幅提升效率。阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
(一)Skills核心分类
- 基础能力类:搜索、文本总结、文档解析、代码生成,满足日常信息处理需求。
- 协作通道类:钉钉/企业微信接入、消息收发、远程指令,实现多端交互。
- 自动化流程类:工作流串联、批量处理、定时任务,解放重复劳动。
- 安全工具类:技能扫描、风险检测、权限管控,保障部署安全。
(二)Skills安装方式(零基础首选)
- 命令行安装:一行命令完成,适合批量操作。
- 对话安装:直接在OpenClaw面板发送技能链接,自动安装。
- 手动安装:离线环境使用,复制技能文件夹到指定目录。
三、2026年4月阿里云计算巢部署OpenClaw(零代码,新手首选)
阿里云计算巢提供官方认证OpenClaw模板,无需手动配置环境,3-5分钟即可完成部署,适合7×24小时稳定运行、远程访问的场景。
(一)部署前准备
- 注册阿里云账号并完成实名认证,确保账号无欠费。
- 提前获取阿里云百炼API Key(用于千问模型对接),格式为
sk-xxxx。 - 准备服务器登录密码(包含字母、数字、特殊符号,提高安全性)。
(二)计算巢实例创建(核心步骤)
- 登录阿里云控制台,访问阿里云计算巢OpenClaw社区版部署页面,点击「立即部署」。
- 基础配置(新手无需修改,直接沿用默认):
- 实例名称:自定义(如Claw-Cloud-01)。
- 地域选择:中国香港、新加坡、美国弗吉尼亚(内地地域访问大模型API受限,必避坑)。
- 实例规格:2核4GiB、40GB ESSD(最低2GiB内存,低于此配置易启动失败)。
- 镜像:OpenClaw 2026稳定版(预装Node.js 22、所有依赖)。
- 网络:默认公网IP,无需修改。
- 应用配置(必改项):
- 粘贴阿里云百炼API Key,严禁复制空格/换行。
- 主模型:默认
alibaba-cloud/qwen3-max-2026(通义千问最新版,适配所有功能)。 - 管理员Token:选择自动生成,部署后复制保存。
- 确认部署,等待3-5分钟,实例状态变为「运行中」,复制公网IP与管理员Token。
(三)端口放行(关键避坑)
OpenClaw默认使用18789端口提供Web服务,必须放行,否则无法访问面板:
- 进入实例详情→「应用详情」→「端口放通」。
- 点击「一键放通」,选择TCP协议,端口填写
18789,策略「允许」,保存生效。 - 若一键放通失败,手动添加防火墙规则:
# 远程连接服务器后执行 firewall-cmd --permanent --add-port=18789/tcp firewall-cmd --reload firewall-cmd --list-ports
(四)服务器初始化与服务启动(命令直接复制)
- 进入实例详情→「远程连接」→「Web终端」,输入登录密码。
- 执行以下命令,完成最终初始化、ClawHub安装与服务启动:
# 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客户端(Skills扩展必备) npm install -g clawhub-cli # 5. 后台启动网关服务(支持Web访问与模型调用) openclaw gateway start --daemon # 6. 验证服务状态(输出running即为成功) openclaw gateway status - 访问Web面板:
http://你的公网IP:18789?token=你的管理员Token,登录即可使用。
(五)阿里云轻量服务器部署(备选方案,新手友好)
若已有阿里云轻量应用服务器,无需重新购买,直接重置系统部署:
- 进入轻量服务器控制台→目标实例→「更多」→「重置系统」。
- 选择「应用镜像」→「OpenClaw(Clawdbot) 2026稳定版」,确认重置(注意备份数据)。
- 重置完成后,执行上述端口放行与初始化命令,流程与计算巢一致。
零基础部署 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 的地址。


四、本地全平台部署OpenClaw(MacOS/Linux/Windows11)
本地部署适合隐私敏感、无公网需求、低延迟使用的用户,支持三平台统一流程,无需云资源。
(一)前置准备(所有平台通用)
- 硬件要求:内存≥4GB,磁盘剩余空间≥20GB。
- 依赖:Node.js 22+、Git、Docker(Windows需WSL2支持)。
- 配置国内npm镜像,加速安装:
npm config set registry https://registry.npmmirror.com
(二)MacOS部署流程
- 打开终端,安装命令行工具(已安装可跳过):
xcode-select --install - 一键安装OpenClaw(自动配置环境):
curl -fsSL https://openclaw.ai/install.sh | bash - 初始化并安装守护进程:
openclaw onboard --install-daemon - 启动网关服务:
openclaw gateway start - 访问本地面板:
http://127.0.0.1:18789。
(三)Linux(Ubuntu/Debian)部署流程
- 更新系统并安装依赖:
sudo apt update && sudo apt upgrade -y sudo apt install -y curl git nodejs npm docker.io - 升级Node.js至22+:
sudo npm install -g n && sudo n 22.0.0 - 一键安装OpenClaw:
curl -fsSL https://openclaw.ai/install.sh | bash - 初始化并放行端口:
openclaw onboard --install-daemon sudo ufw allow 18789/tcp sudo ufw reload - 启动服务并验证:
openclaw gateway start openclaw gateway status
(四)Windows11部署流程(基于WSL2,必选)
- 管理员身份打开PowerShell,启用WSL2:
wsl --install wsl --set-default-version 2 - 安装Ubuntu分发版,启动后执行以下命令:
# 安装依赖 sudo apt update && sudo apt install -y curl git nodejs npm # 一键安装OpenClaw curl -fsSL https://openclaw.ai/install.sh | bash # 初始化 openclaw onboard --install-daemon # 启动服务 openclaw gateway start - 本地访问面板:
http://127.0.0.1:18789。
五、大模型API配置(阿里云千问 + 免费Coding Plan)
(一)阿里云千问大模型配置(高性能首选)
- 进入阿里云百炼控制台→「API Key管理」→创建并复制Key。
- 编辑OpenClaw配置文件(云端/本地路径一致):
cd ~/.openclaw nano openclaw.json - 写入千问配置(直接替换对应段落):
"models": { "default": "bailian/qwen3-max-2026", "providers": { "bailian": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "你的千问APIKey", "models": [ { "id":"qwen3-max-2026","maxTokens":65536}, { "id":"qwen3.5-plus","maxTokens":8192} ] } } } - 重启服务生效:
openclaw gateway restart
(二)免费Coding Plan模型配置(低成本备用)
- 进入阿里云百炼Coding Plan专区,领取免费套餐并获取API Key。
- 编辑同一份配置文件,增加Coding Plan节点:
"models": { "default": "coding-plan/coding-free", "providers": { "coding-plan": { "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "apiKey": "你的Coding Plan APIKey", "models": [{ "id":"coding-free","maxTokens":4096}] } } } - 重启服务:
openclaw gateway restart
六、OpenClaw Skills安全集成(新手必装清单)
(一)Skills安装核心命令(直接复制)
# 安装ClawHub安全扫描工具(必装,防范恶意技能)
clawhub install skill-vetter
# 搜索技能
clawhub search 关键词
# 安装单个技能
clawhub install 技能名
# 查看已安装技能
clawhub list
# 扫描技能风险
clawhub vet 技能名
# 卸载技能
clawhub remove 技能名
# 更新所有技能
clawhub update --all
(二)新手必装安全Skills(无风险,覆盖核心场景)
# 安全扫描(必装)
clawhub install skill-vetter
# 全局搜索
clawhub install search
# 文档解析(PDF/Word/Excel)
clawhub install document-parser
# 文本总结
clawhub install summarize
# 工作流编排
clawhub install workflow
# 钉钉接入(可选)
clawhub install dingtalk-connector
# 邮件助手
clawhub install email-assistant
# 日程管理
clawhub install calendar
# 代码生成
clawhub install code-generator
# 系统健康检查
clawhub install healthcheck
(三)钉钉接入配置(实战示例)
- 安装钉钉接入技能:
clawhub install dingtalk-connector - 配置钉钉应用凭证(替换为你的Client ID/Secret):
openclaw config set channels.dingtalk.clientId "你的钉钉Client ID" openclaw config set channels.dingtalk.clientSecret "你的钉钉Client Secret" - 重启服务生效:
openclaw gateway restart - 完成钉钉机器人创建与授权,即可通过钉钉发送指令。
七、新手零基础避坑指南(全平台通用)
(一)部署阶段避坑
- 地域选择错误:内地地域无法正常调用阿里云大模型API,必须选择中国香港、新加坡、美国弗吉尼亚。
- 内存配置不足:实例内存低于2GiB会导致OpenClaw启动失败,新手至少选择2核4GiB。
- 端口未放行:18789端口是Web服务核心,必须手动放行,否则无法访问面板。
- API Key格式错误:粘贴时严禁包含空格、换行,否则模型对接失败。
- Windows原生部署失败:Windows必须通过WSL2部署,不支持原生裸跑。
(二)运行阶段避坑
- 服务启动失败:执行
openclaw logs -f查看日志,排查依赖缺失或端口占用问题。 - 模型不回复:检查API Key是否正确、账户是否开通百炼服务、地域是否匹配。
- Skills不生效:安装后必须执行
openclaw gateway restart重启服务,否则无法加载。 - 恶意技能风险:安装前必用
clawhub vet扫描,优先安装官方/高下载量技能。 - 权限不足:Linux/macOS执行命令时需加
sudo,Windows需管理员权限。
(三)常见问题排查命令
# 查看服务状态
openclaw gateway status
# 实时查看日志
openclaw logs -f
# 测试模型连接
openclaw model test
# 重置配置
openclaw config reload
# 系统健康检查
openclaw doctor
# 重启服务
openclaw gateway restart
八、总结
2026年4月,OpenClaw的部署已实现计算巢零代码一键部署、本地三平台统一安装、Skills一键集成的全流程标准化。无论是云端稳定运行还是本地隐私部署,配合阿里云千问高性能模型或Coding Plan免费模型,再搭配安全的Skills技能体系,新手只需按本文步骤操作,即可快速搭建专属AI数字员工,实现从“手动操作”到“自动化执行”的效率升级。
核心原则:先装安全扫描工具、再装核心技能、严格遵循配置规范、及时排查端口与模型问题,即可长期稳定使用OpenClaw,把重复工作交给AI,专注高价值事务。