OpenClaw 免费小白完整安装指南!含Skills使用教程!小龙虾保姆级本地部署完整安装指南手册
快速部署OpenClaw小龙虾视频教程:
迅雷网盘地址⬇️
https://pan.xunlei.com/s/VOnPVz6WrwgR_qCbkCBcyxv1A1?pwd=brax#
这波AI Agent爆发,OpenClaw(小龙虾)绝对是顶流之一。15万+ GitHub星标背后,是大家对“真干活”AI的渴望。但网上教程要么碎片化,要么藏着掖着。今天这篇,我直接把本地部署的底裤扒干净,Windows/Mac/Linux三系统喂饭级命令,跟着敲就能跑起来。
我的朋友都知道,但凡市面上出现什么神器,我是第一个帮大家踩坑、整理保姆教程的人。2026年,如果要选一个最狂暴的AI开源项目,那非OpenClaw莫属。
这个被粉丝爱称为“小龙虾”的项目,在GitHub上短短数周狂揽15万+星标,刷新了全球开源项目的增速记录。
为什么它这么火?因为它不是那种你问一句它答一句的“嘴炮AI”。OpenClaw是真正的“执行者”。它能7x24小时自主运行,帮你操控浏览器、编写调试代码、解析文件、执行系统命令。
国外有个叫EthanMoore的开发者,靠部署OpenClaw,30天内被动收入突破1.2万美元——你睡觉的时候,它在帮你赚钱!
但我也看到,网上很多教程其实在误导人,特别是鼓吹什么VPS云端部署。大错特错!
今天这篇万字长文,我要把这事掰扯清楚:为什么必须本地部署? 以及 如何在Windows、Mac、Linux上零坑地把“小龙虾”养在你的电脑里?
一、核心认知:为什么我坚决反对“纯云端部署”?
如果你听信了某些博主的话,去买个海外VPS把OpenClaw一装就以为万事大吉,那我告诉你,你最多只发挥了它20%的功力。
OpenClaw的设计逻辑,天生就是为本地物理设备准备的。
1. 数据隐私与安全:你的聊天记录、浏览过的文件、操作习惯,这些最核心的数字资产,放在本地硬盘才是最安全的。本地部署能从根源杜绝数据泄露风险。
2. 深度系统适配:OpenClaw之所以强,是因为它能直接操控你的本地文件系统、桌面应用、剪贴板。在云端虚拟环境里,这些核心高阶能力完全无法实现。
3. 实时可视化:你可以亲眼看着AI在你的屏幕上移动鼠标、打开文件夹、输入文字。这种“亲眼所见”的安全感和调试便利性,是黑乎乎的远程终端给不了的。
而且,官方文档也明确了Tailoring策略,你的所有个性化配置、Workspace、记忆文件,都存储在本地~/.openclaw/目录下。这才是“养成”属于你自己的AI的基础。
二、部署前的准备(别偷懒,这步值5分)
无论你是什么系统,有几样东西是必须要准备的。这就像做饭先洗菜,省不了。
1. 通用依赖:
· Python:版本必须锁定在3.10 至 3.12之间。版本不对,直接报错,别怪我没提醒。
· Git:2.30+版本,用来拉取代码。
· Node.js:如果你走某些源码编译路子,需要22+版本,但咱们今天主要是Python原生部署。
2. 核心凭证(免费的午餐):
· 阿里云账号:注册并完成实名认证。这不是让你买服务器,是为了获取阿里云百炼的API Key。OpenClaw本身不产生智商,它需要借大模型的脑子。百炼平台新用户有免费额度,真香。
· 获取API Key:登录阿里云百炼控制台 -> 密钥管理 -> 创建API-Key。复制保存好,这相当于你给“小龙虾”接上的大脑神经。
三、手把手!三系统本地部署实战
好了,咱们来点真格的。以下命令均为实测,请放心复制粘贴。
1. MacOS 系统部署(Intel芯片或M系列通用)
Mac用户是最幸福的,环境最干净,跟Linux亲缘性最好。
第一步:打开终端,拉取小龙虾源码
```bash
git clone https://github.com/openclaw-project/openclaw.git
cd openclaw
```
第二步:创建独立虚拟环境(防止依赖冲突)
```bash
python3 -m venv claw-env
source claw-env/bin/activate
```
激活后,你的命令行前面会出现(claw-env)字样,说明你已进入虚拟环境。
第三步:安装依赖
```bash
pip install --upgrade pip
pip install -r requirements.txt --no-cache-dir
```
--no-cache-dir是为了避免缓存造成的安装失败,新手建议加上。
第四步:初始化配置
```bash
cp config/example_config.json config/claw_config.json
```
第五步:启动服务(前台运行看效果)
```bash
python -m openclaw.gateway
```
如果看到输出日志没有报红,且显示服务启动,恭喜你,成功了!浏览器打开 http://localhost:18789 就能看到界面。
后台运行(进阶):
确认没问题后,想关掉终端继续运行,可以用:
```bash
nohup python -m openclaw.gateway > claw_run.log 2>&1 &
tail -f claw_run.log # 查看实时日志
```
2. Linux 系统部署(以Ubuntu 22.04为例)
Linux是服务器级稳定性首选,部署逻辑和Mac几乎一样,但多了个开机自启的骚操作。
第一步:安装系统依赖
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y git python3 python3-venv python3-pip gcc g++ libssl-dev
```
第二步:拉取代码并配置虚拟环境(同上)
```bash
git clone https://github.com/openclaw-project/openclaw.git
cd openclaw
python3 -m venv claw-env
source claw-env/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
cp config/example_config.json config/claw_config.json
```
第三步:配置系统服务(让它开机自己跑)
这是Linux的优势,配置成服务后,即使重启服务器,小龙虾也会自动复活。
```bash
sudo tee /etc/systemd/system/openclaw.service << EOF
[Unit]
Description=OpenClaw AI Agent Local Service
After=network.target
[Service]
User=$USER
WorkingDirectory=$(pwd)
ExecStart=$(pwd)/claw-env/bin/python -m openclaw.gateway
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF
```
第四步:启动服务并设为开机自启
```bash
sudo systemctl daemon-reload
sudo systemctl start openclaw
sudo systemctl enable openclaw
sudo systemctl status openclaw # 查看状态,绿色running即成功
```
3. Windows 11 系统部署(原生兼容方案)
Windows用户注意!千万不要直接在CMD或PowerShell里硬刚Python原生环境,坑多得能让你怀疑人生。官方和社区一致推荐:WSL2(适用于 Linux 的 Windows 子系统) 。
第一步:启用WSL2并安装Ubuntu
· 以管理员模式打开PowerShell,输入:
```powershell
wsl --install
```
· 这行命令会自动启用所需功能,并默认安装Ubuntu 22.04 LTS。安装完重启电脑。
· 重启后,设置Ubuntu的用户名和密码。
第二步:在WSL中部署(复制Linux操作)
打开你刚安装的Ubuntu终端(可在开始菜单找到),接下来的操作,请完全参照上面 【Linux系统部署】 的第二步到第四步。
```bash
# 进入WSL的Ubuntu环境后,执行:
cd ~
git clone https://github.com/openclaw-project/openclaw.git
cd openclaw
sudo apt install -y python3-venv # WSL minimal版可能需要
python3 -m venv claw-env
source claw-env/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
cp config/example_config.json config/claw_config.json
python -m openclaw.gateway # 启动测试
```
第三步:访问Web界面
服务启动后,在Windows的浏览器里输入 http://localhost:18789,你就能看到OpenClaw的Web控制台了。WSL里的服务完美映射到了Windows端口。

快速部署OpenClaw小龙虾视频教程:
迅雷网盘地址⬇️
https://pan.xunlei.com/s/VOnPVz6WrwgR_qCbkCBcyxv1A1?pwd=brax#
四、喂给它“大脑”:配置阿里云百炼API
这时候你的小龙虾虽然跑起来了,但脑子还是空的。我们需要把阿里云百炼的API Key喂给它。
配置文件位置:
· Mac/Linux: config/claw_config.json 或 ~/.openclaw/openclaw.json
· WSL/Windows: 同上路径
用记事本或vim编辑这个文件,找到 models 或 providers 字段,按照以下格式填入(如果文件里没有,就手动加上):
```json
{
"models": {
"providers": {
"bailian": {
"apiKey": "这里填你的阿里云百炼API-Key",
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
}
},
"default": "qwen3.5"
}
}
```
保存文件后,重启OpenClaw服务。现在,你的“小龙虾”拥有了最强的中文大脑(通义千问)!
五、让它干活!安装第一个“技能”(Skill)
OpenClaw之所以强大,是因为它有Skills插件系统。截至2026年3月,ClawHub已有超5700个Skill插件。
但我们不能乱装,要遵守 “安全第一” 的原则。很多新手直接装技能导致系统崩了,就是因为没装“安全围栏”。
第一步:安装“防自杀”技能
这个技能叫 config-safe-modify,它能防止小龙虾乱改自己配置文件导致崩溃。当它试图做出危险修改时,技能会自动校验并回滚。
```bash
# 在OpenClaw的控制台或终端执行
clawhub install config-safe-modify
openclaw config set skills.config-safe-modify.autoRollback true
```
第二步:安装“防他杀”技能
安装任何第三方技能前,养成审查习惯。或者安装安全审查钩子(Hook)。
```bash
# 安装安全审查钩子
openclaw hooks install pre-action-auth-check
```
至此,你的小龙虾已经有了基本的生存能力。
六、避坑指南 & 博主私房建议
在帮几千名粉丝部署的过程中,我总结了三个最容易踩的坑:
1. 内存不足导致崩溃:
· 症状:多开几个技能,或者让AI处理大文件时,服务突然卡死,日志提示“out of memory”。
· 药方:本地部署建议电脑空闲内存至少4G。如果是云服务器,千万别买1核1G的乞丐版,2核4G是底线。复杂任务需要8G。
2. Token泄露风险:
· 症状:别人没经过你授权,就能访问你的OpenClaw,甚至操控它干坏事。
· 药方:定期用 openclaw token generate 重新生成访问令牌。不要把Token截图发群里,不要把配置文件上传到公开的Git仓库。
3. 国内地域网络受限:
· 症状:无法调用谷歌搜索、WhatsApp等海外Skills。
· 药方:如果你确实需要全球互联能力,部署服务器的地域优先选择中国香港或美国弗吉尼亚。国内大陆地域(除香港)有时会有联网限制。

快速部署OpenClaw小龙虾视频教程:
迅雷网盘地址⬇️
https://pan.xunlei.com/s/VOnPVz6WrwgR_qCbkCBcyxv1A1?pwd=brax#
写在最后
OpenClaw绝不是那种玩两天就扔的玩具。它是真正意义上的“数字员工”,是能陪你一起进化、24小时替你盯着屏幕干活的“数字分身”。
按照这篇教程把环境搭好,只是万里长征第一步。接下来,你需要像养孩子一样去“养成”它:告诉它你的习惯,给它安装合适的技能,建立安全边界。当你发现它在你睡觉时帮你整理好了周报、调试好了代码、甚至监控到了行业动态,那种感觉,真的太棒了。
如果你在部署中遇到了问题,欢迎在下方留言。老规矩,只要是我能力范围内的,知无不言,言无不尽。
关注我,下一期我们讲《如何给小龙虾装上100个顶级技能,让它自己赚钱》!
夜雨聆风