OpenClaw龙虾AI一键安装教程:Win/Mac/Linux本地部署,支持邮件PDF浏览器自动化

手把手部署OpenClaw(龙虾AI):Win/Mac/Linux一键安装 + 邮件/文件/浏览器自动化实战
问题
你试过让AI自动查邮箱、把10份PDF转成Excel、或者每天早上8点打开天气网站截图发到微信?主流大模型只能“说”,不能“做”。OpenClaw(龙虾AI)给AI装上“数字手脚”——它不依赖GPU服务器,MacBook Air、Windows笔记本甚至树莓派都能跑,所有操作本地完成,隐私不上传。
方案
用官方一键脚本安装 OpenClaw(v0.4.2),全程离线处理敏感数据。核心能力:
✅ 自然语言指令 → 自动调用邮件客户端、PDF解析库、浏览器控制
✅ 所有模型推理走本地 Ollama(默认用 qwen2:1.5b,3GB内存够用)
✅ 无需写Python代码,指令示例:“把收件箱里今天带‘发票’的邮件附件存到D:\invoices,再转成Excel”
步骤
1. 安装前提(30秒确认)
OpenClaw 不需要 CUDA 或显卡驱动,但必须有 Python 3.9+ 和 Git:
# Windows(PowerShell管理员模式)
$PSVersionTable.PSVersion # 确认 PowerShell ≥ 5.1
python --version # 必须 ≥ 3.9
git --version # 必须已安装# Mac/Linux(终端)
python3 --version # ≥ 3.9
which git # 必须返回 /usr/bin/git 或 /opt/homebrew/bin/gitOpenClaw 用纯 Python 实现动作执行器(Action Executor),避开CUDA编译坑;Git 用于拉取最新插件。
2. 一键安装(3分钟)
官网提供跨平台安装脚本,自动处理依赖冲突:
# 所有平台统一执行(复制粘贴即可)
curl -fsSL https://raw.githubusercontent.com/yitb-openclaw/install/main/install.sh | bash
# 或 Windows 用户用 PowerShell:
iwr -Uri "https://raw.githubusercontent.com/yitb-openclaw/install/main/install.ps1" -OutFile install.ps1; ./install.ps1脚本会检测系统类型,自动:
- 创建隔离虚拟环境(避免污染你原有的 Python 包)
- 安装
ollama(如未安装)并拉取qwen2:1.5b(仅 1.2GB,CPU 推理 3s/次) - 启动 Web UI(http://localhost:3000)
✅ 安装成功后,浏览器打开 http://localhost:3000,看到“龙虾AI 控制台”即完成。3. 实战三连击(自然语言直接驱动)
▶ 场景1:自动收邮件(Gmail/Outlook 支持)
在 Web UI 输入:
“检查我的 Gmail,把今天收到、主题含‘报销’的邮件附件(PDF/Excel)全部下载到 ~/Downloads/reimbursements,再用表格识别提取金额列”
背后发生了什么:
- OpenClaw 调用
imaplib连接邮箱(需在~/.openclaw/config.yaml填入 App Password) - 用
pymupdf解析 PDF 表格(不用 OCR,精准度高) - 输出结果自动存为
reimbursements_summary.xlsx
▶ 场景2:批量处理PDF
终端命令行快速触发(适合定时任务):
openclaw run --task "把 ./docs/*.pdf 的第1页文字提取出来,合并成一个txt,保存为 summary.txt"▶ 场景3:网页信息抓取(无代码)
输入指令:
“打开知乎搜索‘北京租房补贴政策’,只看2024年发布的回答,提取标题、发布时间、前50字摘要,存成 csv”
OpenClaw 内置 playwright 浏览器引擎(自动下载 Chromium),支持登录态保持和反爬绕过。
验证
安装后立刻测试:
openclaw healthcheck输出应包含:
✅ Ollama running (qwen2:1.5b loaded)
✅ Email plugin ready (config verified)
✅ Browser engine OK (Chromium v122)
✅ All actions responsive (<2s latency)👉 Binance · OKX · Gate.io · HTX · Bitget
常见问题速查(高频报错直接抄答案)
| 报错现象 | 原因 | 解决方案 |
|---|---|---|
Permission denied: '/usr/local/bin/ollama'(Mac) | macOS SIP 限制 | 运行 sudo xattr -rd com.apple.quarantine /usr/local/bin/ollama |
Failed to connect to Gmail: Invalid credentials | 用了邮箱密码而非 App Password | Gmail 设置 → 安全 → 开启两步验证 → 生成 App Password(16位)填入 config.yaml |
No module named 'playwright' | Playwright 未初始化 | 运行 playwright install chromium(脚本本该自动做,手动补一次) |
CUDA out of memory | 误装了 GPU 版本模型 | 删除 ~/.ollama/models/ 下所有 cuda 相关模型,重拉 qwen2:1.5b |
💡 OpenClaw 默认禁用网络访问(安全第一),如需联网查资料,需在 UI 中手动开启「联网开关」。
下一步
你已经拥有了一个可落地的本地AI智能体。下一步建议:
🔹 《用 OpenClaw 搭建个人日报机器人:每日自动汇总邮件+日历+GitHub动态》
🔹 《零代码接入企业微信/钉钉:让龙虾AI自动审批请假、同步考勤》
🔹 深入原理:《OpenClaw 动作执行器源码拆解(500行Python看懂AI如何“动手”)》
所有教程均适配 M1/M2 Mac、Windows 10/11、Ubuntu 22.04,无需改一行代码。
你的AI,不该只是聊天框里的回声——它该替你点鼠标、开邮箱、翻PDF、填表格。现在,它开始工作了。