LobsterAI

An open-source desktop assistant for executing office work in your real local environment.

Stars
★ 6.2k
Last updated
1d ago
License
MIT
Primary language
TypeScript

At a glance

How it runs
Desktop app
Works with
Universal · cross-platform
Cost
Free software; you pay for model usage
Setup effort
Medium · a few setup steps
You'll need
Node.js >=24.15.0 <25npmOpenClaw runtimeShell / CLINetwork accessLocal filesystemMCP Server
Typical use
A small business still tracking purchases and sales in Excel can ask it to build a local inventory system that calculates stock and profit and opens in a browser.
Not a fit if
  • Linux desktop users who want an official installer
  • Teams unwilling to let an agent touch local files and terminal commands

What does this agent do, and when should you use it?

LobsterAI is an Electron desktop application maintained by NetEase Youdao for long-running work across local files, documents, spreadsheets, slides, browser workflows, and project workspaces. Its Cowork session layer owns local persistence, permissions, UI state, artifacts, agents, memory, and instant-messaging bindings, while OpenClaw provides the underlying execution runtime and gateway. The React renderer exposes sessions, agents, skills, MCP, scheduled tasks, and IM settings; the Electron main process handles IPC, SQLite, authentication, logging, and runtime management. The app can preview generated HTML, SVG, images, video, Mermaid diagrams, code, Markdown, text, and office-document artifacts. It fits users or teams that want an agent to operate on their actual desktop environment with approval for sensitive actions.

A user submits work in a Cowork session, where the application streams progress and tool output while retaining session history; it requests approval for sensitive file operations, terminal commands, and network access. openclawConfigSync renders locally configured providers, models, Agents, IM bindings, skills, MCP servers, and workspace instructions into OpenClaw configuration. openclawEngineManager manages the gateway process, runtime state, ports, logs, restart, and repair, while openclawRuntimeAdapter translates gateway events into Cowork stream events. The application stores sessions, messages, configuration, agents, and memory metadata in SQLite, and retains workspace memory in files including MEMORY.md, USER.md, SOUL.md, and daily notes. It also manages scheduled work and can connect the desktop agent to WeChat, WeCom, DingTalk, Feishu/Lark, QQ, Telegram, Discord, email, and other listed IM channels.

  1. A small business still tracking purchases and sales in Excel can ask it to build a local inventory system that calculates stock and profit and opens in a browser.
  2. An operations analyst working with a local product-growth.xlsx file can produce a visual dashboard and a summary of growth drivers.
  3. A business user preparing an AI-agent market briefing can request research and a presentation from the findings.
  4. A marketer who checks an ads dashboard each morning can automate browser checks and receive a summary of spend or conversion anomalies.
  5. A recruiter screening resumes in a local folder can turn them into a screening sheet and shortlist candidates against a job description.
  6. A user away from their computer can send work to a specifically bound desktop agent through a supported IM channel.

How do you install or deploy this agent?

Desktop installers for macOS and Windows are available through the official site or GitHub Releases. Running from source requires Node.js >=24.15.0 <25 and npm:

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

For the first development run, use: npm run electron:dev:openclaw. Once the pinned OpenClaw runtime exists locally, use: npm run electron:dev. The supplied material does not document model-provider credential setup or the credentials required for a first working conversation.

How do you use this agent?

After launch, enter a task concerning local projects, files, or browser work in a Cowork session, and approve sensitive file, terminal, or network actions when prompted. Create specialized Agents in the agent settings with their own identity, model choice, skills, working directory, enabled state, and IM binding; use MCP settings to add external MCP servers, and create recurring work through conversation or the scheduled-task UI. In development mode, the renderer server runs at http://localhost:5175.

What are this agent's strengths and limitations?

Pros
  • Cowork and OpenClaw have a clear split: the desktop application retains local state, permissions, memory, and artifacts while the runtime handles agent execution and gateway behavior.
  • It spans local files, terminal commands, browser workflows, office documents, spreadsheets, and slides, with in-app handling for varied generated artifacts.
  • Sensitive actions are permission-gated and logged; renderer windows use context isolation, disabled Node integration, and sandboxing.
  • Specialized Agents can have separate model choices, skills, working directories, and IM bindings, alongside scheduled tasks and MCP server management.
Limitations
  • Source development explicitly requires Node.js 24.15.x and npm, and the first run must build or ensure the pinned OpenClaw runtime.
  • The supplied material does not specify supported model providers, authentication credentials, or pricing, so usable models and operating cost require separate validation.
  • It can access local files, terminal commands, and network workflows; despite approval controls, adopters must evaluate permission scope and workspace data handling.
  • Official end-user installation is documented for macOS and Windows; Linux has a packaging command but no end-user installation path in the supplied material.

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
LobsterAI This agent 42 · Major gaps Desktop appFree + model costs ★ 6.2k 1d ago TypeScript —
ClawX Desktop 45 · Major gaps Desktop appFree + model costs ★ 7.6k 1d ago TypeScript Codex · OpenAI API
Abu Desktop Assistant 61 · Some gaps Desktop appFree + model costs ★ 420 6d ago TypeScript OpenAI API · Claude API
AionUi Cowork 43 · Major gaps Desktop appFree + model costs ★ 34k 2d ago TypeScript Codex · Claude Code · OpenAI API · Claude API

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
42/ 100 5-point scale 2.1 / 5
This review covers the source as of Aug 09, 2026. The project has shipped 20 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 8/29
Reliability 6/14
Adaptability 9/18
Convention 9/18
Effectiveness 7/13
Verifiability 3/8
Why each dimension lost points
Trust8 / 29 · 1.4/5

Evidence shows: README claims approval before sensitive actions, but no implementation details; permission gating and logging are claimed but not shown in code; many dependencies but no security audit or vulnerability scanning evidence; external effects (file ops, network) mentioned but not detailed; rollback not mentioned; source attribution has author info but publisher unverified. Deductions: lack of concrete implementation evidence, rollback missing.

Reliability6 / 14 · 2.1/5

Evidence shows: README and package.json are largely consistent in feature description, but some inconsistencies (e.g., README mentions 28 skills but not all listed); many dependencies but no availability guarantee; failure messages not mentioned. Deductions: dependency availability unverified, failure messages missing.

Adaptability9 / 18 · 2.5/5

Evidence shows: README describes multiple scenarios (data analysis, slides, docs, etc.) with clear audience; capability boundaries mentioned (e.g., permission gating) but not detailed; trigger precision not mentioned; environment fit includes macOS and Windows but not Linux. Deductions: trigger precision missing, capability boundaries not detailed.

Convention9 / 18 · 2.5/5

Evidence shows: README structure clear with project map; install notes detailed; naming stable (LobsterAI); examples and FAQ (community support) present; known limitations not mentioned; MIT license clear; version number exists but no changelog; maintenance responsibility has author info but unverified. Deductions: known limitations missing, changelog missing.

Effectiveness7 / 13 · 2.7/5

Evidence shows: output usability described (e.g., artifact preview) but not verified; marginal value described (multiple scenarios) but not quantified; cost-benefit not mentioned. Deductions: cost-benefit missing.

Verifiability3 / 8 · 1.9/5

Evidence shows: some claims in README are supported by code (e.g., security measures), but some not verified; cross-source corroboration limited (only repo files); fact-inference separation unclear. Deductions: insufficient cross-source corroboration, unclear fact-inference separation.

Risks and how to mitigate them
  • Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
  • Publisher identity unverified, proceed with caution.
  • Many dependencies, including Git dependencies and private registry, supply chain risk needs assessment.
  • Rollback mechanism missing, may not recover after failed operations.
  • Known limitations not disclosed, potential hidden risks.
Evidence confidence: Low Reviewed Aug 09, 2026 Reviewed revision bef896b2e803 New commits since this review; the score may not cover them
See the full review method →

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. 2026.11.6 LobsterAI 2026.11.6
    Release notes excerpt
    2026.11.2 A release focused on reliability: chat streams now survive mid-reply drops, oversized contexts recover with visible compaction progress, the image pipeline is cheaper and less chatty, and installers ship a lot less dead weight. Highlights 1. Model streams reconnect automatically when they drop mid-reply instead of leaving the message truncated (#2974). 2. Oversized conversations now recover instead of failing, with compaction progress surfaced in the UI (#2982, #3014, #2988). …
    View on GitHub ↗
  2. 2026.10.30 LobsterAI 2026.10.30
    Release notes excerpt
    2026.10.30 Highlights - Image Studio lands — a new image creation surface with close-up erase-and-blend, per-conversation media model selection, and a fixed sharing path for generated images - Conversation polish — large pastes collapse into cards, and history keeps loading until the viewport is full - Account & settings — one saved API key per decision-model provider; redesigned IM settings with WeChat DMs always admitted - Faster startup — startup migrations no longer rerun on every launch, and state databases are prewarmed ✨ New Features …
    View on GitHub ↗
  3. 2026.10.23 LobsterAI 2026.10.23
    Release notes excerpt
    This release brings image editing into your conversations, makes remote tools easier to connect, and gives you clearer visibility into usage. It also improves startup reliability, browser tasks, and account recovery. ✨ Highlights Edit images without leaving your conversation Annotate images with drawings, arrows, shapes, and text, or select an area and describe what you want to change. With a compatible image model, you can remove backgrounds, erase objects, and expand images to a new aspect ratio. …
    View on GitHub ↗

FAQ

Which actions require approval?
The README states that sensitive file operations, terminal commands, and network access require approval and are logged.
Where does it store data?
Application data is stored in lobsterai.sqlite under Electron userData. OpenClaw state, workspace memory, generated configuration, and gateway logs live under userData/openclaw.
Can I control the desktop agent from a messaging app?
Yes. The supplied material lists WeChat, WeCom, DingTalk, Feishu/Lark, QQ, Telegram, Discord, NetEase IM, NetEase Bee, POPO, and email, and says multi-instance platforms can bind different accounts or channels to different Agents.
Does it require a particular model provider, and what does it cost?
The material shows that provider and model configuration is synchronized and that Agents have a model choice, but it does not name supported providers, credential setup, or costs.
View on GitHub ↗ Install ↓

Related agents