LobsterAI — 全场景个人助理 Agent

LobsterAI 是由网易有道开发的全场景个人助理 Agent。它 7×24 小时待命，能够帮你完成日常办公中的各类事务 —— 数据分析、制作 PPT、生成视频、撰写文档、搜索信息、收发邮件、定时任务，以及更多。

LobsterAI 的核心是 Cowork 模式，它能在本地或沙箱环境中执行工具、操作文件、运行命令，一切都在你的监督下自主完成。此外，LobsterAI 支持通过钉钉、飞书、Telegram、Discord 等 IM 平台远程触发，让你在手机上也能随时指挥 Agent 工作。

核心特性

全场景办公助理 — 数据分析、PPT 制作、视频生成、文档撰写、Web 搜索、邮件收发，覆盖日常办公全流程
本地 + 沙箱执行 — 任务执行支持本地直接运行或隔离的 Alpine Linux 沙箱
内置技能 — 包括 Office 文档生成、Web 搜索、Playwright 自动化、Remotion 视频生成等
定时任务 — 支持对话式发起或 GUI 界面添加定时任务，如每日新闻收集、邮箱整理、周期性报告生成等
持久记忆 — 自动从对话中提取用户偏好与个人信息，跨会话记住你的习惯，越用越懂你
IM 远程操控 — 通过钉钉、飞书、Telegram、Discord 在手机端随时触发 Agent
权限门控 — 所有敏感工具调用需用户明确批准后执行
跨平台 — macOS（Intel + Apple Silicon）、Windows、Linux 桌面端，配合 IM 实现移动端覆盖
数据本地化 — SQLite 本地存储，聊天记录和配置不离开你的设备

工作原理

快速开始

环境要求

Node.js >= 24 < 25
npm

安装与开发

# 克隆仓库
git clone https://github.com/netease-youdao/LobsterAI.git
cd lobsterai

# 安装依赖
npm install

# 启动开发环境（Vite 开发服务器 + Electron 热重载）
npm run electron:dev

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

生产构建

# 编译 TypeScript + Vite 打包
npm run build

# ESLint 代码检查
npm run lint

打包分发

使用 electron-builder 生成各平台安装包，输出到 release/ 目录。

# macOS (.dmg)
npm run dist:mac

# macOS - 仅 Intel
npm run dist:mac:x64

# macOS - 仅 Apple Silicon
npm run dist:mac:arm64

# macOS - Universal (双架构)
npm run dist:mac:universal

# Windows (.exe NSIS 安装包)
npm run dist:win

# Linux (.AppImage)
npm run dist:linux

架构概览

LobsterAI 采用 Electron 严格进程隔离架构，所有跨进程通信通过 IPC 完成。

进程模型

Main Process（src/main/main.ts）：

窗口生命周期管理
SQLite 数据持久化
CoworkRunner — Claude Agent SDK 执行引擎
IM 网关 — 钉钉、飞书、Telegram、Discord 远程接入
40+ IPC 通道处理
安全：context isolation 启用，node integration 禁用，sandbox 启用

Preload Script（src/main/preload.ts）：

通过 contextBridge 暴露 window.electron API
包含 cowork 命名空间用于会话管理和流式事件

Renderer Process（src/renderer/）：

React 18 + Redux Toolkit + Tailwind CSS
所有 UI 和业务逻辑
仅通过 IPC 与主进程通信

目录结构

src/
├── main/                           # Electron 主进程
│   ├── main.ts                     # 入口，IPC 处理
│   ├── preload.ts                  # 安全桥接
│   ├── sqliteStore.ts              # SQLite 存储
│   ├── coworkStore.ts              # 会话/消息 CRUD
│   ├── skillManager.ts             # 技能管理
│   ├── im/                         # IM 网关（钉钉/飞书/Telegram/Discord）
│   └── libs/
│       ├── coworkRunner.ts         # Agent SDK 执行器
│       ├── coworkVmRunner.ts       # 沙箱 VM 执行
│       ├── coworkSandboxRuntime.ts # 沙箱生命周期
│       └── coworkMemoryExtractor.ts # 记忆提取
│
├── renderer/                        # React 前端
│   ├── App.tsx                     # 根组件
│   ├── types/                      # TypeScript 类型定义
│   ├── store/slices/               # Redux 状态切片
│   ├── services/                   # 业务逻辑层（API/IPC/i18n）
│   └── components/
│       ├── cowork/                 # Cowork UI 组件
│       ├── artifacts/              # Artifact 渲染器
│       ├── skills/                 # 技能管理 UI
│       ├── im/                     # IM 集成 UI
│       └── Settings.tsx            # 设置面板
│
SKILLs/                              # 技能定义目录
├── skills.config.json              # 技能启停与排序配置
├── web-search/                     # Web 搜索
├── docx/                           # Word 文档生成
├── xlsx/                           # Excel 表格
├── pptx/                           # PowerPoint 演示
├── pdf/                            # PDF 处理
├── remotion/                       # 视频生成
├── playwright/                     # Web 自动化
└── ...                             # 更多技能

Cowork 系统

Cowork 是 LobsterAI 的核心功能 —— 基于 Claude Agent SDK 的 AI 工作会话系统。它面向办公场景设计，能够自主完成数据分析、文档生成、信息检索等复杂任务。

执行模式

模式	说明
`auto`	自动根据上下文选择执行方式
`local`	本地直接执行，全速运行
`sandbox`	隔离的 Alpine Linux VM，安全优先

流式事件

Cowork 通过 IPC 事件实现实时双向通信：

message — 新消息加入会话
messageUpdate — 流式内容增量更新
permissionRequest — 工具执行需要用户审批
complete — 会话执行完毕
error — 执行出错

权限控制

所有涉及文件系统、终端命令、网络请求的工具调用都需要用户在 CoworkPermissionModal 中明确批准。支持单次批准和会话级批准。

技能系统

LobsterAI 内置 16 种技能，覆盖办公、创作、自动化等多种场景，通过 SKILLs/skills.config.json 配置启停和排序：

技能	功能	典型场景
web-search	Web 搜索	信息检索、资料收集
docx	Word 文档生成	报告撰写、方案输出
xlsx	Excel 表格生成	数据分析、报表制作
pptx	PowerPoint 制作	演示文稿、汇报材料
pdf	PDF 处理	文档解析、格式转换
remotion	视频生成（Remotion）	宣传视频、数据可视化动画
playwright	Web 自动化	网页操作、自动化测试
canvas-design	Canvas 绘图设计	海报、图表设计
frontend-design	前端 UI 设计	原型制作、页面设计
develop-web-game	Web 游戏开发	小游戏快速原型
scheduled-task	定时任务	周期性工作自动执行
weather	天气查询	天气信息获取
local-tools	本地系统工具	文件管理、系统操作
create-plan	计划编排	项目规划、任务分解
skill-creator	自定义技能创建	扩展新能力
imap-smtp-email	邮件收发	邮件处理、自动回复

支持通过 skill-creator 创建自定义技能并热加载。

定时任务

LobsterAI 支持创建定时任务，让 Agent 按计划自动执行重复性工作。

创建方式

对话式创建 — 直接用自然语言告诉 Agent（如「每天早上 9 点帮我收集科技新闻」），Agent 会自动创建对应的定时任务
GUI 界面创建 — 在定时任务管理面板中手动添加，可视化配置执行时间和任务内容

典型场景

场景	示例
新闻收集	每天早上自动收集行业资讯并生成摘要
邮箱整理	定时检查收件箱，分类整理并汇总重要邮件
数据报告	每周自动生成业务数据分析报告
信息监控	定期检查指定网站内容变化并通知
工作提醒	按计划生成待办事项清单或会议纪要

定时任务基于 Cron 表达式调度，支持分钟、小时、日、周、月等多种周期粒度。任务执行时会自动启动 Cowork 会话，结果可通过桌面端查看或经 IM 推送到手机。

IM 集成 — 手机端远程操控

LobsterAI 支持将 Agent 桥接到多种 IM 平台。在手机上通过 IM 发送消息即可远程触发桌面端的 Agent 执行任务，随时随地指挥你的个人助理。

平台	协议	说明
钉钉	DingTalk Stream	企业机器人双向通信
飞书	Lark SDK	飞书应用机器人
Telegram	grammY	Bot API 接入
Discord	discord.js	Discord Bot 接入

在设置面板中配置对应平台的 Token/密钥即可启用。配置完成后，你可以在手机 IM 中直接对 Agent 下达指令（如「帮我分析这份数据」「做一份本周工作汇报 PPT」），Agent 会在桌面端自动执行并返回结果。

持久记忆

LobsterAI 内置记忆系统，能够跨会话记住你的个人信息和偏好，让 Agent 越用越懂你。

记忆获取方式

自动提取 — 对话过程中，系统自动识别并记录你的个人信息（姓名、职业等）、偏好习惯（喜好的语言、格式、风格）和个人事实（养的宠物、使用的工具等），无需手动操作
主动告知 — 在对话中直接说「记住我喜欢用 Markdown 格式」「记下我的项目叫 LobsterAI」等，Agent 会以更高置信度存储
手动管理 — 在设置面板的记忆管理界面中手动添加、编辑或删除记忆条目

工作机制

每轮对话结束后，记忆提取器会分析对话内容：

提取类型	示例	置信度
个人档案	「我叫张三」「我是产品经理」	高
个人所有	「我养了一只猫」「我有一台 MacBook」	高
个人偏好	「我喜欢简洁的风格」「我偏好英文回复」	中高
助手偏好	「回复时不要用 emoji」「代码用 TypeScript」	中高
主动告知	「记住这个」「请记下来」	最高

提取的记忆会自动去重、合并，并在后续会话中注入到 Agent 的上下文中，使 Agent 的回复更加个性化和贴合你的需求。

记忆设置

配置项	说明	默认值
记忆开关	启用或关闭记忆功能	开启
自动捕获	是否自动从对话中提取记忆	开启
捕获严格度	严格 / 标准 / 宽松，控制自动提取的灵敏度	标准
最大注入条数	每次会话注入的记忆上限（1-60）	12

数据存储

所有数据存储在本地 SQLite 数据库（lobsterai.sqlite，位于用户数据目录）。

表	用途
`kv`	应用配置键值对
`cowork_config`	Cowork 设置（工作目录、系统提示词、执行模式）
`cowork_sessions`	会话元数据
`cowork_messages`	消息历史
`scheduled_tasks`	定时任务定义

安全模型

LobsterAI 在多个层面实施安全控制：

进程隔离 — context isolation 启用，node integration 禁用
权限门控 — 敏感工具调用需用户明确审批
沙箱执行 — 可选 Alpine Linux VM 隔离执行环境
工作区边界 — 文件操作限制在指定工作目录内
IPC 验证 — 所有跨进程调用经过类型检查

Github地址：LobsterAI/README_zh.md at main · netease-youdao/LobsterAI