LobsterAI

环境要求

• Node.js >=24.15.0 <25（版本区间严格限制）
• npm（随 Node.js 安装）
• git（克隆仓库）
• pnpm（首次运行构建 OpenClaw 运行时需要）

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 LobsterAI 源码并进入项目目录，注意目录名区分大小写。

   git clone https://github.com/netease-youdao/LobsterAI.git
   cd LobsterAI

   复制

2. 2安装项目依赖

   在项目根目录安装 package-lock.json 中锁定的依赖，postinstall 会自动应用补丁并重建原生模块。

   npm install

   复制

3. 3首次开发运行

   首次运行会自动构建锁定的 OpenClaw 运行时，耗时较长，请保持网络畅通并耐心等待。

   npm run electron:dev:openclaw

   复制

4. 4日常开发运行

   OpenClaw 运行时已存在后使用，启动更快，适合日常改代码调试。

   npm run electron:dev

   复制

5. 5手动构建运行时

   可选：单独为当前平台构建 OpenClaw 运行时，用于排查运行时构建问题。

   npm run openclaw:runtime:host

   复制

6. 6打包安装包

   可选：生成发行安装包，产物输出到 release/ 目录，按平台选择对应命令。

   npm run dist:mac
   npm run dist:win
   npm run dist:linux

   复制

关键配置

如何确认成功

终端显示渲染进程开发服务器地址 http://localhost:5175，且 Electron 桌面应用窗口成功打开。

常见问题

注意事项

• 仓库的锁定 OpenClaw 版本与插件列表在 package.json 的 openclaw 字段中，dsh 运行时版本与归档信息在 dsh 字段中。
• dist:* 脚本会自动执行运行时构建、打补丁、裁剪等步骤，vendor/ 目录无需在每次构建间删除。
• 跨架构打包必须在匹配的机器上进行（如 mac-arm64 在 Apple Silicon 上构建），否则只会在用户机器上失败。
• 普通用户若只想使用，可直接从官网 https://lobsterai.youdao.com/#/download-list 下载桌面客户端，无需从源码构建。