OpenClaw（龙虾 AI）部署全解：从安装到实战

为什么提示词写得再好，AI 还是不动手？

ChatGPT 能告诉你怎么操作 Excel，但不会真的打开 Excel、选中单元格、填入数据。
它不缺理解力，缺的是执行通道。
就像给一个熟读驾驶手册的人一辆没装方向盘的车——模型再强，没有 I/O 接口，就只能输出文字。

OpenClaw 解决的就是这个断层：让大模型直接操控本地环境。
它不是聊天界面，而是一个运行在你机器上的智能体运行时。你发一句“把上周销售数据导出 PDF 并邮件发给张经理”，它会调用文件系统读取 CSV、用 reportlab 生成 PDF、调 smtplib 发信——全程不上传数据，不依赖外部服务。

它凭什么能干活？

• 本地优先：所有操作发生在你的设备上。键盘输入、截图、文件读写、进程启动，都在本地完成；
• 插件即函数：新增能力只要写个 Python 函数，加个 @plugin 装饰器，再注册进 openclaw.plugins；
• 自然语言直驱：不用写 YAML 配置或 JSON Schema，直接说“把截图里的文字转成表格”，它自动调度 OCR 和表格解析工具。

3 分钟跑通第一个桌面操作智能体

1. 安装（Python 3.10+）

pip install openclaw
openclaw --version
# 输出类似：openclaw 0.4.2

不需要 clone 仓库、编译 C 扩展、手动配 PATH。pip install 后开箱即用。

2. 启动带桌面控制能力的实例

openclaw run --enable-desktop

--enable-desktop 是开关：它自动加载 pyautogui（鼠标/键盘模拟）和 pynput（全局热键监听），并申请系统级辅助功能权限（macOS 需在「系统设置 → 隐私与安全性 → 辅助功能」中勾选终端；Windows 需以管理员身份运行）。没这个参数，AI 只能思考；开了它，AI 才能点击、拖拽、截图。

3. 发送第一条指令（curl 测试）

新开终端：

curl -X POST http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "帮我打开计算器，输入 123+456，截图保存为 calc_result.png"}],
    "model": "claude-3-haiku"
  }'

实际发生的事：系统计算器弹出 → 光标定位到输入框 → 键入 123+456 → 按回车 → 截取当前窗口 → 保存为 calc_result.png。耗时约 8–12 秒，取决于本地模型响应速度。这不是 mock，是真实桌面事件流。

看它干了什么

执行完上面的 curl，检查当前目录：

calc_result.png  # 真实截图文件
openclaw.log     # 动作日志：[INFO] Clicked at (320, 240), [INFO] Typed "123+456", [INFO] Saved screenshot

再试一个实用命令：

curl -X POST http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "把桌面上所有 .xlsx 文件，按修改时间倒序列出，只显示文件名和大小"}], "model": "gpt-4o-mini"}'

→ 返回结构化结果（Markdown 表格），背后调用的是 os.listdir() + os.stat()，不是字符串拼接。

👉 Binance · OKX · Gate.io · HTX · Bitget

常见问题

Q：必须联网吗？
A：不需要。只要本地有模型（比如 Ollama 的 qwen2:7b 或 phi3），OpenClaw 完全离线运行。网络仅用于首次下载模型、或你显式配置的外发动作（如 SMTP 发信）。

Q：能控制微信或钉钉吗？
A：可以。Windows 上用 uiautomation 抓取 UI 元素；macOS 需开启「辅助功能」权限，配合 pyobjc 操作原生窗口。具体授权步骤和元素定位示例见官网《接入办公软件》文档。

Q：提示词经常被忽略，AI 直接跳过步骤？
A：默认使用 ReAct 决策循环，但步数限制较保守。在 config.yaml 中设：

max_thinking_steps: 5

强制它最多推理 5 轮再执行，复杂任务准确率提升 40%+。

接下来，让它真正干活

你现在手上的不是一个 demo，而是一个可嵌入工作流的智能体底座：

• 接入公司内网 API，每天早 9 点自动生成日报并推送到飞书群；
• 加载 pandas 插件，让它定时扫描 ~/Downloads，自动清洗带“销售”字样的 Excel 表；
• 在 8GB 内存笔记本上用 ollama run phi3 + OpenClaw，跑轻量自动化链路（截图 → OCR → 提取金额 → 写入记账表）。

动手资源：
→ 《OpenClaw 插件开发入门：30 行代码让 AI 学会发邮件》
→ 《用 Ollama + OpenClaw 搭建离线会议纪要助手》
→ GitHub 示例：openclaw/examples/desktop-automation/（含完整截图识别 + Excel 自动填充 + 多步骤校验链路）

你的电脑，就是智能体工厂。现在开工。