“養龍蝦”？不，是部署OpenClaw！——開源AI Agent零基礎實戰指南

別慌，你沒買錯海鮮——“龍蝦”不是水產，是開源AI智能體 OpenClaw（官網：openclaw.dev，GitHub：github.com/peter-st/ocl）。它由奧地利開發者Peter Steinberger打造，Logo是一只紅彤彤的卡通龍蝦。它不是ChatGPT的本地“閹割版”，而是一個真正能自己想、自己查、自己調API、自己寫代碼的輕量級Agent：全程離線運行，不走任何云端API，所有決策和工具調用都在你本地機器上發生。

問題

你想讓AI不只是聊天，而是幫你自動查天氣+總結新聞+發郵件提醒？但又不想：
? 被ChatGPT封號（批量調用）
? 付月費買Claude Pro或GPT-4 API密鑰
? 把公司數據上傳到第三方服務器

方案

用 OpenClaw —— 一個不到20MB的Python項目，支持本地大模型（Ollama）、自主選擇工具（如requests、datetime、subprocess），還能用自然語言寫“任務腳本”，比如：

“查上海今天氣溫，如果高于28℃，就用系統通知彈窗提醒我開空調”

它不依賴GPU，Mac M1/M2、Windows筆記本、甚至樹莓派4都能跑。

步驟（手把手，5分鐘跑通）

1. 拉代碼 + 裝依賴

git clone https://github.com/peter-st/ocl.git
cd ocl
pip install -r requirements.txt

?? requirements.txt只含標準庫和ollama客戶端（不裝大模型本身），避免強制綁定某家云服務。

2. 啟動本地模型（免注冊、免API Key）

先確保已裝 Ollama（官網一鍵安裝），再拉一個輕量模型：

ollama run phi3:3.8b  # 僅2.2GB，M系列芯片10秒加載完

? 驗證：終端出現 >>> 即表示模型就緒，可手動測試：“你好” → 有回復即通。

3. 寫第一個Agent任務（task.yaml）

在ocl/目錄下新建文件，粘貼：

name: "天氣提醒小助手"
goal: "獲取上海當前溫度，若高于26℃則彈出系統通知"
tools:
  - name: http_get
    url: "https://api.weatherapi.com/v1/current.json?key=YOUR_KEY&q=Shanghai"
  - name: notify
    command: "osascript -e 'display notification \"?? 太熱了！開空調吧\" with title \"OpenClaw提醒\"'"
plan: |
  1. 調用http_get獲取天氣JSON

![配圖](http://www.xmhny.cn/usr/uploads/covers/cover_guides_20260715_080902.jpg)

  2. 解析response.current.temp_c
  3. 如果temp_c > 26，執行notify命令

?? 為什么不用API Key？你可用免費key（weatherapi.com注冊秒得），或改用純本地工具（如curl ifconfig.me查IP），完全可控。

4. 運行Agent

python main.py --task task.yaml --model ollama:phi3:3.8b

? 成功效果：終端打印推理步驟（“正在解析溫度…” → “溫度29.4℃，觸發通知”），Mac右上角彈出提醒窗口。

驗證

• ? 網絡斷開后仍可運行（工具調用失敗會報錯，但Agent邏輯仍在本地執行）
• ? ps aux | grep ocl 查進程，只有Python和Ollama，無后臺上傳行為
• ? 修改task.yaml中goal為“把當前目錄文件列表發郵件”，換上smtp工具即可擴展

常見問題

Q：必須用Ollama？能接Llama.cpp或vLLM嗎？
A：可以！OpenClaw用標準OpenAI兼容接口，只需改--model參數：

--model http://localhost:8080/v1  # 指向本地vLLM服務

Q：中文支持差？
A：換模型就行。實測qwen2:1.5b（ollama run qwen2:1.5b）中文推理更穩，且原生支持函數調用（tool calling）。

Q：怎么加自己的Python函數當工具？
A：在tools/目錄新建mydb.py，寫個def query_user(name): return "張三，VIP用戶"，再在task.yaml里聲明- name: mydb——Agent會自動識別并調用。

誰該立刻試試？

• ? 想學AI Agent原理，又怕被抽象概念勸退的開發者
• ? 學AI課程卡在“只會調API，不會編排流程”的新手
• ? 企業IT需私有化部署自動化腳本（如日志巡檢+告警）

OpenClaw不是玩具。它用YAML寫流程、Python寫工具、本地模型做推理——三者解耦，改一行配置就能切換模型/工具/目標，工程友好度遠超“封裝好的黑盒App”。

?? 已跑通？試試《用OpenClaw自動整理微信讀書筆記》（www.xmhny.cn/openclaw-wechat）
?? 想深入Agent架構？看《MCP協議入門：讓AI智能體像插USB一樣換工具》（www.xmhny.cn/mcp-guide）
?? 或直接進GitHub Star收藏：github.com/peter-st/ocl —— 文檔全在README.md，連Docker Compose都配好了。