LobsterAI — 全场景个人助理 Agent

7×24 小时帮你干活的全场景个人助理，由网易有道开发

---

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

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

核心特性

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

工作原理

快速开始

环境要求

• Node.js >= 24 < 25
• npm

安装与开发

bash
123456789
# 克隆仓库git clone https://github.com/netease-youdao/LobsterAI.gitcd lobsterai # 安装依赖npm install # 启动开发环境（Vite 开发服务器 + Electron 热重载）npm run electron:dev

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

带 OpenClaw Agent 引擎开发

LobsterAI 可以使用 OpenClaw 作为 Agent 引擎。 所依赖的 OpenClaw 版本在 package.json 的 openclaw.version 字段中声明。

bash
12345
# 首次运行：自动克隆并构建 OpenClaw（可能需要几分钟）npm run electron:dev:openclaw # 后续运行：如果锁定版本未变，自动跳过构建npm run electron:dev:openclaw

默认 OpenClaw 源码会被克隆/管理在 ../openclaw（相对于本仓库）。可通过环境变量覆盖：

bash
1
OPENCLAW_SRC=/path/to/openclaw npm run electron:dev:openclaw

强制重新构建（即使版本未变）：

bash
1
OPENCLAW_FORCE_BUILD=1 npm run electron:dev:openclaw

跳过自动版本切换（如需本地开发 OpenClaw 时）：

bash
1
OPENCLAW_SKIP_ENSURE=1 npm run electron:dev:openclaw

生产构建

bash
12345
# 编译 TypeScript + Vite 打包npm run build # ESLint 代码检查npm run lint

打包分发

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

bash
1234567891011121314151617
# macOS (.dmg)npm run dist:mac # macOS - 仅 Intelnpm run dist:mac:x64 # macOS - 仅 Apple Siliconnpm run dist:mac:arm64 # macOS - Universal (双架构)npm run dist:mac:universal # Windows (.exe NSIS 安装包)npm run dist:win # Linux (.AppImage)npm run dist:linux

桌面端打包（macOS / Windows / Linux）都会把预构建的 OpenClaw runtime 内置到 Resources/cfmind。 锁定的 OpenClaw 版本（package.json → openclaw.version）在打包时会自动拉取并构建，无需手动操作。 构建结果带缓存：如果本地已存在对应版本的 runtime，构建步骤会自动跳过。

也可以手动构建 OpenClaw runtime：

bash
12345678
# 按当前主机平台自动选择 target（mac/win/linux + 架构）npm run openclaw:runtime:host # 显式指定目标平台npm run openclaw:runtime:mac-arm64npm run openclaw:runtime:mac-x64npm run openclaw:runtime:win-x64npm run openclaw:runtime:linux-x64

如需覆盖 OpenClaw 源码路径：

bash
1
OPENCLAW_SRC=/path/to/openclaw npm run dist:win

Windows 打包会内置便携 Python 运行时到 resources/python-win（安装包资源目录为 python-win），终端用户无需手动安装 Python。 该运行时以解释器为主，不预装 LobsterAI 技能所需的 Python 三方包；相关依赖可在运行时按需安装。 默认情况下，如果未提供预构建压缩包，打包脚本会直接从 python.org 下载官方 embeddable Python 运行时。 离线或无法联网的构建场景，请显式提供预构建运行时压缩包。

企业离线/私有源打包可通过以下环境变量配置：

• LOBSTERAI_PORTABLE_PYTHON_ARCHIVE：本地预构建运行时压缩包路径（离线 CI/CD 推荐）
• LOBSTERAI_PORTABLE_PYTHON_URL：预构建运行时压缩包下载地址
• LOBSTERAI_WINDOWS_EMBED_PYTHON_VERSION / LOBSTERAI_WINDOWS_EMBED_PYTHON_URL / LOBSTERAI_WINDOWS_GET_PIP_URL：Windows 主机构建时自动拉取源的可选覆盖项

架构概览

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 与主进程通信

目录结构

12345678910111213141516171819202122232425262728293031323334
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 执行器│       └── 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 工作会话系统。它面向办公场景设计，能够自主完成数据分析、文档生成、信息检索等复杂任务。

执行模式

流式事件

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

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

权限控制

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

技能系统

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

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

定时任务

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

创建方式

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

典型场景

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

IM 集成 — 手机端远程操控

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

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

持久记忆

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

记忆获取方式

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

工作机制

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

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

记忆设置

数据存储

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

安全模型

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

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

技术栈

配置

应用配置

应用级配置存储在 SQLite kv 表中，通过设置面板修改。

Cowork 配置

Cowork 会话配置包含：

• 工作目录 — Agent 操作的根目录
• 系统提示词 — 自定义 Agent 行为
• 执行模式 — auto / local

国际化

支持中文（默认）和英文两种语言，通过设置面板切换。

OpenClaw 版本管理

LobsterAI 将 OpenClaw 依赖锁定到指定的 release 版本，在 package.json 中声明：

json
123456
{  "openclaw": {    "version": "v2026.3.2",    "repo": "https://github.com/openclaw/openclaw.git"  }}

工作原理

更新 OpenClaw 版本

1. 修改 package.json 中 openclaw.version 为目标 release tag
2. 执行 npm run electron:dev:openclaw 或 npm run dist:win — 新版本会自动拉取并构建
3. 提交 package.json 的变更

环境变量

开发规范

• TypeScript 严格模式，函数式组件 + Hooks
• 2 空格缩进，单引号，分号
• 组件 PascalCase，函数/变量 camelCase，Redux 切片 *Slice.ts
• Tailwind CSS 优先，避免自定义 CSS
• 提交信息遵循 type: short imperative summary 格式（如 feat: add artifact toolbar）

贡献

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/your-feature)
3. 提交改动 (git commit -m 'feat: add something')
4. 推送到远程 (git push origin feature/your-feature)
5. 发起 Pull Request

PR 描述中请包含：变更说明、关联 issue、UI 变更附截图，以及涉及 Electron 特定行为的说明。

许可证

MIT License

Star History