Model or dataset
netease-youdao/LobsterAI avatar
netease-youdao/LobsterAI

LobsterAI: NetEase Youdao's Open-Source Desktop Agent Built on OpenClaw

Open-source, desktop-grade AI agent that gets real work done — data analysis, slides, docs, video & web research. Built on OpenClaw; runs tools on your real desktop and takes commands from your phone via WeChat, Feishu, DingTalk & Telegram.

6,034 stars963 forksTypeScriptMIT

At a glance

What is it?
LobsterAI is a desktop-grade AI agent from NetEase Youdao that runs on your local machine, executes real tasks like data analysis and slide creation, and integrates with OpenClaw for agent execution.
Who is it for?
Adopt LobsterAI if you want a desktop-first agent that can touch local files and terminals, and if you value the OpenClaw runtime underneath. Skip it if you need headless server deployment, Linux support, or a completely self-contained codebase without an external runtime.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What LobsterAI Solves and Who It Targets

LobsterAI addresses a specific gap: most AI agents run in the cloud or in a sandbox, so they cannot touch your real files, run your terminal commands, or open your browser. LobsterAI is a desktop application that operates in your actual working environment. It targets office workers and engineers who want an agent that handles data analysis, slide generation, document processing, video creation, and web research without moving data to a remote service. NetEase Youdao, the maker of Youdao Dictionary and other productivity tools, positions it as the first open-source desktop-grade agent from a major Chinese tech company. The README emphasizes 'all-scenario office assistant Agent,' which means the intended user is someone doing knowledge work on a laptop, not a developer building a server-side automation pipeline.

Architecture: Electron Front End, OpenClaw Runtime

The repository splits cleanly into two layers. The Cowork layer is the product and session surface: it handles local persistence, permissions, UI state, artifacts, agents, memory, and IM bindings inside the Electron app. Underneath, OpenClaw is the runtime and gateway that executes agent tasks. This separation is deliberate. LobsterAI keeps all user data and configuration local, while OpenClaw handles the heavy lifting of running tools and coordinating model calls. The main process in Electron manages lifecycle, IPC, SQLite persistence, authentication, logging, and OpenClaw startup. It also includes modules like `openclawEngineManager`, `openclawConfigSync`, and `coworkEngineRouter` that translate LobsterAI state into OpenClaw runtime behavior. The renderer uses React, Redux Toolkit, and Tailwind for the UI. This architecture means you get a polished desktop app with a proven agent runtime underneath, but it also means you are tied to OpenClaw's evolution and its installation requirements.

Getting It Running: Installers and Source Build

The fastest path is to download installers for macOS and Windows from the official website or GitHub Releases. The README shows no Linux support; the badge only lists macOS and Windows. Running from source requires Node.js version 24.15.0 or higher but less than 25, npm, and git. The first run also needs pnpm because the pinned OpenClaw runtime must be built from a sibling checkout at `../openclaw`. The commands are straightforward: clone the repository, run `npm install`, then start development with `npm run electron:dev:openclaw`. For daily development after the runtime exists, use `npm run electron:dev`. The renderer dev server runs at `http://localhost:5175`. This setup is not trivial. The dependency on a sibling OpenClaw checkout means you cannot simply clone and run; you must also clone OpenClaw into a specific relative path. That is a real barrier for contributors who expect a single-repo workflow.

Skills, Expert Kits, and MCP Integration

LobsterAI ships with 28 built-in skills, configured in `SKILLs/skills.config.json`. These cover web search, Word documents, spreadsheets, PowerPoint, PDF processing, Remotion video generation, browser automation, image and video generation, stock research, content writing, email, weather, and even skill creation. Skills are individual tools you can enable or disable. Expert Kits are scenario-oriented packages that bundle capability selections and references for common workflows. Kits are selected independently from direct skills, so you can combine curated kits with individual tools. This is a flexible model for users who need repeatable roles. For external tools, LobsterAI supports Model Context Protocol (MCP) servers. Users can configure MCP servers locally, and the app syncs enabled servers into OpenClaw. This aligns with the broader MCP ecosystem, letting you plug in custom data sources or tools without modifying the core agent.

IM Remote Control and Scheduled Tasks

A distinctive feature is the ability to control the desktop agent from messaging platforms. LobsterAI supports WeChat, WeCom, DingTalk, Feishu/Lark, QQ, Telegram, Discord, NetEase IM, NetEase Bee, POPO, and email. Multi-instance platforms can bind different accounts or channels to different agents. This turns your phone into a remote control for a desktop-run task. You could ask for a daily news digest via Telegram while the agent runs on your office PC. Scheduled tasks complement this. You can create recurring work through conversation or through a UI, such as daily news digests, inbox summaries, website monitoring, or weekly reports. The combination of IM bindings and scheduling makes LobsterAI feel like a personal assistant that is always reachable, but it also introduces security concerns. The README says the agent asks for approval before sensitive actions like file operations, terminal commands, or network access, but remote IM control increases the risk surface if credentials leak.

Local Memory and Data Persistence

LobsterAI stores sessions and app data locally in SQLite. This is a privacy advantage: no cloud database holds your conversation history or file metadata. The OpenClaw workspace memory uses files such as `MEMORY.md`, `USER.md`, `SOUL.md`, and daily notes. These files persist durable preferences and project context across sessions. That means the agent can remember your working style, your name, and your project conventions without needing a vector database. The use of plain text files for memory is simple and auditable. You can read exactly what the agent remembers. This is a contrast to agents that store memory in opaque embeddings. However, the README does not detail how memory files are structured or how conflicts are resolved when multiple agents write to the same workspace. That is a gap you would need to explore in the source.

Limitations and Failure Modes

The most obvious limitation is platform support. Only macOS and Windows are listed; Linux users are left out. The source build requirement for Node.js 24.15.0 is strict, and the need for a sibling OpenClaw checkout complicates setup. The README also mentions that running `npm run lint` may expose existing legacy debt, which suggests the codebase has areas that are not fully clean. Another failure mode is the dependency on OpenClaw as a runtime. LobsterAI is not a standalone agent; it is a front end and session manager. If OpenClaw changes its API or has bugs, LobsterAI inherits them. The release cadence is rapid (three releases in early September 2026), which indicates active development but also means frequent updates. For users who want a stable, long-lived tool, this churn could be a concern. Finally, the IM remote control feature is powerful but could be misused if an attacker gains access to your messaging account. The approval mechanism helps, but it depends on the user noticing a prompt on the desktop.

Alternatives and Comparison

The closest alternative is OpenClaw itself, which is the runtime underneath LobsterAI. OpenClaw is a command-line and server-side agent framework that you can use directly without a desktop UI. If you only need agent execution and are comfortable with a terminal and configuration files, OpenClaw gives you more control and fewer moving parts. LobsterAI adds a GUI, IM bindings, and artifact previews on top of that runtime. Another alternative is a cloud-based agent like ChatGPT Code Interpreter or a hosted automation platform, but those do not run on your local desktop with full file access. The key difference is that LobsterAI is desktop-first and local-first, while OpenClaw is runtime-first and more flexible for headless or server use. If you are a developer who wants to script agent workflows, OpenClaw alone may suffice. If you want a polished product for non-technical office staff, LobsterAI is the better fit.

Maintenance, Licensing, and Upgrade Cost

The project is licensed under MIT, which is permissive and allows commercial use, modification, and redistribution with attribution. The README does not mention any contributor license agreement or trademark restrictions, so you can fork it freely. Maintenance cost is moderate. The project has an active release schedule, with three releases in a single week in September 2026. That means you will need to track updates to get bug fixes and new features. The dependency on a pinned OpenClaw runtime is a double-edged sword. The pinned version ensures reproducibility, but upgrading OpenClaw may require changes in LobsterAI's integration modules. The README mentions 'runtime repair' as a main-process responsibility, which suggests the app can recover from broken runtime states, but that is an extra layer of complexity. For a company adopting this, the main cost is not the license but the time to understand the OpenClaw integration and to test each new release against your workflows.

Editorial conclusion

Adopt LobsterAI if you want a desktop-first agent that can touch local files and terminals, and if you value the OpenClaw runtime underneath. Skip it if you need headless server deployment, Linux support, or a completely self-contained codebase without an external runtime. Before adopting, verify the pinned OpenClaw runtime version, test IM gateway stability with your chosen platform, and review the 28 built-in skills to see if they meet your use cases. The project is young and active, but the architecture's reliance on sibling checkouts and Electron means you must plan for upgrade friction.

Official sources

  1. License: MIT
  2. netease-youdao/LobsterAI on GitHub
  3. Project website
  4. README
  5. Releases
Community notes

Community notes