OpenClaw（龙虾AI）手把手部署指南——给大模型装上“数字手脚”，本地跑通订餐/邮件/爬虫Agent

问题

你试过让ChatGPT帮你点外卖、自动整理收件箱、或抓取某家餐厅的今日菜单吗？它只会写步骤，不会真动手。因为大模型本身没有“手”——不能调API、不能发邮件、不能点击网页。OpenClaw（龙虾AI）就是这双“数字手脚”：一个轻量开源智能体框架，让本地运行的大模型真正行动起来。

它不依赖GPU，Mac/Windows/Linux都能跑；不连云端服务，所有动作在你电脑上完成；零代码基础也能起步——我们用3个真实小任务验证：
✅ 自动向「饿了么测试接口」提交模拟订单（无需真实支付）
✅ 收取Gmail中带“报销”关键词的邮件，提取金额+日期→存为CSV
✅ 抓取豆瓣电影Top250第1页标题和评分，生成Markdown报告

方案

用 pip 安装 OpenClaw + 内置工具链，搭配免费本地小模型（Phi-3-mini，2GB，CPU可跑），全程离线。核心就两步：

1. 启动带工具能力的智能体服务
2. 写一段自然语言指令，它自动拆解、调工具、组合结果

为什么选 OpenClaw？它把“调用工具”这件事标准化了：每个工具（如发邮件、爬网页）都封装成统一JSON Schema，模型只需按格式输出请求，框架自动执行——你不用写API调用代码，模型也不用硬记参数。

步骤

1. 安装与初始化（5分钟）

# 创建独立环境（避免冲突）
python -m venv openclaw-env
source openclaw-env/bin/activate  # macOS/Linux
# openclaw-env\Scripts\activate.bat  # Windows

# 安装龙虾AI主框架（含内置工具）
pip install openclaw

# 下载轻量模型（CPU友好，4GB内存够用）
openclaw download-model phi3-mini --quantize q4_k_m

为什么：phi3-mini 是微软开源的4B参数模型，量化后仅2GB，Intel i5/M1芯片能流畅推理；q4_k_m 是平衡速度与精度的4-bit量化格式，比全精度快3倍，精度损失<1%。

2. 启动智能体服务

# 启用邮箱工具（需Gmail应用密码）+ 爬虫工具 + 模拟订餐工具
openclaw serve \
  --model-path ~/.cache/openclaw/models/phi3-mini.Q4_K_M.gguf \
  --tools email,web_crawler,food_order_demo \
  --email-credentials '{"email":"your@gmail.com","app_password":"xxxx xxxx xxxx xxxx"}'

为什么：--tools 指定可用工具，food_order_demo 是龙虾内置的模拟订餐API（不扣钱，只返回成功/失败）；--email-credentials 传入Gmail应用密码（开启方式见yitb.com/gmail-app-pass），不是你的登录密码。

3. 发送第一条行动指令

新开终端，用curl触发：

curl -X POST http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "查收我邮箱里最近3封带‘报销’的邮件，提取‘金额’和‘日期’，保存为report.csv"}
    ],
    "tool_choice": "auto"
  }'

为什么：tool_choice: auto 让模型自己决定是否调用工具；返回结果里会包含工具调用记录（如{"tool_name": "email", "args": {"keywords": "报销", "max_results": 3}}），框架自动执行并回传数据。

验证

成功时你会看到：

• 终端打印 ✅ 已保存 report.csv（含3行数据，字段：金额,日期）

• 当前目录生成 report.csv，内容类似：

  金额,日期
  ¥286.50,2024-03-22
  ¥198.00,2024-03-20

• 若改指令为 “抓取豆瓣电影Top250第1页，按评分从高到低列标题”，会生成 douban_report.md，含10部电影+评分。

常见问题

❌ 报错 OSError: unable to load model
→ 检查模型路径是否正确，用 ls ~/.cache/openclaw/models/ 确认文件存在；若下载中断，删掉该文件夹重试。

❌ Gmail返回“认证失败”
→ 确保开启两步验证后生成的是「应用专用密码」（16位，空格分隔），不是你的账户密码；且邮箱地址拼写全小写。

❌ 爬虫返回空结果
→ 豆瓣反爬较严，龙虾内置了User-Agent轮换，但首次运行建议加 --timeout 30 参数延长等待（openclaw serve ... --timeout 30）。

下一步

你现在已掌握智能体“行动”的核心闭环：输入自然语言 → 模型决策调哪个工具 → 框架执行 → 返回结构化结果。
想进阶？试试：
🔹 《用OpenClaw接入自己的API：3步把公司内部系统变成AI可调用工具》
🔹 《免代码配置：在Dify里拖拽搭建“周报自动生成Agent”》
🔹 《CPU也能跑！Ollama部署Qwen2-1.5B，替代Phi-3做更复杂任务》

所有教程均提供可复制命令、截图验证、失败排查清单——在 yitb.com，AI 不是黑箱，是你的新键盘。