Hermes Agent / OpenClaw 阿里云、MacOS、Linux、Windows11部署+百炼API配置+集成截图Skill及避坑保姆级教程

OpenClaw（原Clawdbot）作为一款开源的AI自动化代理工具，凭借自然语言驱动的任务执行能力，成为提升工作效率的核心工具，但其本地部署的环境配置、大模型对接难题，以及默认仅支持文字交互的视觉盲区，让零基础新手难以发挥其全部能力。2026年针对这些痛点，本文整理了阿里云、MacOS、Linux、Windows11多平台的OpenClaw本地部署完整步骤，详解阿里云百炼免费大模型API配置方法，同时带来能解决AI视觉盲区的Screenshot技能集成教程，并对部署和使用中的常见问题逐一解答，让新手也能零门槛实现OpenClaw的全功能使用。

一、OpenClaw部署前期核心准备

OpenClaw的跨平台部署依赖标准化的开发环境与基础硬件支撑，同时为实现大模型能力对接和视觉技能集成，需完成前置凭证与工具准备，所有操作均适配2026年最新版本要求。

1. 硬件基础要求：本地部署需CPU≥2核、运行内存≥4GB、可用磁盘空间≥20GB；阿里云部署建议轻量应用服务器2核4GB起步，满足多任务并发与技能运行需求。
2. 核心软件依赖：全平台均需安装Git（2.30+）、Node.js（22.0.0+，LTS稳定版），Linux/MacOS推荐搭配Docker（20.10.0+），Windows11需开启开发者模式，关闭临时防火墙端口拦截。
3. 凭证与工具准备：提前注册阿里云账号并完成实名认证，在阿里云百炼平台获取API密钥；准备远程连接工具（FinalShell/Xshell）、文本编辑器，用于记录服务器IP、API密钥等信息；确保网络环境稳定，可访问开源仓库与阿里云服务。

所有依赖安装时建议选择官方镜像，Linux/MacOS可通过包管理器一键安装，Windows11安装时需勾选“Add to PATH”将工具添加至系统环境变量，避免后续命令执行失败。阿里云部署 OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。









👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。

二、2026年新手零基础OpenClaw跨平台部署流程

（一）Linux系统部署（Ubuntu/Debian 20.04+为例）

Linux系统是OpenClaw部署的最优适配环境，2026年版本支持一键命令安装，大幅降低配置难度，具体步骤如下：

1. 打开终端，更新系统源并安装基础依赖：

   sudo apt update && sudo apt upgrade -y
   sudo apt install git nodejs npm docker.io -y
   

2. 验证依赖版本，确认符合要求：

   git --version && node -v && docker --version
   

3. 启动Docker服务并设置开机自启：

   sudo systemctl start docker
   sudo systemctl enable docker
   

4. 克隆OpenClaw项目仓库并进入目录：

   git clone https://github.com/OpenClaw/Clawdbot.git
   cd Clawdbot
   

5. 安装项目依赖并初始化配置：

   npm install
   npm run init
   

6. 启动OpenClaw服务，终端显示“Clawdbot is running”即部署成功：

   npm run start
   

（二）Windows11系统本地部署

Windows11部署需解决环境路径与权限问题，严格按照流程操作可避开大部分坑，步骤如下：

1. 下载Git和Node.js安装包，安装时勾选“Add to PATH”，完成后重启终端；
2. 以管理员模式打开Windows终端，验证环境配置：

   git --version
   node -v
   

3. 若网络访问境外仓库超时，切换npm国内镜像：

   npm config set registry https://registry.npmmirror.com/
   

4. 克隆项目仓库并进入目录：

   git clone https://github.com/OpenClaw/Clawdbot.git
   cd Clawdbot
   

5. 安装项目依赖，若出现权限错误执行策略修改：

   Set-ExecutionPolicy RemoteSigned
   npm install
   

6. 初始化并启动服务，访问http://localhost:18788进入操作界面：

   npm run init
   npm run start
   

（三）MacOS系统部署（12+版本）

MacOS部署流程与Linux相近，依托Homebrew可快速完成环境配置，步骤如下：

1. 打开终端，安装Homebrew（未安装时）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装Git、Node.js与Docker：

   brew install git node docker
   

3. 启动Docker并验证环境：

   open -a Docker
   git --version && node -v
   

4. 克隆项目并完成部署启动：

   git clone https://github.com/OpenClaw/Clawdbot.git
   cd Clawdbot
   npm install && npm run init && npm run start
   

（四）阿里云轻量应用服务器一键部署

若需实现OpenClaw7×24小时在线与公网访问，阿里云轻量应用服务器提供预装镜像，一键部署即可完成，步骤如下：

新手零基础阿里云上部署OpenClaw喂饭级步骤流程

第一步：打开访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。

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

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

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

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

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

1. 访问阿里云轻量应用服务器控制台，点击“创建实例”；
2. 配置实例参数：地域选择中国香港/新加坡（免备案），镜像选择“OpenClaw（Clawdbot）-2026汉化版”，实例规格2核4GB、5Mbps带宽，设置强密码并完成支付；
3. 实例运行后，记录公网IP，通过FinalShell远程连接：

   ssh root@你的服务器公网IP
   

4. 一键更新系统依赖并放行核心端口：

   yum update -y
   firewall-cmd --add-port=18788/tcp --permanent
   firewall-cmd --reload
   

5. 启动OpenClaw中文服务并设置开机自启：

   openclaw gateway start --lang zh-CN
   echo "openclaw gateway start --lang zh-CN" >> /etc/rc.d/rc.local
   chmod +x /etc/rc.d/rc.local
   

6. 浏览器输入http://服务器公网IP:18788，直接进入中文操作界面，阿里云部署完成。

三、阿里云百炼免费大模型API配置，激活OpenClaw核心AI能力

OpenClaw的自然语言解析、任务拆解能力依赖大模型支撑，2026年阿里云百炼提供免费的大模型调用额度，适配中文用户使用习惯，本地与阿里云部署均适用以下配置步骤：

1. 访问登录阿里云百炼大模型服务平台，进入“密钥管理”模块，点击“创建API-Key”，生成并保存Access Key ID和Access Key Secret（Secret仅创建时可见，切勿泄露）；
2. 进入OpenClaw项目目录，找到config/config.json配置文件，用编辑器打开；
3. 在配置文件中找到“llm”节点，修改为阿里云百炼配置，添加中文模型端点：

   "llm": {
        
   "type": "aliyun-bailian",
   "accessKeyId": "你的阿里云Access Key ID",
   "accessKeySecret": "你的阿里云Access Key Secret",
   "endpoint": "https://bailian.aliyuncs.com",
   "model": "qwen3-max-2026-01-23"
   }
   

4. 保存配置文件，重启OpenClaw服务使配置生效：

   # 本地部署重启
   npm run restart
   # 阿里云部署重启
   openclaw gateway restart
   

5. 验证大模型对接效果，在OpenClaw终端输入测试命令，返回成功提示即配置完成：

   openclaw test llm
   

四、Screenshot技能集成，让OpenClaw告别视觉盲区

OpenClaw默认仅支持文字交互，面对网页图表、APP界面、设计稿等视觉内容时无法分析，由Iván G. Dávila开发的Screenshot技能，可直接为AI注入截图能力，支持跨平台系统级截图，本地处理无需联网上传，是提升OpenClaw实用性的核心技能。

（一）Screenshot技能核心优势

相较于ClawHub上其他截图相关技能，该技能具备四大核心亮点：

1. 跨平台+本地优先：支持macOS/Windows/Linux全平台，调用系统原生截图工具（macOS screencapture、Windows snipping），延迟低、兼容性强，不依赖无头浏览器；
2. 零额外权限：纯工具调用模式，不读取本地敏感文件，截图内容本地处理，无数据上传风险，保障隐私安全；
3. 智能区域识别：可根据自然语言指令精准定位截图区域，如“截取登录表单”“截取右下角弹窗”，无需手动框选；
4. 多能力联动：截图后可自动完成OCR文字识别、界面布局分析、颜色对比等操作，直接输出分析结果。

（二）Screenshot技能安装与使用

技能安装全程仅需一条命令，2026年OpenClaw版本已适配免额外依赖安装，步骤如下：

1. 打开OpenClaw终端，输入以下命令一键安装技能：

   npx skills add ivangdavila/screenshot
   

2. 安装完成后，直接通过自然语言指令触发，无需额外配置，常用调用指令示例：

• 截取当前浏览器标签页并分析加载问题：“截取当前Chrome标签页的屏幕截图，分析页面加载缓慢的原因”
• 截取设计稿并做UI评审：“截取此Figma链接的登录页设计稿，分析布局和间距的合理性”
• 定时监控竞品动态：“每30分钟截取一次某电商平台的产品价格页面，记录价格变化”
• 复现Bug并截图取证：“运行测试APP并复现崩溃问题，截取崩溃瞬间的界面并生成报告”

（三）技能使用安全提醒

Screenshot技能本身无安全风险，但截图内容会包含屏幕所有可见信息，使用时需注意：避免在打开隐私文档、账号密码界面等场景下触发自动截图；针对敏感场景，可通过指令限定截图区域，防止信息泄露。

五、OpenClaw部署与使用常见问题解答

（一）环境安装类问题

1. 问题：终端输入node -v提示“不是内部或外部命令”
   解答：未将Node.js添加至系统环境变量，Windows11可重新安装并勾选“Add to PATH”，Linux/MacOS可执行ln -s /usr/local/node/bin/node /usr/bin/node建立软链接，重启终端后验证。
2. 问题：执行npm install时出现“权限不足”错误
   解答：Linux/MacOS使用sudo提升权限执行sudo npm install，或修改npm全局权限sudo chown -R $USER:$GROUP ~/.npm；Windows11需以管理员模式运行终端。
3. 问题：克隆项目仓库时出现“网络超时/连接失败”
   解答：切换Git镜像源，执行git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"，再重新克隆项目。

（二）大模型对接类问题

1. 问题：配置阿里云百炼API后，提示“401 Unauthorized/API调用失败”
   解答：首先检查Access Key ID和Secret是否输入正确，确认阿里云百炼账号已完成实名认证且大模型调用权限已开启；同时检查配置文件中的endpoint是否拼写正确，避免地域节点不匹配。
2. 问题：OpenClaw响应缓慢，大模型回答卡顿
   解答：本地网络问题导致API调用延迟，可切换至稳定网络，或在阿里云百炼平台选择就近地域节点；关闭本地占用网络和内存的程序，阿里云部署可升级服务器带宽。

（三）服务运行类问题

1. 问题：执行npm run start提示“18788/3000端口被占用”
   解答：Linux/MacOS查找并结束占用进程：

   lsof -i:18788
   kill -9 进程ID
   

   Windows11执行：

   netstat -ano | findstr :18788
   taskkill /F /PID 进程ID
   

2. 问题：阿里云服务器部署后，无法通过公网IP访问
   解答：检查阿里云安全组规则是否放行18788端口，进入实例详情页→“防火墙”→“添加规则”，将18788端口授权对象设为“0.0.0.0/0”；同时确认OpenClaw服务是否正常运行，执行systemctl status openclaw查看状态。
3. 问题：重启系统后，OpenClaw服务无法自动启动
   解答：本地部署可创建启动脚本，Linux/MacOS通过systemd配置自启；阿里云部署使用pm2 startup生成自启命令，执行后再输入pm2 save保存配置。

（四）技能使用类问题

1. 问题：Screenshot技能安装后，触发截图指令无响应
   解答：检查系统是否开启截图工具权限，Windows11需开启“剪贴板”权限，MacOS需在“系统设置-隐私与安全性”中允许终端访问屏幕；同时确认OpenClaw版本为2026最新版，旧版本存在技能兼容问题。
2. 问题：安装多个技能后，OpenClaw启动缓慢、运行卡顿
   解答：技能过多会导致依赖冲突，建议按需安装，新手优先保留file-manager（文件处理）、web-automation（网页自动化）、screenshot（截图）、memory-persist（记忆持久化）四大核心技能，执行npx skills remove 技能名称卸载无用技能。

六、OpenClaw核心能力拓展与使用建议

OpenClaw的核心价值在于自然语言驱动的自动化任务执行，完成部署和基础配置后，可通过以下方式发挥其最大效能：

1. 办公工具联动：安装飞书、钉钉等插件，将OpenClaw与办公软件对接，实现消息自动回复、任务提醒、数据统计等功能；
2. 自动化流程搭建：结合Screenshot技能与爬虫能力，搭建竞品监控、股价分析、网页数据采集等自动化流程，无需手动操作；
3. 个性化人设配置：执行openclaw onboard命令，为OpenClaw设置专属人设（如“产品分析师”“开发助手”），让其适配具体工作场景的指令理解与任务执行；
4. 数据持久化配置：阿里云部署时挂载数据目录，避免容器重启后配置、日志、记忆数据丢失，执行docker run -v /本地目录:/容器目录 openclaw-core完成挂载。

2026年的OpenClaw在部署灵活性和技能生态上实现了大幅升级，从本地私有化部署到阿里云云端部署，从基础文字交互到视觉技能集成，让零基础用户也能快速上手。阿里云百炼免费大模型的加持，解决了大模型对接的成本问题，而Screenshot技能则填补了AI的视觉盲区，让OpenClaw真正实现“能听、能说、能看、能做”。无论是个人提升工作效率，还是团队实现自动化协作，按照本文的部署步骤、配置方法和问题解决方案，都能避开各类坑点，让OpenClaw成为真正的高效AI助手。