官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

LobsterAI

English · 中文

全场景办公助手 Agent。
国内大厂首个开源桌面级 Agent，网易有道出品。

功能亮点  ·  本地开发  ·  社区与支持

下载 LobsterAI

LobsterAI 是一个可以进入真实工作环境的桌面级 Agent：本地文件、终端命令、浏览器流程、文档、表格、幻灯片、IM 渠道、定时任务和项目工作区。

Cowork 是 LobsterAI 的产品与会话层，OpenClaw 是底层运行时和网关。这种分层让 LobsterAI 在桌面端负责本地持久化、权限、UI 状态、Artifacts、Agents、记忆和 IM 绑定，同时由 OpenClaw 执行 Agent 任务。

功能亮点

桌面级 Cowork 会话

围绕本地项目和文件执行长任务。LobsterAI 会实时流式展示进度、保存会话历史、渲染工具输出，并在文件操作、终端命令、网络访问等敏感动作前请求用户审批。

多 Agent 工作流

创建拥有独立身份、模型、技能、工作目录、启用状态和 IM 绑定的自定义 Agent。主 Agent 处理通用工作，专用 Agent 负责重复性的特定角色。

专家套件

安装面向场景的专家套件，将能力选择和参考信息打包成可复用工作流。专家套件与直接选择技能相互独立，因此同一任务可以同时组合套件和单个工具。

技能

LobsterAI 在 SKILLs/skills.config.json 中配置了 28 个内置技能，包括 Web 搜索、Word 文档、Excel 表格、PowerPoint、PDF 处理、Remotion 视频生成、浏览器自动化、图片/视频生成、股票研究、内容写作、邮件、天气和技能创建等。

MCP 服务

通过 Model Context Protocol 接入外部工具和数据源。LobsterAI 会在本地保存用户配置的 MCP 服务，并将启用的服务同步到 OpenClaw。

定时任务

通过自然语言或定时任务 UI 创建周期任务。适合每日新闻、邮箱摘要、网站监控、周报生成等重复性工作。

IM 远程控制

通过微信、企业微信、钉钉、飞书/Lark、QQ、Telegram、Discord、网易云信 IM、网易小蜜蜂、POPO 和邮件触达桌面 Agent。多实例平台可以把不同账号或渠道绑定到不同 Agent。

丰富 Artifacts

在桌面端预览和管理生成的 HTML、SVG、图片、视频、Mermaid 图表、代码、Markdown、文本、文档和本地服务类 Artifacts。

本地记忆与数据

会话和应用数据保存在本地 SQLite。OpenClaw 工作区记忆使用 MEMORY.md、USER.md、SOUL.md 和每日笔记等文件，让偏好和项目上下文能够跨会话延续。

实战指令

工作原理

• Renderer：React、Redux Toolkit、Tailwind、Artifact 渲染器、设置、Agent/会话 UI、技能、MCP、定时任务和 IM 配置。
• Main process：Electron 生命周期、IPC、SQLite 持久化、登录鉴权、日志、OpenClaw 启动、运行时修复、技能同步、IM 网关和 Artifact 服务。
• OpenClaw 集成：openclawEngineManager、openclawConfigSync、openclawRuntimeAdapter 和 coworkEngineRouter 将 LobsterAI 状态转换成 OpenClaw 运行时行为。

安装

桌面端

从官网或GitHub Releases 下载最新 macOS 和 Windows 安装包。

从源码运行

环境要求：

• Node.js >=24.15.0 <25
• npm >=11.17.0 <12（旧版本可运行 npm install -g npm@11.17.0 升级）
• git 与 pnpm，首次启动时用于从同级目录 ../openclaw 构建锁定版本的 OpenClaw runtime

better-sqlite3@13.0.3 已包含 Windows、macOS 和 Linux 的 x64/arm64 N-API 预编译文件。package.json 中的 allowScripts 配置跳过 npm 对此版本触发的多余编译， 因此在 Windows 上安装它不需要 Visual Studio C++ Build Tools。其他依赖的安装脚本仍会执行。 升级 better-sqlite3 时需重新检查此配置。

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

首次开发启动：

npm run electron:dev:openclaw

OpenClaw runtime 已构建后，日常开发使用：

npm run electron:dev

Renderer 开发服务器默认运行在 http://localhost:5175。

本地开发

# 生产 renderer bundle
npm run build

# Electron main/preload TypeScript 构建
npm run compile:electron

# CI 使用的 Vitest 入口
npm test

# src 全量 ESLint；可能暴露既有历史 lint debt
npm run lint

# 对改动过的 TypeScript 文件执行 CI 风格 lint
npx eslint --ext ts,tsx --report-unused-disable-directives --max-warnings 0 <files>

OpenClaw Runtime

锁定的 OpenClaw 版本和第三方插件列表位于 package.json 的 openclaw 字段。

# 手动构建当前平台 runtime
npm run openclaw:runtime:host

# 指定 OpenClaw 源码路径
OPENCLAW_SRC=/path/to/openclaw npm run electron:dev:openclaw

# 强制重建 runtime
OPENCLAW_FORCE_BUILD=1 npm run electron:dev:openclaw

# 保持本地 OpenClaw checkout 在当前分支或 tag
OPENCLAW_SKIP_ENSURE=1 npm run electron:dev:openclaw

DeepSeek Harness Runtime

锁定的 dsh 版本以及各平台的分发包描述位于 package.json 的 dsh 字段。开发环境读取 vendor/dsh-runtime/current；发布版在首次使用时下载分发包，并用应用自带的摘要校验。

# 构建并激活当前平台的 runtime
npm run dsh:runtime:host

# 启动一次并验证 Web UI 可访问
npm run dsh:runtime:verify

# 完整门禁：构建、打包、经 HTTP 安装、启动、经 RPC 断言 provider/model
npm run dsh:e2e

# 1. 构建（应用锁定的补丁，裁剪到约 160 MB）
npm run dsh:runtime:mac-arm64

# 2. 打包，输出 sha256 与体积
npm run dsh:runtime:pack mac-arm64

# 3. 把 vendor/dsh-dist/dsh-runtime-<版本>-mac-arm64.tar.gz 上传到 CDN，
#    然后登记地址。摘要与体积取自本地 manifest，不会与实际打包的字节脱节。
npm run dsh:runtime:url mac-arm64 "https://cdn.example.com/<上传后的地址>"

# 4. 确认该地址返回的就是这些字节
npm run dsh:runtime:verify-urls mac-arm64

打包

# 1. 严格按 package-lock.json 安装依赖。

#    npm ci 会自己清空 node_modules，不要手动删，也不要先跑 npm install：
#    那样所有依赖会装两遍，还可能改写 lock 文件。
#    postinstall 会应用 patches/ 下的补丁；better-sqlite3 在 Node.js 和 Electron 中
#    均使用包内的 N-API 预编译文件。
npm ci

# 2. 清理旧的构建产物。dist-electron 由 tsc 输出，源文件删掉后旧产物不会自动清理。
npx rimraf dist dist-electron

# 3. 构建安装包，产物输出到 release/。
npm run dist:mac            # macOS，宿主架构
npm run dist:mac:x64
npm run dist:mac:arm64
npm run dist:mac:universal
npm run dist:win            # Windows x64
npm run dist:linux

# 指定渠道的完整安装包
npm run dist:win:channel -- --keyfrom <渠道> [--silent]

# 在线安装器：一个小体积 stub，安装时从你的 CDN 下载主包
npm run dist:win:web -- --keyfrom <渠道> [--silent] [--pkg-base-url <CDN 目录> | --pkg-url <主包地址>]

项目地图

安全与数据

• Renderer 窗口启用 context isolation，禁用 Node integration，并启用 sandbox。
• Renderer 到 Main 的访问都通过 preload IPC API。
• 敏感工具动作需要权限门控，并会记录日志。
• 应用数据保存在 Electron userData 下的本地 lobsterai.sqlite。
• OpenClaw 状态、工作区记忆、生成配置和网关日志位于 userData/openclaw。

社区与支持

扫码加入微信交流群，获取帮助、反馈问题、了解最新动态：

Bug 和功能建议请使用仓库 issue 模板。提交 PR 时请包含简要说明、相关 issue、UI 改动截图，以及涉及 Electron IPC、存储、runtime 或窗口行为的说明。

Star History

许可证

MIT License

由网易有道开发维护。