🚀 龙虾新手指南

OpenClaw中文版部署教程：Win/Mac/Linux一键安装+飞书机器人对接

发布时间：2026-09-23 分类： 龙虾新手指南
摘要：手把手部署OpenClaw中文版：Win/Mac/Linux一键安装+飞书机器人对接OpenClaw（龙虾）不是聊天机器人。它能真正操作你的电脑：打开浏览器查资料、下载PDF、批量重命名文件、把截图里的表格转成Excel、每天早上8点准时发日报到飞书群。它运行在本地，不上传数据，所有操作可审计、可调试、可打断。ChatGPT再聪明也打不开你桌面上的Excel；Copilot再快也点不了Chr...

OpenClaw中文版部署教程：Win/

手把手部署OpenClaw中文版：Win/Mac/Linux一键安装+飞书机器人对接

OpenClaw（龙虾）不是聊天机器人。它能真正操作你的电脑：打开浏览器查资料、下载PDF、批量重命名文件、把截图里的表格转成Excel、每天早上8点准时发日报到飞书群。它运行在本地，不上传数据，所有操作可审计、可调试、可打断。

ChatGPT再聪明也打不开你桌面上的Excel；Copilot再快也点不了Chrome里那个“导出为PDF”按钮。OpenClaw用原生系统能力控制界面——Windows用UI Automation，macOS用AX API，Linux用X11 + Wayland——点击、输入、拖拽、截图、读屏，和真人操作一致。

✅ 问题

想跑一个能动手干活的AI助理，但怕环境配置复杂、跨平台不兼容、对接飞书太麻烦。

🛠️ 方案

三种部署方式任选：

  • 一键脚本：适合新手，自动装依赖、下驱动、启服务
  • npm全局安装：适合已有Node环境，启动快、无编译
  • Git克隆：适合要改代码、加功能、换OCR引擎的人

全平台流程统一。飞书Bot对接只要3分钟。

▶️ 步骤（三选一）

方式1：一键脚本（推荐｜Win/macOS/Linux通用）

curl -fsSL https://openclaw.yitb.com/install.sh | bash

脚本会：

  • 检查 Python 3.10+ 和 Node.js 18+；缺则静默安装（macOS走Homebrew、Windows走Scoop、Linux走apt/yum）
  • 克隆最新中文版仓库
  • 安装 playwright 并自动下载 Chromium/Firefox 驱动
  • 启动 Web 控制台：http://localhost:3000

方式2：npm全局安装（适合已有Node环境）

npm install -g openclaw-cli
openclaw init --lang=zh-CN
openclaw start

openclaw-cli 是预编译二进制包，不编译C++依赖。--lang=zh-CN 直接加载中文提示词和操作模板，比如：“把桌面上所有xlsx文件移到‘报表’文件夹”。

方式3：Git克隆（适合想改代码/加功能）

git clone https://github.com/yitb/openclaw.git
cd openclaw
npm install
npm run build
npm run start

源码在手，你可以：

  • 修改 src/agents/file-manager.ts，适配公司文件命名规范
  • 在 plugins/feishu/ 里加审批流回调逻辑
  • 把默认OCR换成 PaddleOCR，提升中文识别准确率

🔗 飞书Bot对接（3分钟）

  1. 登录 飞书开放平台 → 创建「自建应用」→ 复制「App ID」和「App Secret」
  2. 打开 http://localhost:3000 → 左侧「集成」→ 「飞书」→ 粘贴ID/Secret → 点「启用」
  3. 复制生成的「Webhook地址」，在飞书群中添加「自定义机器人」→ 粘贴该地址

✅ 实测效果：
在飞书群 @龙虾 “把今天会议记录整理成带时间戳的要点”，它会：
→ 自动打开钉钉或腾讯会议历史页（如果已登录）
→ 截图 → OCR提取文字 → 用本地 Qwen2-1.5B 摘要 → 生成 Markdown → 发回群聊

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

✅ 验证是否成功

  • 访问 http://localhost:3000 → 点「快速测试」→ 输入：
    新建一个叫‘测试’的文本文档，写入‘Hello OpenClaw’，保存到桌面
  • 检查：桌面是否出现 测试.txt？内容是否正确？
  • 终端是否无红色报错？Playwright 日志是否显示 ✅ Action executed: type text？

❓ 常见问题

Q：Windows提示“无法验证此应用的发布者”？
A：右键安装包 → 属性 → 勾选“解除锁定” → 重新运行。这是Windows默认安全策略，不是病毒警告。

Q：Mac启动报错“developer cannot be verified”？
A：系统设置 → 隐私与安全性 → 拉到底部点“仍要打开”。Playwright需要Accessibility权限，首次调用会触发该提示。

Q：飞书收不到消息？
A：检查飞书机器人的「IP白名单」是否关闭（OpenClaw是本地服务，必须关）；确认控制台「飞书」开关是绿色。

Q：能操作微信PC版吗？
A：可以。OpenClaw原生支持Electron应用（微信、钉钉、VS Code等），靠识别窗口标题和UI控件，不依赖模拟按键。

OpenClaw不是另一个大模型，它是你操作系统之上的代理层。
下一步可以：

返回首页