MCPcopy Index your code
hub / github.com/netease-youdao/LobsterAI

github.com/netease-youdao/LobsterAI @2026.7.3

repository ↗ · DeepWiki ↗ · release 2026.7.3 ↗ · + Follow
7,352 symbols 20,527 edges 893 files 695 documented · 9%
README

LobsterAI LobsterAI

GitHub stars License Follow LobsterAI on X Follow LobsterAI on X

Supported platforms: macOS and Windows Electron 40 React 18

English · 中文

全场景办公助手 Agent。

国内大厂首个开源桌面级 Agent,网易有道出品。

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

下载 LobsterAI

main page

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.mdUSER.mdSOUL.md 和每日笔记等文件,让偏好和项目上下文能够跨会话延续。

实战指令

场景 示例指令
搭建本地系统 "我还在用 Excel 记录库存和销售,帮我做一个本地进销存系统,可以录入进货和销售,自动计算库存和利润,并能在浏览器打开。"
分析本地数据 "基于 product-growth.xlsx 做一个可视化看板,并总结主要增长原因。"
生成汇报 PPT "调研 AI Agent 市场格局,并把结论整理成一份演示文稿。"
自动检查网页后台 "每天早上打开广告后台,检查消耗和转化是否异常,并总结可能原因。"
批量筛选文档 "把这个文件夹里的简历整理成筛选表,对照 JD 选出最匹配的人。"
定时执行任务 "每个工作日早上 9 点收集昨天的 AI 新闻,并发我一份简洁摘要。"

工作原理

LobsterAI 架构

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

安装

桌面端

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

从源码运行

环境要求:

  • Node.js >=24.15.0 <25
  • npm
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.jsonopenclaw 字段。

# 手动构建当前平台 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

打包

构建桌面安装包

# macOS
npm run dist:mac
npm run dist:mac:x64
npm run dist:mac:arm64
npm run dist:mac:universal

# Windows
npm run dist:win

# Linux
npm run dist:linux

打包会把 OpenClaw runtime 内置到 Resources/cfmind。Windows 构建还会把便携 Python 运行时内置到 resources/python-win,终端用户无需手动安装 Python。

离线或私有源打包可使用:

  • LOBSTERAI_PORTABLE_PYTHON_ARCHIVE
  • LOBSTERAI_PORTABLE_PYTHON_URL
  • LOBSTERAI_WINDOWS_EMBED_PYTHON_VERSION
  • LOBSTERAI_WINDOWS_EMBED_PYTHON_URL
  • LOBSTERAI_WINDOWS_GET_PIP_URL

项目地图

路径 用途
src/main/main.ts Electron 生命周期、IPC 注册、鉴权、日志、runtime 启动和服务装配
src/main/libs/openclawEngineManager.ts OpenClaw 网关进程、运行时状态、端口、日志、重启和修复
src/main/libs/openclawConfigSync.ts 将 LobsterAI 的 provider、model、agent、IM 绑定、skills、MCP 和工作区指令渲染为 OpenClaw 配置
src/main/libs/agentEngine/openclawRuntimeAdapter.ts 将 OpenClaw 网关事件翻译为 Cowork 流式事件
src/main/coworkStore.ts Cowork 会话、消息、配置、Agents、记忆元数据和 SQLite CRUD
src/renderer/components/cowork/ 主 Cowork UI、输入框、会话详情、权限、思考/工具展示、媒体和语音输入
src/renderer/components/agent/ Agent 创建和设置 UI
src/renderer/components/skills/ 技能管理 UI
src/renderer/components/mcp/ MCP 服务管理 UI
src/renderer/components/scheduledTasks/ 定时任务列表、表单、详情、运行历史和模板
src/renderer/services/i18n.ts Renderer i18n 字典和 t() helper
SKILLs/ LobsterAI 内置技能

安全与数据

  • 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

Star History Chart

许可证

MIT License

网易有道开发维护。

Extension points exported contracts — how you extend this code

TaskPolicy (Interface)
(no doc) [8 implementers]
src/scheduledTask/policies/types.ts
FetchHeadersLike (Interface)
(no doc) [6 implementers]
src/main/libs/mediaAssetPersistence.ts
ThemeStorage (Interface)
(no doc) [3 implementers]
src/renderer/theme/engine/theme-manager.ts
BrowserConfig (Interface)
(no doc)
SKILLs/web-search/server/config.ts
AsrRealtimeSessionRequest (Interface)
(no doc)
src/shared/asr/constants.ts
GoalDisplayCommand (Interface)
(no doc)
src/common/goalCommandDisplay.ts
InferableTask (Interface)
Minimal ScheduledTask shape needed for inference (avoids importing renderer types)
src/scheduledTask/origin.ts
CoworkRuntime (Interface)
(no doc) [4 implementers]
src/main/libs/agentEngine/types.ts

Core symbols most depended-on inside this repo

t
called by 2061
src/renderer/services/i18n.ts
get
called by 476
src/renderer/theme/engine/theme-manager.ts
set
called by 440
src/renderer/theme/engine/theme-manager.ts
get
called by 431
src/main/libs/mediaAssetPersistence.ts
on
called by 307
src/main/libs/agentEngine/types.ts
t
called by 269
src/renderer/components/artifacts/ArtifactPanel.tsx
delete
called by 210
src/main/sqliteStore.ts
t
called by 180
src/main/i18n.ts

Shape

Function 4,628
Method 1,639
Interface 915
Class 169
Enum 1

Languages

TypeScript96%
Python4%

Modules by API surface

src/main/libs/agentEngine/openclawRuntimeAdapter.ts296 symbols
src/main/main.ts215 symbols
src/main/coworkStore.ts132 symbols
src/renderer/components/artifacts/ArtifactPanel.tsx110 symbols
src/renderer/components/Settings.tsx108 symbols
src/main/im/imStore.ts106 symbols
src/main/libs/dataMigration/dataMigrationService.ts102 symbols
src/renderer/types/electron.d.ts101 symbols
src/main/skills/skillManager.ts97 symbols
src/main/im/imGatewayManager.ts89 symbols
src/main/libs/coworkOpenAICompatProxy.ts88 symbols
src/renderer/components/cowork/CoworkSessionDetail.tsx81 symbols

Dependencies from manifests, versioned

7zip-bin5.2.0 · 1×
@codemirror/lang-cpp6.0.3 · 1×
@codemirror/lang-css6.3.1 · 1×
@codemirror/lang-go6.0.1 · 1×
@codemirror/lang-html6.4.11 · 1×
@codemirror/lang-java6.0.2 · 1×
@codemirror/lang-javascript6.2.5 · 1×
@codemirror/lang-json6.0.2 · 1×
@codemirror/lang-markdown6.5.0 · 1×
@codemirror/lang-php6.0.2 · 1×
@codemirror/lang-python6.2.1 · 1×
@codemirror/lang-rust6.0.2 · 1×

Datastores touched

(mysql)Database · 1 repos
lobsterai_serverDatabase · 1 repos

For agents

$ claude mcp add LobsterAI \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact