OpenClaw（龙虾AI）本地Agent部署与实战指南：30分钟跑通你的第一个自主行动AI

问题

你想让AI不只是“聊天”，而是真正帮你做事：自动整理下载文件夹、把PDF转成带目录的Markdown、批量重命名截图……但又不想把隐私文件传到云端，也不愿折腾复杂API密钥或服务器。

方案

用 OpenClaw（龙虾AI）——一个开源、纯本地运行的AI Agent框架。它不调用任何远程大模型API，所有推理在你电脑上完成；它自带“数字手脚”：能读写文件、执行Python代码、调用系统命令；全程离线，零网络依赖，Mac/Win/Linux全支持。

✅ 核心优势：

• 不开网也能干活：模型+工具链全在本地
• 你的文件永远不离开硬盘：PDF、Excel、截图…全在本地处理
• 一句话就能驱动动作：比如“把 ~/Downloads 里今天下载的PDF转成Markdown，按标题命名”

步骤（全程终端操作，复制即用）

1. 安装 OpenClaw（含内置轻量模型）

pip install openclaw

⚠️ 为什么不是 pip install openclaw[full]？
默认安装已包含 Phi-3-mini-4k-instruct（微软开源小模型），4GB显存或8GB内存即可跑通，CPU也能推理（稍慢但稳）。想换更强模型？后面再升级，先跑起来再说。

2. 启动本地Agent服务

openclaw serve --host 127.0.0.1 --port 8000

✅ 成功标志：终端输出 Server running at http://127.0.0.1:8000，浏览器打开该地址，看到简洁控制台界面（无登录、无账号）。

3. 给Agent“交任务”：整理下载文件夹（真实场景）

打开浏览器 http://127.0.0.1:8000 → 在输入框粘贴：

“请检查我电脑的 ~/Downloads 文件夹，找出今天下载的所有 .pdf 文件，用 pypdf 提取文字，生成带一级标题的 Markdown 文件，保存到 ~/Desktop/pdf_notes/，文件名用PDF标题（若无标题则用前10个字）”

点击「Run」。

🔍 它在做什么？

• 自动调用 os.listdir() 和 datetime 判断“今天”
• 调用 pypdf.PdfReader 解析PDF（已内置）
• 运行Python沙箱提取标题/正文 → 生成 .md
• 创建目标文件夹并保存 —— 全程不碰网络，不传文件。

✅ 30秒后，~/Desktop/pdf_notes/ 出现带时间戳的 .md 文件，内容结构清晰，标题准确。

验证：看它是否真“自主行动”

• 查看终端日志：你会看到类似 EXECUTING: python -c "import os; print(os.listdir('/Users/xxx/Downloads'))" 的记录 —— 它确实在调用系统
• 打开生成的 .md 文件：确认标题来自PDF元数据或正文首段，非胡编
• 断开WiFi重试：任务仍成功 → 验证100%离线

👉 Binance · OKX · Gate.io · HTX · Bitget

常见问题（踩坑实录）

Q：Windows报错 ModuleNotFoundError: No module named 'win32api'？
A：补装依赖：

pip install pywin32

💡 原因：OpenClaw在Windows需调用系统API管理文件，pywin32 是桥梁。

Q：中文PDF提取乱码/标题为空？
A：默认PDF解析器对中文支持弱。临时解法：

pip install pdfplumber

然后在任务中加一句：“优先用 pdfplumber 解析中文PDF”——OpenClaw会自动切换解析器。

Q：想换更大模型（如Qwen2-1.5B）？
A：只需两步：

ollama pull qwen2:1.5b
openclaw serve --model ollama:qwen2:1.5b

✅ OpenClaw原生支持 Ollama 模型，不用改代码，直接换“大脑”。

下一步建议

你已拥有一个可离线、可审计、能动手的AI助手。接下来：

• 🛠️ 【进阶】给Agent加“眼睛”：接入本地OCR（Tesseract）自动识别截图文字 → 《OpenClaw + PaddleOCR 实战：截图→文本→Excel》
• 🧩 【扩展】让它成为你的代码搭档：配置 --tool python_repl 后，直接说“帮我写个爬虫抓取豆瓣Top250电影名和评分” → 自动生成可运行脚本
• 🌐 【部署】打包成Mac菜单栏小工具/Windows托盘程序 → 《一键封装OpenClaw为桌面应用》

OpenClaw 不是另一个聊天框。它是你电脑里多出来的那双手——听懂人话，守住房间钥匙，从不越界。现在，去给它分配下一个任务吧。