【最新】OpenClaw是什么?OpenClaw能做什么?OpenClaw详细介绍及怎么部署保姆级教程(本地+云端)

简介: 在AI技术从“生成内容”向“落地执行”深度转型的2026年,OpenClaw(前身为Clawdbot、曾用名Moltbot)凭借开源、本地优先、强执行能力的核心优势,成为个人与企业构建“自托管式数字员工”的首选工具。截至2026年3月,其GitHub星标已突破28万,社区贡献者超378人,技能生态覆盖办公、开发、生活等全场景,彻底打破了传统AI“只说不做”的局限,真正实现了从“对话式建议”到“自动化执行”的跨越。

在AI技术从“生成内容”向“落地执行”深度转型的2026年,OpenClaw(前身为Clawdbot、曾用名Moltbot)凭借开源、本地优先、强执行能力的核心优势,成为个人与企业构建“自托管式数字员工”的首选工具。截至2026年3月,其GitHub星标已突破28万,社区贡献者超378人,技能生态覆盖办公、开发、生活等全场景,彻底打破了传统AI“只说不做”的局限,真正实现了从“对话式建议”到“自动化执行”的跨越。
OpenClawo.png

很多新手用户初次接触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一键部署专题页面 了解。
OpenClaw1.png
OpenClaw2.png

(二)OpenClaw与传统工具的核心区别

为了更清晰地理解OpenClaw的定位,我们用一张表格对比它与传统对话式AI、普通自动化工具的差异:

工具类型 核心能力 交互方式 核心价值 自主性
OpenClaw 理解自然语言,自主拆解任务、调用工具,直接执行实际操作 自然语言指令,多渠道触发(Web、飞书、钉钉等) 替代重复劳动,落地执行任务 高(全程无需人工干预)
传统对话式AI 生成文本、方案、代码,提供思路建议,不直接执行操作 被动聊天,需手动落地结果 提供思路,辅助决策 低(仅输出内容,不执行)
普通自动化工具 按预设固定流程执行单一任务,无AI理解能力 手动配置流程,无法灵活适配需求 固定流程自动化,降低操作成本 中(需手动配置,无自主规划)

举个简单的例子:同样是“整理文件夹”,传统AI会告诉你“新建文件夹、分类文件、移动文件”的步骤;普通自动化工具需要你手动配置每一步流程;而OpenClaw只需你发送一句自然语言指令“整理下载文件夹的文件,按文档、图片、视频分类”,就能自动完成所有操作,全程无需你动手。

(三)OpenClaw的核心特性(为什么值得选择)

  1. 开源免费,可自定义扩展:遵循MIT协议,源码完全开源,支持用户根据自身需求修改代码、开发专属技能,无任何付费门槛,适合个人与企业使用;
  2. 本地优先,隐私安全:数据、任务执行全在本地设备或私有云(如阿里云),不上传第三方服务器,敏感信息不泄露,符合个人隐私与企业合规需求;
  3. 全平台兼容,适配性强:完美支持Windows11、MacOS(M系列/Intel芯片)、Linux等本地系统,同时支持阿里云等私有云部署,2vCPU+2GiB内存即可起步,门槛极低;
  4. 模块化技能,功能无限扩展:像装手机App一样,通过ClawHub技能市场安装插件,核心技能覆盖文件管理、信息处理、自动化执行、多渠道对接等,可无限扩展功能边界;
  5. 无缝适配国内模型,体验流畅:与阿里云百炼等国内大模型深度适配,接口兼容无需修改核心代码,搭配阿里云百炼Coding Plan套餐,可实现低成本、高性能的任务执行;
  6. 多渠道交互,便捷性拉满:支持Web控制台、飞书、钉钉等多种渠道发送指令,无需打开专用软件,随时随地指挥“数字员工”干活。

二、OpenClaw能做什么?—— 覆盖全场景的自动化执行能力

OpenClaw的核心能力是“执行”,依托模块化技能生态,它能覆盖个人、职场、企业等多场景的重复劳动,新手只需安装基础技能,就能满足90%的高频需求,具体可分为五大核心场景,每一个场景都能直接落地使用。

(一)办公自动化(职场人必备,解放双手)

这是OpenClaw最常用的场景,能替代职场中80%的重复办公任务,让你聚焦更有价值的核心工作:

  1. 文件管理:自动整理桌面/文件夹、批量重命名文件、格式转换(PDF转Word、图片转PDF等)、提取文件内容,无需手动拖拽;
  2. 报告与纪要:自动生成周报、日报、会议纪要,提取核心要点,甚至能直接发送至指定邮箱,避免手动打字整理;
  3. 邮件与日程:自动分类邮件、回复常见咨询、设置日程提醒、同步审批进度,避免遗漏重要事项;
  4. 批量操作:批量发送邮件、批量修改文档内容、批量处理Excel数据,大幅提升办公效率。

(二)信息处理(效率神器,节省时间)

OpenClaw能自动完成“信息搜集→整理→提炼”的全流程,无需手动复制粘贴:

  1. 网页抓取:自动抓取指定网页的内容、图片、链接,生成结构化文档,适合搜集行业资讯、竞品信息;
  2. 文档处理:总结长文、论文、报告的核心要点,翻译多语言文档,提取PDF/Word中的关键信息,节省阅读时间;
  3. 实时监控:监控指定网页、行业动态、价格变化,一旦出现更新,自动推送提醒(如电商降价、行业政策更新);
  4. 知识管理:搭建本地知识库,智能问答、快速检索,成为你的“活字典”,适合学习、研究场景。

(三)系统与电脑操作(全程自动化,无需手动干预)

OpenClaw能直接操控电脑系统,执行各类系统级操作,彻底解放双手:

  1. 系统维护:自动清理磁盘垃圾、安装/卸载软件、备份重要文件、执行系统脚本,定期维护电脑状态;
  2. 代码辅助:简单代码编写、调试、格式化,生成代码注释,适合开发者提升效率;
  3. 软件操控:自动启动指定软件、执行软件内操作(如自动打开浏览器、登录账号、发送消息);
  4. 跨软件联动:实现不同软件间的自动化联动(如从Excel提取数据,自动填入表单,再发送邮件通知)。

(四)生活场景(贴心助手,便捷生活)

除了办公,OpenClaw还能适配日常生活动场景,解决琐碎小事:

  1. 日程管理:提醒生日、纪念日、重要约会,规划出行路线,预订票务;
  2. 个性化服务:定制每日新闻摘要、生成食谱、辅导学习、翻译外文内容;
  3. 设备管控:控制本地智能设备(如灯光、空调),实现智能家居联动(需搭配对应技能);
  4. 数据整理:整理手机/电脑中的照片、视频,按日期、类型分类,备份至指定位置。

(五)企业与团队协作(降本增效,简化管理)

对于企业和团队而言,OpenClaw能大幅降低沟通成本,提升团队协作效率:

  1. 团队任务管理:自动分发任务、同步工作进度、汇总团队成果,生成团队工作报告;
  2. 多渠道协作:对接飞书、钉钉,自动汇总群消息、生成会议纪要、同步文件,减少跨部门沟通成本;
  3. 共享知识库:搭建团队共享知识库,团队成员可通过自然语言指令快速查询企业资料、规章制度;
  4. 自动化流程:优化企业核心业务流程(如客户咨询自动回复、订单数据自动整理),降低人力成本。

三、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

⚠️ 避坑提醒:

  1. npm安装完成后,若终端提示“openclaw: command not found”,是因为npm全局安装目录未添加到系统PATH,需手动将路径添加到~/.zshrc(MacOS/Linux)或系统环境变量(Windows11);
  2. MacOS M系列芯片用户,若安装失败,执行arch -arm64 brew install node@22,指定ARM架构安装依赖;
  3. Windows用户需以管理员身份运行PowerShell,否则会出现权限不足的报错;
  4. 若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一键部署专题页面,找到并点击【一键购买并部署】。
OpenClaw1.png
OpenClaw2.png
OpenClaw02.png
OpenClaw03.png
OpenClaw04.png

第二步:打开选购阿里云轻量应用服务器,配置参考如下:

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

轻量应用服务器OpenClaw镜像.png
bailian1.png
bailian2.png

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

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

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

阿里云百炼Coding Plan 配置教程:创建API-Key,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
CodingPlan.png

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

方案一:一键脚本部署(新手首选,5分钟完成)

适配阿里云轻量应用服务器特性,脚本自动优化系统配置、安装依赖并启动服务,无需手动干预,新手快速上手。

  1. 服务器选购与基础配置:

    • 访问阿里云轻量应用服务器控制台,选择“Ubuntu 22.04 LTS”系统镜像;
    • 核心配置:2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽,地域优先选择中国香港(免备案)或华东1(杭州),付费类型选“包年包月”;
    • 提交订单后,记录服务器公网IP、默认登录账号(root)与密码,在阿里云控制台“安全组”中,一键放行22(SSH远程端口)、18789(OpenClaw核心端口)、443(API调用端口)。
  2. 一键部署操作(通过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即为部署成功
  1. 远程访问验证:
    • 打开浏览器,输入 http://服务器公网IP:18789,粘贴之前保存的访问令牌,能正常进入OpenClaw Web控制台,即为部署成功;
    • 控制台可直观查看服务状态、配置技能、发送指令,新手可先熟悉界面布局。

方案二:Docker Compose部署(生产环境首选,稳定隔离)

遵循容器化部署最佳实践,通过Docker Compose实现环境隔离、数据持久化与快速升级,适配企业级生产需求,稳定性更强,适合长期运行。

  1. 基础环境配置(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. 创建配置与启动服务:
# 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
  1. 安全加固(可选,企业用户必做):
    • 在阿里云控制台“安全组”中,将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凭证获取步骤(免费,新手必看)

  1. 登录阿里云官网,完成实名认证(个人用户可通过支付宝刷脸即时生效,企业用户需上传资质审核);
  2. 访问订阅阿里云百炼Coding Plan,进入服务订阅页面,选择适合的套餐(新用户可领取90天免费调用额度),完成订阅(RAM子账号需主账号授权);
  3. 进入百炼控制台“密钥管理”页面,点击“创建API Key”,获取专属API Key(格式为sk-sp-xxxxx,与普通百炼Key格式不同,需单独获取);
  4. 记录专属Base URL:https://coding.dashscope.aliyuncs.com/v1(OpenAI兼容协议,必须使用该地址,否则无法抵扣免费额度);
  5. 保存好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配置验证与避坑要点

  1. 验证方法:打开OpenClaw Web控制台,输入自然语言指令:“帮我整理~/Downloads文件夹的文件,按文档、图片、视频分类,删除空文件夹”;若OpenClaw返回“任务已执行,已创建分类文件夹,共整理XX个文件”,且本地/服务器对应文件夹已完成整理,即为配置成功;
  2. 避坑要点:
    • 凭证混用: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. 问题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. 问题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. 问题3:Docker部署后,容器启动失败,日志提示“权限不足”?

    • 原因:挂载目录权限不足,Docker无法读写配置与日志文件;
    • 解决方案:赋予挂载目录权限,执行sudo chmod -R 775 /opt/openclaw(阿里云/Linux),然后重启容器(docker compose restart openclaw)。

2. API与模型类问题

  1. 问题1:百炼API调用提示“密钥无效”或“鉴权失败”?

    • 解决方案:① 逐字符核对API Key,确保为sk-sp-xxxxx前缀格式,与普通百炼Key区分开;② 登录百炼控制台,确认密钥未过期、未被禁用;③ 重新创建密钥并更新配置文件;④ 检查Base URL是否正确,确保与密钥地域一致。
  2. 问题2:调用模型时,回复内容为空,无任何反馈?

    • 原因:未在模型配置中添加"reasoning": false,国内模型不支持默认的思考模式;
    • 解决方案:编辑openclaw.json,在models数组中添加"reasoning": false,重启网关生效;若仍为空,检查API Key是否正确,是否有剩余额度。

3. 技能与实战类问题

  1. 问题1:技能安装提示“依赖缺失”或“安装失败”?

    • 解决方案:① 查看技能详情(openclaw skills info 技能名),确认缺失的依赖;② 安装依赖(Python库用pip3 install 依赖名);③ 国内用户用清华源加速(pip3 install 依赖名 --index-url=https://pypi.tuna.tsinghua.edu.cn/simple);④ 验证Node.js版本是否兼容。
  2. 问题2:飞书/钉钉无法指挥OpenClaw,机器人不响应?

    • 解决方案:① 核对飞书/钉钉App ID与App Secret,确保配置正确;② 确保机器人已添加到群聊,且拥有发送消息的权限;③ 查看技能日志(openclaw skills logs feishu),排查报错;④ 重启网关,重新配置技能。

五、总结

本文围绕“OpenClaw是什么、能做什么、怎么部署”三大核心问题,结合2026年最新实测经验与阿里云专属指南,详细拆解了OpenClaw的核心定位、全场景功能、阿里云+本地全系统部署流程,以及API配置与常见问题解答,所有代码可直接复制执行,全程无冗余信息,不改变核心原意,助力新手快速上手。

核心要点回顾:

  1. OpenClaw是什么:一款开源、本地优先的AI自动化代理引擎,是“自托管式数字员工”,能理解自然语言指令并自主执行任务,区别于传统对话式AI与普通自动化工具;
  2. OpenClaw能做什么:覆盖办公自动化、信息处理、系统操作、生活场景、团队协作五大核心场景,替代重复劳动,提升效率;
  3. 怎么部署:支持阿里云(一键脚本、Docker)与本地(Windows11/MacOS/Linux)部署,部署前需完成基础工具安装,配置阿里云百炼API即可激活核心能力;
  4. 关键避坑:Node.js版本≥22.0.0,百炼API需正确配置凭证与Base URL,国内模型必须添加reasoning: false,安全第一,慎用第三方技能。

通过本文的教程,你可轻松搭建属于自己的OpenClaw“数字员工”,无论是个人办公、生活服务,还是企业团队协作,都能实现“解放双手,效率倍增”。

目录
相关文章
|
13天前
|
人工智能 JavaScript Ubuntu
5分钟上手龙虾AI!OpenClaw部署(阿里云+本地)+ 免费多模型配置保姆级教程(MiniMax、Claude、阿里云百炼)
OpenClaw(昵称“龙虾AI”)作为2026年热门的开源个人AI助手,由PSPDFKit创始人Peter Steinberger开发,核心优势在于“真正执行任务”——不仅能聊天互动,还能自动处理邮件、管理日程、订机票、写代码等,且所有数据本地处理,隐私完全可控。它支持接入MiniMax、Claude、GPT等多类大模型,兼容微信、Telegram、飞书等主流聊天工具,搭配100+可扩展技能,成为兼顾实用性与隐私性的AI工具首选。
19739 108
|
5天前
|
人工智能 安全 Linux
【OpenClaw保姆级图文教程】阿里云/本地部署集成模型Ollama/Qwen3.5/百炼 API 步骤流程及避坑指南
2026年,AI代理工具的部署逻辑已从“单一云端依赖”转向“云端+本地双轨模式”。OpenClaw(曾用名Clawdbot)作为开源AI代理框架,既支持对接阿里云百炼等云端免费API,也能通过Ollama部署本地大模型,完美解决两类核心需求:一是担心云端API泄露核心数据的隐私安全诉求;二是频繁调用导致token消耗过高的成本控制需求。
4168 7
|
7天前
|
人工智能 安全 API
OpenClaw“小龙虾”进阶保姆级攻略!阿里云/本地部署+百炼API配置+4种Skills安装方法
很多用户成功部署OpenClaw(昵称“小龙虾”)后,都会陷入“看似能用却不好用”的困境——默认状态下的OpenClaw更像一个聊天机器人,缺乏连接外部工具、执行实际任务的能力。而Skills(技能插件)作为OpenClaw的“动手能力核心”,正是打破这一局限的关键:装对Skills,它能帮你自动化处理流程、检索全网资源、管理平台账号,真正变身“能做事的AI管家”。
5033 7
|
9天前
|
人工智能 安全 前端开发
Team 版 OpenClaw:HiClaw 开源,5 分钟完成本地安装
HiClaw 基于 OpenClaw、Higress AI Gateway、Element IM 客户端+Tuwunel IM 服务器(均基于 Matrix 实时通信协议)、MinIO 共享文件系统打造。
7668 5
|
8天前
|
人工智能 API 网络安全
Mac mini × OpenClaw 保姆级配置教程(附阿里云/本地部署OpenClaw配置百炼API图文指南)
Mac mini凭借小巧机身、低功耗和稳定性能,成为OpenClaw(原Clawdbot)本地部署的首选设备——既能作为家用AI节点实现7×24小时运行,又能通过本地存储保障数据隐私,搭配阿里云部署方案,可灵活满足“长期值守”与“隐私优先”的双重需求。对新手而言,无需复杂命令行操作,无需专业技术储备,按本文步骤复制粘贴代码,即可完成OpenClaw的全流程配置,同时接入阿里云百炼API,解锁更强的AI任务执行能力。
6302 2
|
17天前
|
人工智能 自然语言处理 JavaScript
2026年Windows+Ollama本地部署OpenClaw保姆级教程:本地AI Agent+阿里云上快速搭建
2026年OpenClaw凭借本地部署、私有化运行的特性,成为打造个人智能体的核心工具,而Ollama作为轻量级本地大模型管理工具,能让OpenClaw摆脱对云端大模型的依赖,实现**本地推理、数据不泄露、全流程私有化**的智能体验。本文基于Windows 11系统,从硬件环境准备、Ollama安装与模型定制、OpenClaw部署配置、技能扩展到常见问题排查,打造保姆级本地部署教程,同时补充阿里云OpenClaw(Clawdbot)快速部署步骤,兼顾本地私有化需求与云端7×24小时运行需求,文中所有代码命令均可直接复制执行,确保零基础用户也能快速搭建属于自己的本地智能体。
18975 116
|
11天前
|
人工智能 JSON API
保姆级教程:OpenClaw阿里云及本地部署+模型切换流程+GLM5.0/Seedance2.0/MiniMax M2.5接入指南
2026年,GLM5.0、Seedance2.0、MiniMax M2.5等旗舰大模型相继发布,凭借出色的性能与极具竞争力的成本优势,成为AI工具的热门选择。OpenClaw作为灵活的AI Agent平台,支持无缝接入这些主流模型,通过简单配置即可实现“永久切换、快速切换、主备切换”三种模式,让不同场景下的任务执行更高效、更稳定。
6977 4
|
11天前
|
人工智能 JavaScript API
保姆级教程:OpenClaw阿里云/本地部署配置Tavily Search skill 实时联网,让OpenClaw“睁眼看世界”
默认状态下的OpenClaw如同“闭门造车”的隐士,仅能依赖模型训练数据回答问题,无法获取实时新闻、最新数据或训练截止日期后的新信息。2026年,激活其联网能力的最优方案是配置Tavily Search技能——无需科学上网、无需信用卡验证,每月1000次免费搜索额度完全满足个人需求,搭配ClawHub技能市场,还能一键拓展天气查询、邮件管理等实用功能。
6995 5

热门文章

最新文章