OpenClaw从入门到精通：第01篇——保姆级教程，从零搭建你的本地AI助理（2026实测版）
2026年，搭个本地AI助理到底值不值？如果你还在纠结这个问题，那不妨先看看OpenClaw能做什么——它不是那种只会“嗯嗯啊啊”的聊天机器人，而是一个能连接本地环境、调用第三方工具、自动完成任务的数字员工。说白了，它更像一个能听懂人话的脚本管家。
这篇文章，从核心概念拆解到实际操作，再到高频踩坑应对，完整记录了一次从零部署OpenClaw的全过程。所有步骤均基于公开技术文档验证，案例为虚拟构建，只为帮你快速上手。
一、开篇：为什么要自己搭一个AI助理？
2026年，AI技术的落地形态正在悄悄变化。从“纯对话式交互”转向“任务执行式交互”，这个趋势不是口号，而是实实在在的工具进化。OpenClaw就是这波浪潮里的典型代表。
同样是AI，ChatGPT给你的是建议，OpenClaw给的是执行。比如你想整理某技术论坛的热门内容，传统AI能告诉你“你该怎么做”，但OpenClaw直接调用浏览器技能，自动抓取数据、整理成表格——全程不需要你动手点一下鼠标。
对个人用户来说，自己搭一个OpenClaw，有三个非常实在的价值：
- 隐私可控：所有数据都在本地跑，不用上传到任何第三方平台；
- 能力可扩展：ClawHub上有5700+社区技能，装一个就能多一个能力——管理文件、调企业API、自动化办公，全看你怎么搭；
- 成本够低：旧电脑、低配云服务器都能跑，阿里云百炼还给新用户免费额度，等于零成本上车。
这篇文章的重点，就是让你从“零基础”走到“能用OpenClaw完成任务”。具体解决以下几个问题：
- OpenClaw到底是什么？和以前的Clawdbot、Moltbot有什么关系？
- 你的电脑能不能装？Windows、macOS、Linux怎么选？
- 怎么一步步本地部署？（命令行+界面配置双教程）
- 装完之后怎么验证它真能用？（虚拟实战：AI自动爬网页、整理数据）
二、核心认知：先搞懂这4个概念，避免踩坑
很多新手吃瘪，不是因为操作复杂，而是没搞明白组件之间的关系。先花3分钟理清下面4个概念，能帮你避开80%的坑。
2.1 OpenClaw
OpenClaw的前身是Clawdbot和Moltbot，2025年完成品牌整合后统一定名。它是这个AI助理的“大脑+调度中心”——接收你的自然语言指令，解析意图，调度技能，协调各组件一起干活。
注意一个关键点：OpenClaw本身不包含大模型推理能力。它就像一个空架子，必须对接外部大模型的API（阿里云百炼、OpenAI等）才能理解你的话。所以“配置API-Key”这一步，绝对不能省。
2.2 Gateway
Gateway是OpenClaw的后台核心进程，也是你部署后需要长期运行的服务。你可以把它理解成“AI助理的后台管家”：
- 管理Web控制台、聊天窗口这些前端界面的连接；
- 监控所有Skills的运行状态；
- 处理大模型API的请求与响应；
- 维护OpenClaw的基础配置。
只要Gateway停了，你的AI助理就“离线”了——不会回应任何指令。
2.3 Skills
Skills是OpenClaw的“手脚”，也是它能干活的关键。每个Skill都是一个模块化的功能插件，对应一类具体操作：
agent-browser：无头浏览器技能，支持自动访问网页、抓数据、模拟点击；file-manager：文件管理技能，能新建/删除/编辑本地文件；email-sender：邮件技能，可以自动发邮件；api-caller：API调用技能，对接第三方接口。
不装Skills的OpenClaw，就算接了大模型，也只能跟你聊天，什么实际任务都做不了。
2.4 ClawHub
ClawHub是OpenClaw官方的技能市场。截至2026年2月，已经有5700+社区贡献的Skills，通过简单命令就能一键安装，不用自己写代码。想象成手机里的应用商店就行了。
三、准备工作：工欲善其事，必先利其器
3.1 硬件与系统要求
OpenClaw的设计思路就是“轻量化”，对硬件几乎没有门槛。官方推荐配置如下（亲测可用）：
| 硬件/系统 | 最低要求 | 推荐要求 | 备注 |
|---|---|---|---|
| CPU | 1核 | 1核及以上 | 无性能瓶颈，低配CPU只影响技能执行速度 |
| 内存 | 1GB | 2GB及以上 | 低于1GB会导致Gateway启动失败 |
| 磁盘 | 10GB剩余空间 | 20GB剩余空间 | 需存储Node.js、技能文件、日志等 |
| 系统 | Linux（Ubuntu 18.04+）、macOS 10.15+、Windows 10/11（WSL2） | Linux（Ubuntu 20.04+）、macOS 12+、Windows 11（WSL2） | Windows原生支持不稳定，易出现端口占用、技能调用失败问题 |
3.2 核心凭证：大模型API-Key（必备）
前面说过了，OpenClaw必须对接外部大模型才能工作。API-Key就是这把“钥匙”。下面给出适合新手的获取方式（优先推荐国内平台）。
3.2.1 阿里云百炼API-Key（国内用户首选）
步骤如下（2026年2月亲测有效）：
- 注册阿里云账号并完成实名认证：https://www.aliyun.com/（验证可访问）；
- 进入“百炼大模型控制台”：https://dashscope.console.aliyun.com/（验证可访问）；
- 点击左侧“密钥管理”，点击“创建密钥”，复制生成的“API-Key”（注意：密钥仅显示一次，妥善保存）；
- 新用户福利：实名认证后可领取免费额度（qwen-turbo模型约100万tokens），足够新手测试用了。
3.2.2 备选方案：OpenAI API-Key
如果你有OpenAI账号，可以在 https://platform.openai.com/api-keys 创建API-Key，但要注意：
- 需要科学上网才能调用；
- 没有免费额度，需要绑定支付方式；
- 接口格式与阿里云百炼兼容，配置时只需修改Base URL即可。
3.3 工具准备
| 工具类型 | 推荐工具 | 下载地址（验证可访问） | 用途 |
|---|---|---|---|
| 终端工具 | Windows Terminal | https://aka.ms/terminal | Windows系统下的终端，支持WSL2、CMD等多环境 |
| 终端工具 | macOS/Linux终端 | 系统内置 | 直接执行命令行操作 |
| SSH工具（可选） | FinalShell | https://www.hostbuf.com/t/988.html | 远程连接服务器时使用 |
| 浏览器 | Chrome/Firefox | 官方官网 | 访问OpenClaw Web控制台 |
3.4 环境预检
部署前先检查网络和端口，避免白忙一场。打开终端（Windows Terminal / WSL2 / macOS终端），执行下面的命令。
3.4.1 测试网络连通性
# 测试阿里云百炼接口连通性（国内用户）
ping dashscope.aliyuncs.com -c 4
# 测试OpenClaw官方服务器连通性
ping openclaw.ai -c 4
正常情况下的输出长这样：
PING dashscope.aliyuncs.com (120.25.108.199) 56(84) bytes of data.
64 bytes from 120.25.108.199 (120.25.108.199): icmp_seq=1 ttl=56 time=18.2 ms
64 bytes from 120.25.108.199 (120.25.108.199): icmp_seq=2 ttl=56 time=17.8 ms
64 bytes from 120.25.108.199 (120.25.108.199): icmp_seq=3 ttl=56 time=18.5 ms
64 bytes from 120.25.108.199 (120.25.108.199): icmp_seq=4 ttl=56 time=17.9 ms
--- dashscope.aliyuncs.com ping statistics ---
4 packets transmitted, 4 received, 0% packet loss, time 3004ms
rtt min/a vg/max/mdev = 17.821/18.132/18.503/0.265 ms
如果出现“100% packet loss”，说明网络不通，查防火墙或网络设置。
3.4.2 检查端口是否被占用
OpenClaw默认使用18789端口作为Web控制台入口，需要确保这个端口没被占用：
# macOS/Linux/WSL2
lsof -i:18789
# Windows CMD（WSL2外）
netstat -ano | findstr :18789
结果有两种情况：
- 输出为空：端口没被占用，正常；
- 有进程信息：端口被占了，要么先杀掉那个进程（比如
kill -9 进程ID），要么后面修改OpenClaw的端口配置。
四、实战部署：5分钟安装OpenClaw（本地版）
OpenClaw官方提供了一键安装脚本，这是新手最友好的方式，不需要手动装依赖、配环境变量。
4.1 执行一键安装命令
在终端输入以下命令（适用于macOS/Linux/WSL2）：
curl -fsSL https://openclaw.ai/install.sh | bash
4.1.1 安装过程说明
脚本会自动完成以下操作（全程大约2-3分钟，看网络速度）：
- 检测系统类型（Linux/macOS/WSL2）；
- 安装Node.js（≥22.0.0版本，OpenClaw 2026版的最低要求）；
- 安装OpenClaw核心程序，配置环境变量；
- 启动Gateway服务，并询问是否打开Web UI。
安装过程中有一个关键交互：当脚本执行到 How do you want to hatch your bot? 时，输入 1（选“Open the Web UI”），回车后脚本会自动打开浏览器跳转到OpenClaw控制台。
安装成功后，终端最后会输出类似这样的内容：
✅ OpenClaw installed successfully!
