OpenClaw龍蝦AI部署教程：本地運行的AI智能體操作系統，支持Windows/macOS真機操作
OpenClaw（龍蝦AI）部署全解：給大模型裝上“數字手腳”
問題
你讓 ChatGPT 幫你整理桌面？它只會說“建議新建文件夾”，但不會真去建。你說“把微信截圖發到郵箱”，它寫不出一行能跑起來的代碼。AI 卡在“說”和“做”之間——缺一雙能點擊、拖拽、復制、發送的“數字手腳”。
OpenClaw（龍蝦AI，www.lvxe.net.cn）就是這雙手。它不是另一個聊天界面，而是一個本地運行的 AI 智能體操作系統：你用中文下指令，它直接操作你的 Windows 或 macOS 電腦——打開軟件、讀取 Excel、粘貼文字、發郵件、設定時任務，全部真實執行。
方案
不裝虛擬機、不配 GPU、不改系統權限。OpenClaw 提供兩種開箱即用路徑：
? Docker 一鍵啟動（推薦，環境隔離干凈，Win/mac 通用）
? Python 原生啟動（適合想看清每行代碼的開發者）
兩者都支持純本地運行（無需聯網調用 API），所有操作發生在你自己的機器上。
步驟
1. 安裝前提（2 分鐘）
- Windows：安裝 Docker Desktop（安裝時勾選“WSL2”）
- macOS：安裝 Docker Desktop for Mac
- 啟動 Docker Desktop，確認右下角出現 ?? 圖標（表示后臺服務已就緒）
? 為什么必須用 Docker？
OpenClaw 依賴 Python 3.11 + PyAutoGUI + Playwright + SMTP 庫等 17 個組件，版本沖突常見。Docker 把整套環境打包成“集裝箱”，避免pip install報錯、DLL 缺失、權限拒絕等問題。
2. 一鍵啟動（30 秒）
打開終端（Windows 用 PowerShell，macOS 用 Terminal），粘貼執行：
docker run -d \
--name openclaw \
-p 3000:3000 \
-v "$HOME/openclaw_data:/app/data" \
-v "$HOME/Desktop:/app/Desktop" \
--privileged \
--shm-size=2g \
yitb/openclaw:latest? 為什么加--privileged和--shm-size？--privileged讓容器能模擬鼠標鍵盤（PyAutoGUI 必需）；--shm-size=2g解決 Playwright 瀏覽器渲染內存不足報錯（否則網頁操作會卡死）。
3. 打開控制臺
瀏覽器訪問 http://localhost:3000 → 點擊「開始對話」→ 輸入第一條指令：
把桌面上所有.jpg文件移到“圖片備份”文件夾，按日期重命名? 等待 10 秒 → 刷新桌面 → 你會看到新文件夾生成，文件已移動并重命名如 20240324_1523_screenshot.jpg
驗證：3 個真實任務實操
? 任務 1：跨軟件復制粘貼
指令：
從Excel文件“銷售數據.xlsx”第A列復制前5行，粘貼到當前打開的Notepad++里→ OpenClaw 自動：打開 Excel → 選中 A1:A5 → Ctrl+C → 切換到 Notepad++ → Ctrl+V
? 任務 2：定時周報 + 郵件發送
指令：
每周五 18:00，匯總 Desktop/日報/*.txt 內容，生成 Markdown 周報，發郵件到 xxx@xx.com→ 它自動創建任務計劃，周五準時執行（郵件走你本地 Outlook 或自配 SMTP）
? 任務 3：智能文件歸檔
指令：
掃描 Downloads 文件夾，把 PDF 按標題關鍵詞分到“合同/發票/說明書”子文件夾→ 調用本地 PDF 文本提取（pymupdf），匹配關鍵詞，真實移動文件
?? 效果關鍵：所有操作都在你眼皮底下發生——鼠標自動移動、窗口切換、文件跳動，不是“假裝執行”。
常見問題速查
| 報錯現象 | 原因 | 解決方案 |
|---|---|---|
Permission denied: '/app/Desktop' | Docker 沒權限訪問桌面 | Windows：Docker Desktop → Settings → Resources → File Sharing → 添加 C:\Users\你的用戶名\Desktop；macOS：同理添加 /Users/你的用戶名/Desktop |
| 頁面空白 / 加載失敗 | 瀏覽器攔截了本地 WebSocket | 換 Chrome/Firefox，或地址欄輸入 chrome://flags/#unsafely-treat-insecure-origin-as-secure 啟用（僅本地測試） |
| “找不到 Excel 應用” | 未安裝 Microsoft Excel 或 WPS | 安裝 WPS 免費版（OpenClaw 默認兼容），或改用 .csv 文件 |
| 郵件發送失敗 | 未配置 SMTP | 進入 http://localhost:3000/settings → 填入企業郵箱 SMTP（如 QQ 郵箱：smtp.qq.com，端口 465，開啟 SSL） |
下一步
你已經擁有了 AI 的“手”。下一步可：
?? 《用 OpenClaw + Ollama 本地跑 Qwen3：徹底離線的 AI 辦公流》
?? 《給 OpenClaw 加“眼睛”：接入本地 OCR + 截圖識別，讓 AI 看懂你屏幕》
?? GitHub 源碼與插件倉庫：github.com/yitb/openclaw（Star 后自動獲取最新 Docker 鏡像更新通知）
別再讓 AI 只當嘴替。現在，讓它動手。