openClaw部署安装教程(亲测版)
OpenClaw是一个让 AI 帮你写代码、跑浏览器的工具。部署:用 Docker 最快。使用:配置好 API Key,安装 Browser Skill,然后用自然语言指挥它干活。警告:OpenClaw 具有执行本地命令的权限,请务必在 Docker 容器或虚拟机中运行,不要直接在物理机裸奔,以防 AI 误删文件或执行恶意代码。(配置)(启动服务,挂着别关)(打开界面)
OpenClaw 是目前(2026年初)GitHub 上最火爆的开源 AI Agent 框架之一(前身可能与 ClawdBot/MoltBot 相关)。
简单来说,它不仅仅是一个“聊天机器人”,而是一个**“能干活的 AI 代理”**。你给它一个目标(比如“帮我监控美团上某家店的猫粮价格”),它会自动拆解任务、编写代码、操作浏览器、抓取数据、分析结果,甚至可以直接控制你的电脑或服务器去执行这些操作。
对于你刚才提到的美团/淘宝爬虫需求,OpenClaw 是一个非常前沿且强大的解决方案,因为它可以结合 Playwright 或 Scrapling 等工具,利用大模型的推理能力去对抗反爬虫机制。
以下是关于 OpenClaw 的详细介绍、部署和使用指南:
1. OpenClaw 是什么?
- 核心定位:一个运行在你本地或云端的 AI 智能体(Agent)运行时环境。
- 它的能力:
- 自主浏览网页:它可以像人一样打开浏览器,点击按钮,滚动页面(完美解决美团/淘宝的懒加载问题)。
- 编写并运行代码:它可以在沙盒中自己写 Python/JS 脚本来处理数据。
- 绕过反爬:社区最近非常流行用 OpenClaw + Scrapling(一个防指纹识别的库)来绕过 Cloudflare 等盾。
- 多模型支持:支持接入 Claude 3.7, GPT-5, Gemini 3 等大模型作为“大脑”。
2. 怎么部署 OpenClaw?
部署 OpenClaw 主要有两种方式:Docker 部署(推荐,最省事) 和 本地源码部署。
方案 A:Docker 快速部署(推荐)
这是最干净的方式,不会污染你的电脑环境。
- 安装 Docker:确保你的电脑(Win/Mac/Linux)上安装了 Docker Desktop。
- 拉取并运行容器:
打开终端(CMD/Terminal),运行以下命令:docker run -d \ --name openclaw \ -p 18789:18789 \ -v $(pwd)/workspace:/app/workspace \ -e WORKSPACE_DIR=/app/workspace \ openclaw/openclaw:latest - 访问后台:
在浏览器输入http://localhost:18789,你会看到 OpenClaw 的管理界面。
方案 B:本地 Node.js 部署(适合开发者)
如果你想深度修改或调试。
- 环境准备:需要 Node.js (v20+) 和 Python (3.10+)。
- 克隆代码:
git clone https://github.com/openclaw/openclaw.git cd openclaw - 安装依赖并启动:
npm install -g pnpm pnpm install // OpenClaw 是使用 TypeScript 编写的,直接运行源码可能会报错,需要先编译成 JavaScript。 npm run build npm start
3. 怎么配置与使用?
部署好后,你需要给它装上“大脑”和“手脚”。
第一步:配置大脑(LLM)
进入 OpenClaw 的设置界面(Settings):
- LLM Provider:选择你的模型供应商。目前做爬虫任务,推荐使用 Claude 3.5 Sonnet 或 Claude 3.7(逻辑推理最强)或者 Gemini 1.5 Pro(上下文长,便宜)。
- API Key:填入你申请的对应 Key。
第二步:安装技能(Skills)—— 关键步骤
OpenClaw 本身只是个空壳,你需要安装“技能”才能让它去抓美团。
- 在界面中找到 “Skills” 或 “Tools” 市场。
- 搜索并安装以下技能:
browser/puppeteer/playwright:赋予它控制浏览器的能力。python:赋予它运行 Python 代码的能力。scrapling(如果有):这是最近很火的过盾工具。
第三步:下达指令(实战美团抓取)
回到对话框(Chat),直接用自然语言给它下命令。你不需要写代码,让 AI 去写。
提示词示例(Prompt):
“请帮我写一个 Python 脚本,使用 Playwright 库。
- 目标网站是美团外卖的Web版。
- 定位地址设置为‘天行国际-2号楼’(可能需要手动处理或模拟Cookie)。
- 搜索‘宠物用品’。
- 遍历列表中的前 10 个商家,进入商家详情页。
- 尝试找到商家的电话信息(注意:如果是图片格式,请告诉我)。
- 将结果保存为 CSV 文件。
- 请一步步执行,遇到反爬虫验证(如滑块)时,请尝试通过模拟鼠标轨迹绕过,或者暂停让我手动处理。”
4. 针对你美团需求的特别技巧
OpenClaw 相比传统爬虫,最大的优势在于**“人机协同”**:
-
半自动模式:
- 你可以让 OpenClaw 打开一个有头浏览器(Headful Browser)。
- 当美团弹出滑块验证码时,OpenClaw 会检测到并暂停,你可以手动在弹出的浏览器窗口里把滑块滑过去。
- 滑完后,告诉 OpenClaw:“验证已通过,继续”。
- 它会继续执行剩下的枯燥的点击和复制工作。
-
利用视觉模型:
- 如果商家的电话号码是图片,OpenClaw 可以调用多模态大模型(如 GPT-4o 或 Claude 3.5)直接对截图进行 OCR 识别,把图片转成数字。
总结
- OpenClaw 是一个让 AI 帮你写代码、跑浏览器的工具。
- 部署:用 Docker 最快。
- 使用:配置好 API Key,安装 Browser Skill,然后用自然语言指挥它干活。
- 警告:OpenClaw 具有执行本地命令的权限,请务必在 Docker 容器或虚拟机中运行,不要直接在物理机裸奔,以防 AI 误删文件或执行恶意代码。
windows安装教程:
第一步:初始化配置(如果还没做过)
在进入界面前,你需要先设置好 API Key 和基础环境。请在终端输入:
npm start -- setup
(注意:-- 是必须的,它告诉 npm 后面的参数是传给程序的)
按提示操作,回车确认默认设置即可。
第二步:启动核心服务(Gateway)
可视化界面需要后台服务支持。你需要启动 Gateway(网关)。
请在终端执行:
npm start -- gateway
⚠️ 重要提示:
- 执行这个命令后,不要关闭这个窗口。
- 它会一直运行,屏幕上应该会显示类似
Listening on port 18789的日志。
第三步:打开可视化界面(Dashboard)
现在后台跑起来了,你需要打开前端界面。
- 保持上一步的窗口不要动。
- 新建一个 终端窗口(Git Bash 或 CMD)。
- 进入同样的目录 (
cd D:\openclaw)。 - 执行以下命令打开仪表盘:
npm start -- dashboard
或者,你也可以直接在浏览器中尝试访问默认地址(如果上面命令没自动打开浏览器):
- http://localhost:18789
- 或者 http://localhost:3000
(具体端口请看第二步启动时的日志输出)
总结
你之前的操作只相当于打开了工具箱,现在你需要:
npm start -- setup(配置)npm start -- gateway(启动服务,挂着别关)npm start -- dashboard(打开界面)
页面提示错误信息:

解决方案:
问题非常明确:自动构建前端界面的过程失败了。
请看你的日志截图和文本日志中的关键红字/错误信息:
08:04:48 [gateway] Control UI build failed: exit 1
浏览器显示:Control UI assets not found... run pnpm ui:build
这意味着 Gateway 尝试自己编译界面,但是报错退出了。因为没有界面文件(HTML/CSS/JS),所以你访问 localhost:18789 只能看到那行纯文本报错。
你需要手动执行构建命令来生成界面文件。请按以下步骤操作:
第一步:停止当前服务
在那个正在运行 npm start -- gateway 的黑色窗口中,按 Ctrl + C(可能需要按两次),终止当前程序。
第二步:安装 pnpm(如果还没安装)
OpenClaw 强烈依赖 pnpm 这个包管理工具(报错提示里专门提到了它)。
在终端执行:
npm install -g pnpm
第三步:手动构建界面(关键步骤)
既然自动构建失败了,我们需要手动运行它,这样能看到具体的报错,或者直接解决问题。
依次执行以下命令:
- 安装所有依赖(确保 UI 库如下载完整):
pnpm install - 开始构建界面:
pnpm ui:build
👀 观察这一步的输出:
- 如果显示 Build success 或没有任何报错直接结束,说明成功了。
- 如果报错,请把报错信息发给我(通常是 Node 版本问题或网络超时)。
第四步:重启 Gateway
如果第三步成功了,再次启动服务:
npm start -- gateway
这次启动时,因为它检测到界面文件已经存在(刚才手动构建好了),它就不会再尝试去 build,而是直接显示 Ready。
第五步:访问界面
现在,打开浏览器访问:
http://localhost:18789
你应该就能看到正常的图形化控制台了。
杀死后台进程:
taskkill //F //IM node.exe
更多推荐

所有评论(0)