OpenClaw龙虾本地AI Agent一键部署教程(Windows/macOS双平台,无需API/月费)

OpenClaw“龙虾”本地一键部署指南(2026首发)
问题:想让AI真正帮你操作电脑——打开Excel改数据、截图发微信、批量重命名文件,但怕装一堆工具、配环境、开API、交月费?
方案:OpenClaw(龙虾)是开源的本地全栈AI Agent。它不调用云端API,不依赖独立App,直接在你本机执行文件读写、进程启停、鼠标点击、窗口切换。通过系统级权限接管操作系统,所有动作发生在本地,隐私可控,响应快。
✅ 一键部署(Windows/macOS双平台)
步骤1:安装Python 3.11+(必须)
龙虾依赖原生Python运行时,不是“免Python”的伪轻量:
# macOS(推荐用Homebrew)
brew install python@3.11
# Windows(从官网下载安装包)
# https://www.python.org/downloads/release/python-31110/
# 安装时勾选 ✅ "Add Python to PATH"pyautogui控制GUI、psutil管理进程、watchdog监听文件——这些库需要原生Python支持,WebAssembly或沙箱无法替代。
步骤2:克隆并安装龙虾(含权限自动配置)
git clone https://github.com/yitb/openclaw.git
cd openclaw
pip install -e .-e模式让代码修改立即生效;安装过程会自动检测系统并申请必要权限(macOS弹出辅助功能授权,Windows触发UAC提权)。
步骤3:启动龙虾服务(无后台进程,纯本地)
openclaw serve --port 8080终端输出 ✅ Ready. Access http://localhost:8080 即成功。
龙虾编译了平台专用二进制组件(如macOS的AXAPI桥接层、Windows的UIAutomation封装),Docker镜像会破坏底层交互能力。
🔍 验证:三行指令测真实计算机能力
打开浏览器访问 http://localhost:8080,在聊天框输入:
请新建一个桌面文件夹叫“龙虾测试”,在里面创建test.txt,写入“Hello from local agent!”,然后截图保存为screenshot.png✅ 你会看到:
- 桌面立刻出现
龙虾测试文件夹 - 文件夹内生成
test.txt(内容正确) - 同目录下多出
screenshot.png(当前浏览器窗口截图)
这不是模拟。龙虾调用的是os.makedirs()、open().write()、pyautogui.screenshot()——和你手写的Python脚本完全一致,只是由大模型实时规划调用链。
👉 Binance · OKX · Gate.io · HTX · Bitget
⚠️ 常见问题
Q:Mac提示“辅助功能未启用”?
A:去「系统设置→隐私与安全性→辅助功能」,手动勾选 openclaw 进程(首次启动后才会显示)。这是macOS强制安全机制,非Bug。
Q:Windows杀毒软件报“可疑行为”?
A:龙虾确实会调用subprocess.Popen()启动记事本、win32gui获取窗口句柄——这是真实操作必需。将openclaw目录添加到杀软白名单即可。
Q:能连微信/钉钉/飞书吗?
A:支持!只需在网页端点击「接入聊天工具」→选择已登录的微信网页版(或钉钉扫码)。龙虾以“用户身份”接管你的聊天窗口,所有消息走本地WebSocket,不经过任何中转服务器。
💡 实际能做什么?
- 自动整理下载文件夹:按扩展名归类+加时间戳重命名
- 每天9点抓取股票截图,用微信发给家人
- 监控指定文件夹,新PDF自动转文字存Notion(配合本地Ollama)
核心价值:你不再“问AI”,而是“命令AI干活”。没有App跳转,没有API配额,没有网络延迟——就像多了一个懂Python的数字同事,永远在线,永不联网。
下一步建议:
👉 《用龙虾+Ollama搭建离线文档助手》
👉 《零代码配置龙虾自动处理邮件附件》
👉 查看官方权限说明文档,理解每项系统权限的实际用途