OpenClaw本地部署：阿里云百炼如何搭建AI代理？
2026年，AI代理工具OpenClaw让大模型从“聊天”走向“执行”。本文详解如何在本地（推荐WSL2）一键部署OpenClaw，对接阿里云百炼API，并通过浏览器技能自动抓取网页数据。涵盖核心概念解析、避坑指南及实战案例，助你低成本搭建隐私可控的个人AI助理。
为什么你需要一个能“干活”的AI助理
要是你还把大模型当成高级搜索框或者闲聊对象，那2026年这波AI应用的门槛，你可能还没踩到。方向已经很清楚：AI正从“对话式交互”往“任务执行式交互”走。
OpenClaw正是这个方向上的一个样本。它并非普通聊天机器人，更像一名“数字员工”，能接上本地环境、第三方工具和网络服务。
拿个直观场景说：你想把某技术论坛的热门内容整理出来。老办法是问AI“怎么整理”，它回你一堆建议；OpenClaw则能直接调起浏览器技能，自己打开网页、抓数据、清格式、出表格。全程你不用手动复制粘贴。
对个人开发者或极客而言，OpenClaw放在本地跑，有三个实打实的好处：
- 数据隐私：交互逻辑和文件处理都留在本地或你自己的服务器上，敏感数据不用往第三方平台传。
- 能力扩展：借助ClawHub社区，装各种技能（Skills）就像给手机装App，管文件、发邮件、调企业API都行。
- 低门槛试错：硬件要求很低，旧笔记本或低配云服务器都跑得动。再配上阿里云百炼这类平台的免费额度，上手成本几乎为零。
下面就从零讲起，把核心概念捋清，把本地部署做完，再让它真正跑起来干活。
先搞懂这四个核心概念
不少新手部署失败，原因在于没弄明白OpenClaw各组件之间是什么关系。花两分钟看懂下面四点，80%的坑能绕过去。
OpenClaw：大脑与调度中心
OpenClaw（前身是Clawdbot/Moltbot）是整个系统的核心。你的自然语言指令由它接收，意图由它解析，然后再调度对应技能去执行。
要留意，OpenClaw自己并不具备大模型推理能力。它像个空架子，得接上外部大模型API（比如阿里云百炼、OpenAI）才会“思考”。配置API-Key之所以是必选项，原因就在这里。
Gateway：后台管家
Gateway是OpenClaw的后台进程，也是你要长期挂着的服务。Web控制台连接靠它维持，技能状态靠它监控，API请求也由它处理。Gateway一挂，你的AI助理就“离线”了。
Skills：手脚
Skills是模块化的功能插件，OpenClaw干活全靠它。常见的有：
agent-browser无头浏览器，用来访问网页、抓取数据。file-manager管理本地文件。email-sender自动发送邮件。
缺了Skills，OpenClaw就只能陪你聊天，实事一件也干不了。
ClawHub：技能市场
ClawHub是官方维护的技能仓库，社区贡献的Skills有数千个。可以把它当成应用商店，装所需功能用简单命令就行，代码不用自己写。
动手之前，环境和凭证得先备齐。
硬件与系统
OpenClaw对硬件的要求很低，官方给出的推荐配置是：
- CPU 1 核及以上就够，配置低只会拖慢执行速度。
- 内存建议 2GB 以上，不到 1GB 的话，Gateway 可能起不来。
- 磁盘留出 20GB，Node.js、技能文件和日志都要占地方。
- 系统方面可选 Linux（Ubuntu 20.04+）、macOS（12+）或 Windows 11（WSL2）。
这里有个要紧的提醒：Windows 原生系统在 Node.js 子进程和文件路径上存在兼容性问题，端口被占、技能调不起来都很常见。Windows 用户最好装上 WSL2（Windows Subsystem for Linux 2），这是目前在 Windows 下跑 OpenClaw 最稳妥的路子。
接下来解决大模型的凭证问题。
你得有一个大模型 API-Key。国内用户多半会选阿里云百炼，两个原因：网络稳定，不用科学上网；新用户一般还能拿到免费额度。
- 先去注册阿里云账号，完成实名认证。
- 然后进“百炼大模型控制台”，在“密钥管理”里创建 API-Key。
- Key 只显示一次，复制后要收好。
习惯 OpenAI 的用户也能配它的 API-Key，只是网络环境和付费得自己留意。OpenClaw 兼容 OpenAI 接口格式，配置时改一下 Base URL 就行。
环境预检
正式开工前，打开终端（Windows Terminal/WSL2/macOS 终端），先确认两件事。
一是网络连通性：
ping dashscope.aliyuncs.com -c 4这条得通，不然之后的 API 调用都会失败。
二是端口占用情况。OpenClaw 默认走 18789 端口，查一下有没有被占：
# macOS/Linux/WSL2 lsof -i:18789输出为空就说明端口闲着，可以继续往下走。
部署本身分五步，靠的是一键安装脚本。
对新手来说，这是最省事的办法。
第一步，执行安装命令。
在终端里运行：
curl -fsSL https://openclaw.ai/install.sh | bash脚本会自己识别系统、装好 Node.js（版本需 ≥22.0.0）、配好环境变量，再把 Gateway 启动起来。整个过程大概 2-3 分钟。
当提示 How do you want to hatch your bot? 时，输入 1之后选择打开 Web UI。装好以后，终端会给出 Gateway 进程 ID 和 Web UI 地址（通常是http://localhost:18789）。
2. 配置 API-Key
装好之后，OpenClaw 还只是个“空脑”。模型得自己接，Web UI 和命令行两条路都能配。
方法一：在 Web UI 里配（推荐）
- 浏览器访问
http://localhost:18789。 - 进 Settings -> Model Providers -> Add Provider。
- 阿里云百炼的参数这样填：
- Name 填 bailian
- API Type 选 openai-completions
- API Key 填你自己的阿里云百炼 API-Key
- Base URL:
https://dashscope.aliyuncs.com/compatible-mode/v1
- 存下来，再去 Models 页面把模型加上：
- ID 写 qwen-turbo
- Provider 选 bailian
- 然后把它设成默认模型。
方法二：走命令行
服务器上没有图形界面的话，这种办法更合适：
openclaw config set models.providers.bailian.apiKey "你的API-Key"
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
openclaw config set models.providers.bailian.type "openai-completions"
openclaw config set models.default "bailian/qwen-turbo"
openclaw restart3. 验证安装
跑下面这条命令看状态：
openclaw version
openclaw status
openclaw doctor如果 openclaw doctor每一项前面都是绿色对勾，就说明部署成了。
实战：让 AI 助理去抓网页数据
到这一步，可以让 OpenClaw 干点实事了。比如每天盯一下开源中国（oschina.net）的热门项目。
1. 先确认技能可用
在 Web UI 的聊天框里敲：
展示当前可用的Skills看看列表里有没有agent-browser要是没有，就执行openclaw skills install agent-browser 安装。
2. 下达指令
把具体指令输入进去：
用agent-browser技能访问开源中国首页（oschina.net），抓取“热门项目”板块的项目名称、简介和今日Star数，整理成Markdown表格返回。3. 观察执行
执行进度会由OpenClaw逐项显示出来：先解析指令，再匹配技能，接着启动浏览器、访问网页、抓取数据，最后整理结果。这一套流程走完大概需要10-15秒。
4. 查看结果
返回的结果会以类似下面这样的表格呈现：
| 项目名称 | 项目简介 | 今日Star |
|---|---|---|
| AI-Native-IDE | 面向AI编程的原生IDE... | 256 |
| RustDesk | 开源远程桌面软件... | 189 |
需要留意的是，最终结果跟网页结构、网络状况都有关系。万一失败，可以打开openclaw logs gateway里的日志来排查问题。
常见坑与解决方案
1. command not found
原因有两类：环境变量没有生效，或者Node.js根本没装。解决办法是先执行
- 运行
source ~/.bashrc（或~/.zshrc把环境变量重新载入。 - 然后再查一下Node.js的版本：
node -v如果发现没装，就重跑安装脚本，或者手动装上Node.js 22+。
2. Invalid API Key
原因可能是Key复制时出了错、里面带了空格，或者账号还没做实名认证。处理办法如下：
- 重新复制一遍Key，确认没有夹带多余字符。
- 到阿里云控制台看一下Key的状态。
- 同时核对Base URL是不是
https://dashscope.aliyuncs.com/compatible-mode/v1。 - 也可以用curl测一下Key能不能用：
curl https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 你的API-Key" \ -d '{"model": "qwen-turbo", "messages": [{"role": "user", "content": "你好"}]}'
3. 端口无法访问
原因通常是Gateway没起来、被防火墙拦了，或者端口被别的程序占了。可以这样处理：
- 运行
openclaw status先确认Gateway正在运行。 - 如果是在Linux下，把端口开放出来：
ufw allow 18789/tcp。 - 端口要是被别的程序占了，就去改
~/.openclaw/openclaw.json里的端口设置，改完再重启服务。
4. 提示 Skill not found
出现这种情况，要么是技能压根没装，要么是名字写错了。处理办法：
- 运行
openclaw skills list执行 - 运行
openclaw skills reload刷新列表。 - 先看看已经装了哪些技能。
agent-browser而非agent_browser）。
再核对技能名有没有写对，比如
5. Windows 原生部署失败
安全提醒
原因是兼容性太差。办法是先把原生版本卸掉，装好 WSL2，再到 WSL2 的 Ubuntu 环境里重新部署一遍。Windows 下只推荐这一种做法。
- OpenClaw 的 Skills 能读写本地文件，也能联网。用的时候得留个心眼：
- 像文件管理这类高权限技能，别轻易让它碰系统盘。
- 来路不明的第三方 Skills 不要随手装。
结语
API-Key 要定期换，免得泄漏。
走完这些步骤，你手上就有了一个本地运行、隐私自己掌控、还能真正动手干活的 AI 助理。跟在线聊天工具比，OpenClaw 的长处是能插进工作流里，把那些重复的活儿替你干掉。接下来可以去 ClawHub 里翻翻更多技能，或者把 OpenClaw 放到云服务器上，让它 7×24 小时挂着。AI 代理的时代已经来了，动手试一次，你会发现它比想的更好用。
