OpenClaw 入门：你的AI终于能“动手干活”了（Mac/Win/Linux本地部署实操）

问题

你试过让 ChatGPT 重命名 100 个下载的 PDF、自动填表提交到学校系统、或者每天 8 点发 WhatsApp 提醒妈妈吃药吗？它做不到。它只会“说”，不会“做”。Llama、Claude、甚至本地跑的 Ollama 模型，本质都是“高级聊天机器人”——它们不碰你的文件，不点鼠标，不发消息。

方案

OpenClaw 是程序员 Peter Steinberger 开源的真正能动手的 AI 助手。它不是另一个大语言模型，而是一个“AI 执行引擎”：
✅ 完全离线运行（不联网、不调云端 API）
✅ 直接读写你电脑上的文件（/Downloads/report.pdf → 自动提取文字 + 存 Excel）
✅ 控制浏览器（打开网页 → 登录 → 点击 → 截图）
✅ 调用系统命令（osascript -e 'display notification' 发桌面提醒）
✅ 收发 WhatsApp（通过官方 WhatsApp Desktop API，无需手机扫码）

它把 AI 从“嘴上功夫”变成“手上功夫”。

步骤（3 分钟完成本地部署）

1. 安装依赖（必须先装 Python 3.11+ 和 Chrome）

# Mac（用 Homebrew）
brew install python@3.11 chromedriver

# Windows（PowerShell 管理员运行）
winget install Python.Python.3.11
winget install SeleniumHQ.Selenium.ChromeDriver

# Linux（Ubuntu）
sudo apt update && sudo apt install python3.11 python3.11-venv chromium-browser

说明：OpenClaw 用 Python 驱动浏览器和系统操作。Chrome 是目前唯一验证通过的浏览器——Firefox 尚未支持 WhatsApp 集成。

2. 下载并启动 OpenClaw

git clone https://github.com/petersteinberger/OpenClaw.git
cd OpenClaw
python3.11 -m venv .venv
source .venv/bin/activate  # Mac/Linux；Windows 用 `.venv\Scripts\activate`
pip install -r requirements.txt
python main.py

说明：默认使用本地 Ollama 的 llama3:8b 模型（需提前运行 ollama pull llama3:8b）。你也可以换成 Qwen2 或 Phi-3 —— 所有推理都在本机完成，数据不出设备。

3. 让它干一件实事：自动整理下载文件夹

在 OpenClaw Web 界面（http://localhost:5000）输入：

“把 Downloads 文件夹里所有以‘invoice_’开头的 PDF，提取第 1 页文字，保存为同名 Excel，放在 Desktop/invoices 目录下”

几秒后，你会看到：

• ~/Desktop/invoices/invoice_202405.xlsx 自动生成
• 控制台打印执行日志：[✓] Read invoice_202405.pdf → extracted 327 chars → saved to Excel

说明：OpenClaw 把自然语言指令编译成真实 Python 操作链：os.listdir() → fitz.open()（PyMuPDF 读 PDF）→ pandas.DataFrame().to_excel() —— 不是猜测，是逐行执行。

验证

打开终端，手动检查结果：

ls ~/Desktop/invoices/
# 输出：invoice_202405.xlsx  invoice_202406.xlsx

head -n 5 ~/Desktop/invoices/invoice_202405.xlsx
# 显示 Excel 内容（实际导出为 CSV，双击可用 Excel 打开）

常见问题

❌ 启动报错 ModuleNotFoundError: No module named 'playwright'
→ 运行 pip install playwright && playwright install chromium（OpenClaw 0.2.1 起已切换至 Playwright，比 Selenium 更稳定）

❌ WhatsApp 消息发不出
→ 确保已安装 WhatsApp Desktop 并登录；OpenClaw 会直接复用其本地 API 端口（纯桌面版，无需手机扫码）

❌ 中文 PDF 提取乱码
→ 在 config.yaml 中将 pdf_engine: pypdf 改为 pdf_engine: pymupdf（MuPDF 对中日韩文字支持更可靠）

下一步

OpenClaw 不是玩具，而是 AI Agent 开发的“最小可行执行单元”。你可以：
🔹 用 Dify 接入 OpenClaw，做成带 UI 的自动化工作台
🔹 给它加个定时任务，每天早 8 点自动抓取天气并微信发给你
🔹 替换为本地 Qwen2-7B，让执行更准更快

💡 小提示：它的核心价值不在“多聪明”，而在“敢动手”。第一次看到 AI 把你的 Excel 生成出来时，你会意识到——这不再是聊天，是同事。