OpenClaw（龍蝦AI）手把手部署指南——給大模型裝上“數(shù)字手腳”，本地跑通訂餐/郵件/爬蟲(chóng)Agent

問(wèn)題

你試過(guò)讓ChatGPT幫你點(diǎn)外賣、自動(dòng)整理收件箱、或抓取某家餐廳的今日菜單嗎？它只會(huì)寫步驟，不會(huì)真動(dòng)手。因?yàn)榇竽Ｐ捅旧頉](méi)有“手”——不能調(diào)API、不能發(fā)郵件、不能點(diǎn)擊網(wǎng)頁(yè)。OpenClaw（龍蝦AI）就是這雙“數(shù)字手腳”：一個(gè)輕量開(kāi)源智能體框架，讓本地運(yùn)行的大模型真正行動(dòng)起來(lái)。

它不依賴GPU，Mac/Windows/Linux都能跑；不連云端服務(wù)，所有動(dòng)作在你電腦上完成；零代碼基礎(chǔ)也能起步——我們用3個(gè)真實(shí)小任務(wù)驗(yàn)證：
? 自動(dòng)向「餓了么測(cè)試接口」提交模擬訂單（無(wú)需真實(shí)支付）
? 收取Gmail中帶“報(bào)銷”關(guān)鍵詞的郵件，提取金額+日期→存為CSV
? 抓取豆瓣電影Top250第1頁(yè)標(biāo)題和評(píng)分，生成Markdown報(bào)告

方案

用 pip 安裝 OpenClaw + 內(nèi)置工具鏈，搭配免費(fèi)本地小模型（Phi-3-mini，2GB，CPU可跑），全程離線。核心就兩步：

1. 啟動(dòng)帶工具能力的智能體服務(wù)
2. 寫一段自然語(yǔ)言指令，它自動(dòng)拆解、調(diào)工具、組合結(jié)果

為什么選 OpenClaw？它把“調(diào)用工具”這件事標(biāo)準(zhǔn)化了：每個(gè)工具（如發(fā)郵件、爬網(wǎng)頁(yè)）都封裝成統(tǒng)一JSON Schema，模型只需按格式輸出請(qǐng)求，框架自動(dòng)執(zhí)行——你不用寫API調(diào)用代碼，模型也不用硬記參數(shù)。

步驟

1. 安裝與初始化（5分鐘）

# 創(chuàng)建獨(dú)立環(huán)境（避免沖突）
python -m venv openclaw-env
source openclaw-env/bin/activate  # macOS/Linux
# openclaw-env\Scripts\activate.bat  # Windows

# 安裝龍蝦AI主框架（含內(nèi)置工具）
pip install openclaw

# 下載輕量模型（CPU友好，4GB內(nèi)存夠用）
openclaw download-model phi3-mini --quantize q4_k_m

為什么：phi3-mini 是微軟開(kāi)源的4B參數(shù)模型，量化后僅2GB，Intel i5/M1芯片能流暢推理；q4_k_m 是平衡速度與精度的4-bit量化格式，比全精度快3倍，精度損失<1%。

2. 啟動(dòng)智能體服務(wù)

# 啟用郵箱工具（需Gmail應(yīng)用密碼）+ 爬蟲(chóng)工具 + 模擬訂餐工具
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 是龍蝦內(nèi)置的模擬訂餐API（不扣錢，只返回成功/失敗）；--email-credentials 傳入Gmail應(yīng)用密碼（開(kāi)啟方式見(jiàn)www.xmhny.cn/gmail-app-pass），不是你的登錄密碼。

3. 發(fā)送第一條行動(dòng)指令

新開(kāi)終端，用curl觸發(fā)：

curl -X POST http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "查收我郵箱里最近3封帶‘報(bào)銷’的郵件，提取‘金額’和‘日期’，保存為report.csv"}
    ],
    "tool_choice": "auto"
  }'

為什么：tool_choice: auto 讓模型自己決定是否調(diào)用工具；返回結(jié)果里會(huì)包含工具調(diào)用記錄（如{"tool_name": "email", "args": {"keywords": "報(bào)銷", "max_results": 3}}），框架自動(dòng)執(zhí)行并回傳數(shù)據(jù)。

驗(yàn)證

成功時(shí)你會(huì)看到：

• 終端打印 ? 已保存 report.csv（含3行數(shù)據(jù)，字段：金額,日期）

• 當(dāng)前目錄生成 report.csv，內(nèi)容類似：

  金額,日期
  ￥286.50,2024-03-22
  ￥198.00,2024-03-20

• 若改指令為 “抓取豆瓣電影Top250第1頁(yè)，按評(píng)分從高到低列標(biāo)題”，會(huì)生成 douban_report.md，含10部電影+評(píng)分。

常見(jiàn)問(wèn)題

? 報(bào)錯(cuò) OSError: unable to load model
→ 檢查模型路徑是否正確，用 ls ~/.cache/openclaw/models/ 確認(rèn)文件存在；若下載中斷，刪掉該文件夾重試。

? Gmail返回“認(rèn)證失敗”
→ 確保開(kāi)啟兩步驗(yàn)證后生成的是「應(yīng)用專用密碼」（16位，空格分隔），不是你的賬戶密碼；且郵箱地址拼寫全小寫。

? 爬蟲(chóng)返回空結(jié)果
→ 豆瓣反爬較嚴(yán)，龍蝦內(nèi)置了User-Agent輪換，但首次運(yùn)行建議加 --timeout 30 參數(shù)延長(zhǎng)等待（openclaw serve ... --timeout 30）。

下一步

你現(xiàn)在已掌握智能體“行動(dòng)”的核心閉環(huán)：輸入自然語(yǔ)言 → 模型決策調(diào)哪個(gè)工具 → 框架執(zhí)行 → 返回結(jié)構(gòu)化結(jié)果。
想進(jìn)階？試試：
?? 《用OpenClaw接入自己的API：3步把公司內(nèi)部系統(tǒng)變成AI可調(diào)用工具》
?? 《免代碼配置：在Dify里拖拽搭建“周報(bào)自動(dòng)生成Agent”》
?? 《CPU也能跑！Ollama部署Qwen2-1.5B，替代Phi-3做更復(fù)雜任務(wù)》

所有教程均提供可復(fù)制命令、截圖驗(yàn)證、失敗排查清單——在 www.xmhny.cn，AI 不是黑箱，是你的新鍵盤。