在AI技术从“生成内容”向“落地执行”深度转型的2026年,OpenClaw(前身为Clawdbot、曾用名Moltbot)凭借开源、本地优先、强执行能力的核心优势,成为个人与企业构建“自托管式数字员工”的首选工具。截至2026年3月,其GitHub星标已突破28万,社区贡献者超378人,技能生态覆盖办公、开发、生活等全场景,彻底打破了传统AI“只说不做”的局限,真正实现了从“对话式建议”到“自动化执行”的跨越。
很多新手用户初次接触OpenClaw,都会产生三个核心疑问:OpenClaw到底是什么?它能帮我们做什么?在本地设备(Windows11/MacOS/Linux)和阿里云上该怎么部署?本文基于2026年OpenClaw最新稳定版(v2026.3.8),整合官方规范、全网实测经验与阿里云专属部署指南,逐一解答这三大核心问题,全程包含可直接复制的代码命令,不添加冗余信息,不改变核心原意,助力新手1-2小时内从“入门”到“上手”,轻松搭建专属AI自动化引擎。
一、OpenClaw是什么?—— 不止于聊天的“自托管式数字员工”
很多人会将OpenClaw与传统对话式AI混淆,实则二者有着本质区别。简单来说,OpenClaw是一款遵循MIT协议的开源、本地优先的AI自动化代理引擎,它以自然语言指令为驱动,在本地或私有云环境中完成各类真实任务,是面向个人与企业的“自托管式数字员工”,而非单纯的聊天工具。
(一)OpenClaw的核心定位
OpenClaw的核心价值的在于“理解指令+自主执行”,它就像一个24小时待命的全能员工,能直接读写文件、控制浏览器、执行脚本、对接API,甚至通过飞书、钉钉等多种渠道接收指令,完成从“意图解析→任务规划→工具调用→结果反馈”的全闭环。
需要明确的是,OpenClaw(原Clawdbot、Moltbot)本质是同一套AI框架,仅为不同迭代阶段的名称变更,核心功能、配置流程与命令操作完全一致,部署与API配置时无需区分,仅需注意部分旧版本配置文件中可能保留“clawdbot”“moltbot”进程名,不影响配置效果与功能使用。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

(二)OpenClaw与传统工具的核心区别
为了更清晰地理解OpenClaw的定位,我们用一张表格对比它与传统对话式AI、普通自动化工具的差异:
| 工具类型 | 核心能力 | 交互方式 | 核心价值 | 自主性 |
|---|---|---|---|---|
| OpenClaw | 理解自然语言,自主拆解任务、调用工具,直接执行实际操作 | 自然语言指令,多渠道触发(Web、飞书、钉钉等) | 替代重复劳动,落地执行任务 | 高(全程无需人工干预) |
| 传统对话式AI | 生成文本、方案、代码,提供思路建议,不直接执行操作 | 被动聊天,需手动落地结果 | 提供思路,辅助决策 | 低(仅输出内容,不执行) |
| 普通自动化工具 | 按预设固定流程执行单一任务,无AI理解能力 | 手动配置流程,无法灵活适配需求 | 固定流程自动化,降低操作成本 | 中(需手动配置,无自主规划) |
举个简单的例子:同样是“整理文件夹”,传统AI会告诉你“新建文件夹、分类文件、移动文件”的步骤;普通自动化工具需要你手动配置每一步流程;而OpenClaw只需你发送一句自然语言指令“整理下载文件夹的文件,按文档、图片、视频分类”,就能自动完成所有操作,全程无需你动手。
(三)OpenClaw的核心特性(为什么值得选择)
- 开源免费,可自定义扩展:遵循MIT协议,源码完全开源,支持用户根据自身需求修改代码、开发专属技能,无任何付费门槛,适合个人与企业使用;
- 本地优先,隐私安全:数据、任务执行全在本地设备或私有云(如阿里云),不上传第三方服务器,敏感信息不泄露,符合个人隐私与企业合规需求;
- 全平台兼容,适配性强:完美支持Windows11、MacOS(M系列/Intel芯片)、Linux等本地系统,同时支持阿里云等私有云部署,2vCPU+2GiB内存即可起步,门槛极低;
- 模块化技能,功能无限扩展:像装手机App一样,通过ClawHub技能市场安装插件,核心技能覆盖文件管理、信息处理、自动化执行、多渠道对接等,可无限扩展功能边界;
- 无缝适配国内模型,体验流畅:与阿里云百炼等国内大模型深度适配,接口兼容无需修改核心代码,搭配阿里云百炼Coding Plan套餐,可实现低成本、高性能的任务执行;
- 多渠道交互,便捷性拉满:支持Web控制台、飞书、钉钉等多种渠道发送指令,无需打开专用软件,随时随地指挥“数字员工”干活。
二、OpenClaw能做什么?—— 覆盖全场景的自动化执行能力
OpenClaw的核心能力是“执行”,依托模块化技能生态,它能覆盖个人、职场、企业等多场景的重复劳动,新手只需安装基础技能,就能满足90%的高频需求,具体可分为五大核心场景,每一个场景都能直接落地使用。
(一)办公自动化(职场人必备,解放双手)
这是OpenClaw最常用的场景,能替代职场中80%的重复办公任务,让你聚焦更有价值的核心工作:
- 文件管理:自动整理桌面/文件夹、批量重命名文件、格式转换(PDF转Word、图片转PDF等)、提取文件内容,无需手动拖拽;
- 报告与纪要:自动生成周报、日报、会议纪要,提取核心要点,甚至能直接发送至指定邮箱,避免手动打字整理;
- 邮件与日程:自动分类邮件、回复常见咨询、设置日程提醒、同步审批进度,避免遗漏重要事项;
- 批量操作:批量发送邮件、批量修改文档内容、批量处理Excel数据,大幅提升办公效率。
(二)信息处理(效率神器,节省时间)
OpenClaw能自动完成“信息搜集→整理→提炼”的全流程,无需手动复制粘贴:
- 网页抓取:自动抓取指定网页的内容、图片、链接,生成结构化文档,适合搜集行业资讯、竞品信息;
- 文档处理:总结长文、论文、报告的核心要点,翻译多语言文档,提取PDF/Word中的关键信息,节省阅读时间;
- 实时监控:监控指定网页、行业动态、价格变化,一旦出现更新,自动推送提醒(如电商降价、行业政策更新);
- 知识管理:搭建本地知识库,智能问答、快速检索,成为你的“活字典”,适合学习、研究场景。
(三)系统与电脑操作(全程自动化,无需手动干预)
OpenClaw能直接操控电脑系统,执行各类系统级操作,彻底解放双手:
- 系统维护:自动清理磁盘垃圾、安装/卸载软件、备份重要文件、执行系统脚本,定期维护电脑状态;
- 代码辅助:简单代码编写、调试、格式化,生成代码注释,适合开发者提升效率;
- 软件操控:自动启动指定软件、执行软件内操作(如自动打开浏览器、登录账号、发送消息);
- 跨软件联动:实现不同软件间的自动化联动(如从Excel提取数据,自动填入表单,再发送邮件通知)。
(四)生活场景(贴心助手,便捷生活)
除了办公,OpenClaw还能适配日常生活动场景,解决琐碎小事:
- 日程管理:提醒生日、纪念日、重要约会,规划出行路线,预订票务;
- 个性化服务:定制每日新闻摘要、生成食谱、辅导学习、翻译外文内容;
- 设备管控:控制本地智能设备(如灯光、空调),实现智能家居联动(需搭配对应技能);
- 数据整理:整理手机/电脑中的照片、视频,按日期、类型分类,备份至指定位置。
(五)企业与团队协作(降本增效,简化管理)
对于企业和团队而言,OpenClaw能大幅降低沟通成本,提升团队协作效率:
- 团队任务管理:自动分发任务、同步工作进度、汇总团队成果,生成团队工作报告;
- 多渠道协作:对接飞书、钉钉,自动汇总群消息、生成会议纪要、同步文件,减少跨部门沟通成本;
- 共享知识库:搭建团队共享知识库,团队成员可通过自然语言指令快速查询企业资料、规章制度;
- 自动化流程:优化企业核心业务流程(如客户咨询自动回复、订单数据自动整理),降低人力成本。
三、OpenClaw部署全流程:阿里云+本地(Windows11/MacOS/Linux)
OpenClaw支持两种核心部署方式:阿里云部署(适合7×24小时稳定运行、多设备访问、团队共享)和本地部署(适合隐私要求高、功能测试、个人使用)。两种部署方式均提供详细步骤和可复制代码,新手可根据自身需求选择,全程保姆级指导,一次成功。
(一)部署前必做准备(所有部署方式通用,避免踩坑)
无论选择哪种部署方式,都需要先完成以下基础准备,确保后续操作顺畅,所有准备均为免费获取或简单配置:
1. 设备与环境要求
内存是核心硬性要求,低于4GB会导致服务启动失败,各部署方式的具体要求如下:
| 部署方式 | 最低配置 | 推荐配置 | 系统要求 | 核心依赖 |
|---|---|---|---|---|
| 阿里云轻量服务器 | 2vCPU+2GiB内存+40GiB ESSD | 个人:2vCPU+4GiB内存+40GiB ESSD;企业:4vCPU+8GiB内存+80GiB ESSD | Ubuntu 22.04 LTS、Alibaba Cloud Linux 3.2104 LTS | 阿里云百炼API密钥、Docker |
| Windows11本地 | 4GiB内存+20GiB磁盘空间 | 8GiB内存+30GiB磁盘空间 | Windows11 64位(21H2及以上) | Node.js≥v22.0.0、Python≥3.9、Git、Docker Desktop |
| MacOS本地 | 4GiB内存+20GiB磁盘空间 | 8GiB内存+30GiB磁盘空间 | MacOS 12及以上(M系列/Intel芯片) | Homebrew、Node.js≥v22.0.0、Git、Docker |
| Linux本地 | 4GiB内存+20GiB磁盘空间 | 8GiB内存+30GiB磁盘空间 | Ubuntu 22.04+ 64位、CentOS 7/8等 | curl、Git、Python≥3.9、Node.js≥v22.0.0、Docker |
2. 必备凭证与工具
- 核心凭证:阿里云账号(注册阿里云账号 并完成实名认证,用于服务器购买与百炼API开通)、阿里云百炼Coding Plan API Key(访问订阅阿里云百炼Coding Plan,新用户可领90天免费额度)及专属Base URL;
- 辅助工具:SSH远程工具(FinalShell,用于阿里云服务器登录,新手可使用阿里云控制台WebShell替代)、系统终端(Windows11:PowerShell管理员模式;MacOS/Linux:原生终端)、文本编辑器(VS Code、记事本、Nano)、加密记事本(存储API Key、Token等敏感凭证);
- 可选工具:飞书/钉钉账号(多渠道控制用)、Ollama(本地模型部署用)、GitHub账号(自定义技能安装用)。
3. 基础工具安装(全系统通用,必做)
基础工具是部署OpenClaw的前提,所有命令可直接复制执行,避免手动安装出错:
# 1. 安装Node.js(推荐v22+,确保兼容性,避免版本过低导致部署失败)
# Windows11(PowerShell,管理员模式)
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y
# MacOS(终端)
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# Linux/Ubuntu(终端)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 2. 验证Node.js版本(显示v22+即为成功)
node -v
# 3. 安装核心工具(Git、pnpm,技能管理与依赖安装必备)
# Windows11
winget install Git.Git -y
npm install -g pnpm
# MacOS/Linux
brew install git # MacOS
sudo apt install git -y # Linux
npm install -g pnpm
# 4. 安装Docker(容器化部署必备,官方推荐,稳定性更强)
# Windows11:下载Docker Desktop并安装,开启“以管理员身份运行”(官网:https://www.docker.com/products/docker-desktop/)
# MacOS
brew install docker --cask
open -a Docker # 启动Docker,等待启动完成(Docker图标不再跳动)
# Linux/Ubuntu
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker
sudo systemctl enable docker
# 5. 配置国内镜像,加速依赖下载(解决国内下载缓慢、超时问题)
# npm/pnpm镜像
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com
# Docker镜像加速(Linux/MacOS,Windows11在Docker Desktop中设置)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://registry.cn-hangzhou.aliyuncs.com", "https://docker.mirrors.ustc.edu.cn"]}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
# 6. 验证工具安装(显示版本号即为成功)
git --version && pnpm --version && docker --version
⚠️ 避坑提醒:
- npm安装完成后,若终端提示“openclaw: command not found”,是因为npm全局安装目录未添加到系统PATH,需手动将路径添加到~/.zshrc(MacOS/Linux)或系统环境变量(Windows11);
- MacOS M系列芯片用户,若安装失败,执行
arch -arm64 brew install node@22,指定ARM架构安装依赖; - Windows用户需以管理员身份运行PowerShell,否则会出现权限不足的报错;
- 若Node.js版本过低,可通过以下代码升级:
# MacOS/Linux升级Node.js至22版本(使用nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# Windows PowerShell升级Node.js至22版本
iwr -useb https://get.nvm.sh | iex
nvm install 22
nvm use 22
(二)阿里云部署(长期运行首选,新手易上手)
阿里云为2026版OpenClaw打造了专属一键部署方案,通过预置镜像、简化流程设计,彻底打破技术门槛,无需用户掌握编程技能,同时提供一键脚本部署与Docker部署两种方式,适配不同需求。
阿里云用户零基础部署 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,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
- 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。

- 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。

- 在服务器概览页面单击应用详情页签,进入服务器详情页面。

- 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。

- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。

- 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。


方案一:一键脚本部署(新手首选,5分钟完成)
适配阿里云轻量应用服务器特性,脚本自动优化系统配置、安装依赖并启动服务,无需手动干预,新手快速上手。
服务器选购与基础配置:
- 访问阿里云轻量应用服务器控制台,选择“Ubuntu 22.04 LTS”系统镜像;
- 核心配置:2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽,地域优先选择中国香港(免备案)或华东1(杭州),付费类型选“包年包月”;
- 提交订单后,记录服务器公网IP、默认登录账号(root)与密码,在阿里云控制台“安全组”中,一键放行22(SSH远程端口)、18789(OpenClaw核心端口)、443(API调用端口)。
一键部署操作(通过FinalShell或阿里云WebShell远程连接服务器):
# 1. SSH连接服务器(替换为你的服务器公网IP,按提示输入密码)
ssh root@你的服务器公网IP
# 2. 执行阿里云专属一键部署脚本(国内优化版,自动处理依赖与配置)
curl -fsSL https://openclaw.ai/aliyun-install.sh | bash
# 3. 按向导完成核心配置(新手直接按默认选择,无需修改)
# 关键步骤提示:
# 1. 风险提示:按左方向键选择Yes,回车确认
# 2. 绑定地址:0.0.0.0:18789(默认,支持远程访问)
# 3. 模型选择:暂时选择“Custom Provider”(后续配置阿里云百炼API)
# 4. 通讯平台:选择Skip for now(后续按需添加)
# 5. 技能配置:选择No(后续单独安装核心技能)
# 6. 认证设置:自动生成访问令牌(Token),复制保存好,登录Web控制台需用
# 4. 验证部署与开机自启(确保服务器重启后服务不中断)
systemctl status openclaw # 显示active(running)即为服务正常
systemctl enable openclaw # 设置开机自启
curl http://127.0.0.1:18789/api/v1/health # 返回healthy即为部署成功
- 远程访问验证:
- 打开浏览器,输入
http://服务器公网IP:18789,粘贴之前保存的访问令牌,能正常进入OpenClaw Web控制台,即为部署成功; - 控制台可直观查看服务状态、配置技能、发送指令,新手可先熟悉界面布局。
- 打开浏览器,输入
方案二:Docker Compose部署(生产环境首选,稳定隔离)
遵循容器化部署最佳实践,通过Docker Compose实现环境隔离、数据持久化与快速升级,适配企业级生产需求,稳定性更强,适合长期运行。
- 基础环境配置(SSH远程连接服务器):
# 1. 登录服务器(替换为你的公网IP)
ssh root@你的服务器公网IP
# 2. 安装Docker与Docker Compose(若已安装可跳过)
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo apt install docker-compose-plugin -y
sudo systemctl start docker && sudo systemctl enable docker
# 3. 验证Docker安装(显示版本号即为成功)
docker --version && docker compose version
- 创建配置与启动服务:
# 1. 创建项目目录(用于存储配置、日志与数据,实现持久化)
mkdir -p /opt/openclaw && cd /opt/openclaw
# 2. 编写docker-compose.yml文件(直接复制,无需修改)
cat > docker-compose.yml << EOF
version: "3.8"
services:
openclaw:
image: openclaw/openclaw:2026-latest # 2026最新稳定版镜像
container_name: openclaw
ports:
- "18789:18789" # 映射核心端口
volumes:
- openclaw-data:/root/.openclaw # 配置与数据持久化
- /var/log/openclaw:/var/log/openclaw # 日志持久化
- /tmp:/tmp # 挂载临时目录,支持文件操作
restart: unless-stopped # 异常自动重启
command: ["openclaw", "gateway", "run"]
network_mode: bridge
environment:
- TZ=Asia/Shanghai # 时区设置(避免时间异常)
- GATEWAY_MODE=remote # 支持远程访问
- GATEWAY_BIND=0.0.0.0:18789
volumes:
openclaw-data:
EOF
# 3. 启动容器(后台运行)
docker compose up -d
# 4. 初始化配置(设置访问令牌,替换为你的高强度密码)
docker compose exec openclaw openclaw config set gateway.auth.token "your-secret-token"
# 5. 查看日志,确认启动成功(无报错即为正常)
docker compose logs -f
- 安全加固(可选,企业用户必做):
- 在阿里云控制台“安全组”中,将18789端口访问来源限制为企业内网IP或个人常用IP,避免恶意访问;
- 定期更新Docker镜像,执行
docker pull openclaw/openclaw:2026-latest && docker compose restart openclaw,修复安全漏洞。
(三)本地部署(Windows11+MacOS+Linux,隐私优先)
本地部署适合功能测试、数据隐私要求较高的场景,所有数据存储在本地设备,无需依赖云服务器,各系统部署流程略有差异,以下为详细步骤。
1. Windows11本地部署(兼容适配,新手易上手)
系统要求:Windows11 64位(21H2及以上)、8GB+内存、20GB+可用空间,关闭第三方杀毒软件(避免误删文件)
# 1. 管理员模式打开PowerShell,解决执行策略限制(避免命令无法执行)
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
# 2. 安装核心依赖(Git、Python,若已安装可跳过)
winget install Git.Git -y
winget install Python.Python.3.10 -y
# Docker需手动下载安装:https://www.docker.com/products/docker-desktop/,安装后启动
# 3. 安装Node.js与pnpm(若已安装可跳过)
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y
npm install -g pnpm
# 4. 克隆OpenClaw仓库(国内镜像加速,避免下载缓慢)
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw
# 5. 安装项目依赖(若报错,先执行npm cache clean --force)
npm cache clean --force
rm -rf node_modules package-lock.json
pnpm install
# 6. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard # 交互式初始化配置(按默认选择即可)
node dist/cli.js gateway run --bind 0.0.0.0:18789
# 7. 生成访问令牌(登录WebUI用,复制保存)
node dist/cli.js token generate --admin
关键配置与避坑:
- 将
C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表,避免技能文件被误判为病毒; - 访问方式:浏览器输入
http://localhost:18789,粘贴令牌登录; - 若启动失败,检查18789端口是否被占用,执行
netstat -ano | findstr 18789,终止占用进程后重新启动; - 若出现权限不足报错,执行
npm install -g openclaw-cn --unsafe-perm。
2. MacOS本地部署(体验最佳,官方推荐)
系统要求:MacOS 12+(M系列/Intel芯片)、8GB+内存、20GB+可用空间
# 1. 安装Homebrew(国内镜像加速,若已安装可跳过)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
# 2. 安装核心依赖(Git、Python、Docker)
brew install git python@3.10 node@22 docker --cask
open -a Docker # 启动Docker,等待启动完成(Docker图标不再跳动)
# 3. 配置Node.js环境变量(避免命令无法识别)
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 4. 安装pnpm
npm install -g pnpm
# 5. 克隆OpenClaw仓库(国内镜像加速)
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw
# 6. 安装项目依赖
pnpm install
# 7. 构建并启动服务(后台运行,不占用终端)
pnpm ui:build && pnpm build
node dist/cli.js onboard
nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &
# 8. 生成访问令牌(登录WebUI用,复制保存)
node dist/cli.js token generate --admin
M系列芯片避坑:若安装失败,执行arch -arm64 brew install node@22,指定ARM架构安装依赖;若Docker启动失败,检查MacOS系统版本是否符合要求(需MacOS 12+)。
3. Linux本地部署(Ubuntu 22.04 LTS,稳定性强)
系统要求:Ubuntu 22.04 LTS、8GB+内存、20GB+可用空间
# 1. 更新系统依赖(确保系统组件最新,避免依赖冲突)
sudo apt update && sudo apt upgrade -y
# 2. 安装核心工具与依赖
sudo apt install curl git python3-pip -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g pnpm
# 3. 安装Docker(若已安装可跳过)
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker && sudo systemctl enable docker
# 4. 配置Swap空间(解决内存不足问题,必做)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# 5. 配置Git国内镜像(避免源码下载缓慢)
git config --global url."https://gitee.com/".insteadOf "https://github.com/"
git config --global http.sslVerify false
# 6. 克隆OpenClaw仓库(国内镜像加速)
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw
# 7. 安装项目依赖
pnpm install
# 8. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard
node dist/cli.js gateway run --bind 0.0.0.0:18789
# 9. 生成访问令牌(登录WebUI用,复制保存)
node dist/cli.js token generate --admin
访问方式:浏览器输入 http://localhost:18789,粘贴令牌登录;若需远程访问,需放行18789端口,执行sudo ufw allow 18789/tcp && sudo ufw enable。
(四)阿里云百炼Coding Plan API配置(核心步骤,免费可用)
OpenClaw本身不具备大模型能力,需对接外部模型才能实现“意图解析、任务规划”的核心功能——简单来说,OpenClaw是“数字员工”的身体,而大模型是“数字员工”的大脑。阿里云百炼Coding Plan凭借免费额度、国内节点稳定性、与OpenClaw的无缝适配,成为普通人与企业的最优选择,新用户可领取90天免费调用额度,完全满足日常使用需求。
1. API凭证获取步骤(免费,新手必看)
- 登录阿里云官网,完成实名认证(个人用户可通过支付宝刷脸即时生效,企业用户需上传资质审核);
- 访问订阅阿里云百炼Coding Plan,进入服务订阅页面,选择适合的套餐(新用户可领取90天免费调用额度),完成订阅(RAM子账号需主账号授权);
- 进入百炼控制台“密钥管理”页面,点击“创建API Key”,获取专属API Key(格式为
sk-sp-xxxxx,与普通百炼Key格式不同,需单独获取); - 记录专属Base URL:
https://coding.dashscope.aliyuncs.com/v1(OpenAI兼容协议,必须使用该地址,否则无法抵扣免费额度); - 保存好API Key与Base URL,建议存储在加密记事本中,避免泄露。
2. OpenClaw对接百炼Coding Plan API(全环境通用)
配置步骤全平台一致,只需修改配置文件并重启网关,所有命令可直接复制执行:
# 1. 编辑OpenClaw配置文件(不同系统打开方式不同)
# Windows11(PowerShell)
notepad $env:USERPROFILE\.openclaw\openclaw.json
# MacOS/Linux/阿里云
nano ~/.openclaw/openclaw.json
# 2. 添加百炼Coding Plan配置(替换为你的API Key,其他参数无需修改)
{
"models": {
"providers": {
"bailian-coding": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"apiKey": "你的Coding Plan API Key", # 替换为你获取的API Key
"api": "openai-completions",
"models": [
{
"id": "qwen3.5-coding",
"name": "百炼Coding Plan Qwen3.5",
"contextWindow": 32768,
"maxTokens": 4096,
"reasoning": false # 国内模型必设,否则回复为空,新手必看!
}
]
}
},
"default": "bailian-coding/qwen3.5-coding" # 设置百炼为默认模型
},
"tools": {
"agentCommunication": {
"enabled": true,
"allowCrossAgent": true
}
}
}
# 3. 保存文件后,重启网关使配置生效(不同部署方式重启命令不同)
# 阿里云/Linux(脚本/源码部署)
openclaw gateway restart
# 阿里云/Linux(Docker部署)
docker compose restart openclaw
# MacOS
pkill -f openclaw && nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &
# Windows11(PowerShell)
Stop-Process -Name node -Force
node dist/cli.js gateway run --bind 0.0.0.0:18789
3. API配置验证与避坑要点
- 验证方法:打开OpenClaw Web控制台,输入自然语言指令:“帮我整理~/Downloads文件夹的文件,按文档、图片、视频分类,删除空文件夹”;若OpenClaw返回“任务已执行,已创建分类文件夹,共整理XX个文件”,且本地/服务器对应文件夹已完成整理,即为配置成功;
- 避坑要点:
- 凭证混用:Coding Plan API Key前缀为sk-sp-,与普通百炼Key格式不同,混用会导致鉴权失败,提示“API Key无效”;
- 接口地址错误:必须使用专属Base URL(https://coding.dashscope.aliyuncs.com/v1),使用其他地址会无法抵扣免费额度,提示“额度不足”;
- 未设置reasoning:国内模型(包括百炼)必须添加
"reasoning": false,否则模型无法正常响应,回复为空; - 配置不生效:修改配置文件后,必须重启网关(Docker部署需重启容器),否则参数无法加载;
- 额度不足:若提示“百炼API额度不足”,登录百炼控制台查看剩余额度,领取免费套餐或充值,也可减少上下文长度,降低Token消耗。
四、部署后必做:核心技能安装与常见问题解答
(一)核心技能安装(全环境通用,落地即用)
部署与API配置完成后,需安装核心技能才能解锁OpenClaw的全部能力。新手无需盲目安装,优先选择安装量高、维护频繁的基础技能,先跑通1-2个场景,再逐步扩展:
# 1. 安全类技能(必装,保障系统安全)
clawhub install skill-vetter # 技能安全扫描器,检测第三方技能是否恶意
# 2. 办公自动化类(职场高频)
clawhub install file-manager # 文件管理技能(整理、分类、格式转换)
clawhub install office-automation # 办公自动化(生成报表、会议纪要)
clawhub install email-handler # 邮件处理(分类、发送、回复)
# 3. 信息处理类(效率神器)
clawhub install web-scraper # 网页抓取(搜集资料、监控数据)
clawhub install document-summarizer # 文档总结(提炼要点、翻译)
clawhub install web-search # 联网搜索(实时信息查询)
# 4. 通讯集成类(多渠道控制)
clawhub install feishu-integration # 飞书集成(手机指挥OpenClaw)
clawhub install dingtalk-integration # 钉钉集成(团队协作必备)
# 验证技能安装
openclaw skills list
(二)常见问题解答(解决90%的新手问题)
1. 部署类问题
问题1:OpenClaw启动提示“Node.js版本过低”?
- 解决方案:执行
node -v验证版本,确保≥22.0.0;Linux/MacOS用sudo npm install -g n && sudo n 22.2.0升级,Windows重新运行Node.js安装命令(winget install OpenJS.NodeJS.LTS --version 22.2.0 -y);升级后重启网关。
- 解决方案:执行
问题2:Web控制台无法访问,提示“无法连接”或“端口超时”?
- 原因:端口被占用、服务未启动、防火墙/安全组未放行端口;
- 解决方案:
① 检查18789端口是否被占用(Windows:netstat -ano | findstr 18789;Linux/MacOS:lsof -i:18789),终止占用进程;
② 重启网关服务(openclaw gateway restart),确认服务状态为“running”;
③ 阿里云部署:检查安全组是否放行18789端口;本地部署:关闭防火墙或添加端口例外;
④ 确认网关绑定地址为0.0.0.0:18789,而非127.0.0.1(仅本地可访问)。
问题3:Docker部署后,容器启动失败,日志提示“权限不足”?
- 原因:挂载目录权限不足,Docker无法读写配置与日志文件;
- 解决方案:赋予挂载目录权限,执行
sudo chmod -R 775 /opt/openclaw(阿里云/Linux),然后重启容器(docker compose restart openclaw)。
2. API与模型类问题
问题1:百炼API调用提示“密钥无效”或“鉴权失败”?
- 解决方案:① 逐字符核对API Key,确保为sk-sp-xxxxx前缀格式,与普通百炼Key区分开;② 登录百炼控制台,确认密钥未过期、未被禁用;③ 重新创建密钥并更新配置文件;④ 检查Base URL是否正确,确保与密钥地域一致。
问题2:调用模型时,回复内容为空,无任何反馈?
- 原因:未在模型配置中添加
"reasoning": false,国内模型不支持默认的思考模式; - 解决方案:编辑openclaw.json,在models数组中添加
"reasoning": false,重启网关生效;若仍为空,检查API Key是否正确,是否有剩余额度。
- 原因:未在模型配置中添加
3. 技能与实战类问题
问题1:技能安装提示“依赖缺失”或“安装失败”?
- 解决方案:① 查看技能详情(
openclaw skills info 技能名),确认缺失的依赖;② 安装依赖(Python库用pip3 install 依赖名);③ 国内用户用清华源加速(pip3 install 依赖名 --index-url=https://pypi.tuna.tsinghua.edu.cn/simple);④ 验证Node.js版本是否兼容。
- 解决方案:① 查看技能详情(
问题2:飞书/钉钉无法指挥OpenClaw,机器人不响应?
- 解决方案:① 核对飞书/钉钉App ID与App Secret,确保配置正确;② 确保机器人已添加到群聊,且拥有发送消息的权限;③ 查看技能日志(
openclaw skills logs feishu),排查报错;④ 重启网关,重新配置技能。
- 解决方案:① 核对飞书/钉钉App ID与App Secret,确保配置正确;② 确保机器人已添加到群聊,且拥有发送消息的权限;③ 查看技能日志(
五、总结
本文围绕“OpenClaw是什么、能做什么、怎么部署”三大核心问题,结合2026年最新实测经验与阿里云专属指南,详细拆解了OpenClaw的核心定位、全场景功能、阿里云+本地全系统部署流程,以及API配置与常见问题解答,所有代码可直接复制执行,全程无冗余信息,不改变核心原意,助力新手快速上手。
核心要点回顾:
- OpenClaw是什么:一款开源、本地优先的AI自动化代理引擎,是“自托管式数字员工”,能理解自然语言指令并自主执行任务,区别于传统对话式AI与普通自动化工具;
- OpenClaw能做什么:覆盖办公自动化、信息处理、系统操作、生活场景、团队协作五大核心场景,替代重复劳动,提升效率;
- 怎么部署:支持阿里云(一键脚本、Docker)与本地(Windows11/MacOS/Linux)部署,部署前需完成基础工具安装,配置阿里云百炼API即可激活核心能力;
- 关键避坑:Node.js版本≥22.0.0,百炼API需正确配置凭证与Base URL,国内模型必须添加
reasoning: false,安全第一,慎用第三方技能。
通过本文的教程,你可轻松搭建属于自己的OpenClaw“数字员工”,无论是个人办公、生活服务,还是企业团队协作,都能实现“解放双手,效率倍增”。