Skip to content
Back to search

lobsterai

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/netease-youdao/lobsterai with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/netease-youdao/lobsterai'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/netease-youdao--lobsterai/badge.svg)](/listings/netease-youdao--lobsterai)

HTML

<a href="/listings/netease-youdao--lobsterai"><img src="/api/listings/netease-youdao--lobsterai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Desktop

Download the latest macOS and Windows installers from [Official Website](https://lobsterai.youdao.com/) or [GitHub Releases](https://github.com/netease-youdao/LobsterAI/releases).

Run From Source

Requirements:

- Node.js `>=24.15.0 <25` - npm `>=11.17.0 <12` (older versions: `npm install -g npm@11.17.0`) - git and pnpm, needed on the first run to build the pinned OpenClaw runtime from the sibling `../openclaw` checkout

`better-sqlite3@13.0.3` includes prebuilt N-API binaries for Windows, macOS, and Linux on x64/arm64. The `allowScripts` entry in `package.json` skips npm's unnecessary implicit rebuild for this version, so installing it does not require Visual Studio C++ Build Tools on Windows. Other dependencies' install scripts still run. Recheck this entry when upgrading `better-sqlite3`.

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

First development run:

npm run electron:dev:openclaw

Daily development after the pinned OpenClaw runtime exists:

npm run electron:dev

The renderer dev server runs at `http://localhost:5175`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 179 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="public/logo.png" alt="LobsterAI logo" width="88" />
  3. # LobsterAI
  4. **The open-source desktop AI agent that does real work on your computer.**
  5. Describe a task in plain language. LobsterAI reads your files, runs tools, drives a browser,<br/>
  6. edits Office documents, and hands back finished work — at your desk or from your phone.
  7. <p>
  8. <a href="https://github.com/netease-youdao/LobsterAI/releases/latest"><img src="https://img.shields.io/github/v/release/netease-youdao/LobsterAI?style=flat-square&label=release&color=FF5A36" alt="Latest release" /></a>
  9. <a href="https://github.com/netease-youdao/LobsterAI/stargazers"><img src="https://img.shields.io/github/stars/netease-youdao/LobsterAI?style=flat-square&color=FFB000" alt="GitHub stars" /></a>
  10. <a href="LICENSE"><img src="https://img.shields.io/github/license/netease-youdao/LobsterAI?style=flat-square" alt="MIT license" /></a>
  11. <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows-4493F8?style=flat-square" alt="Platforms: macOS and Windows" />
  12. <a href="https://x.com/LobsterAIYoudao"><img src="https://img.shields.io/badge/follow-%40LobsterAIYoudao-000000?style=flat-square&logo=x" alt="Follow LobsterAI on X" /></a>
  13. <a href="#community"><img src="https://img.shields.io/badge/WeChat-community-07C160?style=flat-square&logo=wechat&logoColor=white" alt="Join the WeChat community" /></a>
  14. </p>
  15. **English** · [简体中文](README_zh.md)
  16. <h3>
  17. <a href="https://lobsterai.youdao.com/#/download-list">Download</a>
  18. &nbsp;·&nbsp;
  19. <a href="#quick-start">Quick start</a>
  20. &nbsp;·&nbsp;
  21. <a href="#features">Features</a>
  22. &nbsp;·&nbsp;
  23. <a href="#build-from-source">Build from source</a>
  24. &nbsp;·&nbsp;
  25. <a href="#community">Community</a>
  26. </h3>
  27. <img src="docs/res/screenshots/hero-en.png" alt="LobsterAI analyzing a spreadsheet and previewing the dashboard it built" width="100%" />
  28. </div>
  29. ## Why LobsterAI
  30. Most AI assistants stop at an answer. LobsterAI is built to finish the job.
  31. - **It works where your work lives.** Point it at a folder and it reads spreadsheets, writes documents, runs scripts, and browses the web, asking before anything sensitive.
  32. - **You see the result, not just a reply.** Web pages, charts, images, videos, PDFs, and Word, Excel, and PowerPoint files open in a side panel, ready to edit or share.
  33. - **It keeps working when you step away.** Schedule recurring jobs, or message your desktop agent from WeChat, Feishu, DingTalk, Telegram, and more.
  34. - **It's yours.** MIT-licensed, with sessions stored locally. Sign in to use the built-in models, or bring your own API keys.
  35. Built by [NetEase Youdao](https://www.youdao.com/), LobsterAI is the first open-source desktop-grade agent from a major Chinese tech company.
  36. ## Features
  37. <table>
  38. <tr>
  39. <td width="50%" valign="top">
  40. <img src="docs/res/screenshots/office-en.png" alt="Editing an Excel workbook inside LobsterAI" />
  41. <p><b>Native Office editing</b><br/>Open Word, Excel, and PowerPoint files right in the app. Edit by hand, or let the agent make changes live alongside you.</p>
  42. </td>
  43. <td width="50%" valign="top">
  44. <img src="docs/res/screenshots/kits-en.png" alt="The kits marketplace" />
  45. <p><b>Kits, skills, and connectors</b><br/>Install role-based kits for engineering, design, finance, sales, and more, pick individual skills, or connect MCP servers.</p>
  46. </td>
  47. </tr>
  48. <tr>
  49. <td width="50%" valign="top">
  50. <img src="docs/res/screenshots/scheduled-tasks-en.png" alt="Scheduled task templates" />
  51. <p><b>Scheduled tasks</b><br/>Turn any prompt into a recurring job: morning briefs, end-of-day wrap-ups, weekly reports, and health checks.</p>
  52. </td>
  53. <td width="50%" valign="top">
  54. <img src="docs/res/screenshots/im-bots-en.png" alt="IM bot settings" />
  55. <p><b>Message it from anywhere</b><br/>Connect a chat app once, then send tasks to your desktop agent from your phone.</p>
  56. </td>
  57. </tr>
  58. </table>
  59. ### Everything in the box
  60. | Capability | What you get |
  61. | --- | --- |
  62. | **Cowork sessions** | Long-running tasks on local projects with streaming progress, a tool timeline, session forks, and approval prompts before file, shell, or network actions. |
  63. | **Artifacts and sharing** | Live previews for HTML, SVG, Mermaid, images, video, Markdown, code, PDF, and Office files. Edit images in place and share results as a link. |
  64. | **Built-in browser** | An in-app browser the agent can drive, with tabs, saved logins, and passkey support, for research and web workflows. |
  65. | **Computer use** | Let the agent operate desktop apps on Windows x64 and macOS 13 or later. |
  66. | **Multiple agents** | Create agents with their own identity, model, skills, and working folder, add ready-made experts from the Expert Plaza, and bind agents to chat channels. |
  67. | **Skills** | Built-in skills for documents, spreadsheets, slides, PDFs, web search, browser automation, image and video generation, stock research, writing, email, and more. See [`SKILLs/`](SKILLs). |
  68. | **MCP connectors** | Add local or remote MCP servers from the marketplace, sign in with OAuth, and choose which tools each server exposes. |
  69. | **IM channels** | WeChat, WeCom, DingTalk, Feishu/Lark, QQ, NetEase IM, NetEase Bee, POPO, Telegram, Discord, and email. Multi-instance platforms can route each bot to a different agent. |
  70. | **Desktop companion** | A floating orb for quick tasks, screenshots, and actions on selected text, such as translating or reading aloud. |
  71. | **Memory and Dreaming** | Durable memory files, plus optional scheduled "Dreaming" runs that consolidate what the agent learned, so preferences carry across sessions. |
  72. | **Models** | Built-in models (DeepSeek, GLM, Kimi, Qwen, MiniMax, and more) after sign-in, or your own keys for OpenAI, Anthropic, Gemini, xAI, OpenRouter, Ollama, LM Studio, and any OpenAI-compatible endpoint. |
  73. | **Library** | Every file your agents create, collected in one place across sessions, both local and shared. |
  74. ## Things to try
  75. | Scenario | Example prompt |
  76. | --- | --- |
  77. | Build a local tool | "I still track inventory and sales in Excel. Build a local inventory system that records purchases and sales, calculates stock and profit, and opens in my browser." |
  78. | Analyze local data | "Use `product-growth.xlsx` to build a visual dashboard and summarize the main growth drivers." |
  79. | Make a deck | "Research the AI agent market and turn the findings into a presentation." |
  80. | Check a web dashboard | "Open the ads dashboard every morning, check spend and conversion anomalies, and summarize likely causes." |
  81. | Screen documents | "Turn the resumes in this folder into a screening sheet and shortlist the strongest candidates against the JD." |
  82. | Run scheduled work | "Every weekday at 9 AM, collect yesterday's AI news and send me a concise digest." |
  83. ## Quick start
  84. 1. **Install LobsterAI.** Download it from the [official website](https://lobsterai.youdao.com/#/download-list), or get the latest release directly:
  85. [macOS (Apple Silicon)](https://github.com/netease-youdao/LobsterAI/releases/latest/download/LobsterAI--mac-arm64.dmg) ·
  86. [macOS (Intel)](https://github.com/netease-youdao/LobsterAI/releases/latest/download/LobsterAI--mac-x64.dmg) ·
  87. [Windows x64](https://github.com/netease-youdao/LobsterAI/releases/latest/download/LobsterAI--win-x64.exe)
  88. 2. **Choose a model.** Sign in to use the built-in models, or add your own API key under **Settings → Custom Model**.
  89. 3. **Give it a task.** Pick a working folder, describe what you want, and approve actions as it works. Generated files open in the side panel.
  90. 4. **Go further.** Install kits from **Kits · Skills · Connectors**, set up recurring work in **Scheduled Tasks**, or connect a chat app under **Settings → IM Bot**.
  91. ## How it works
  92. ```mermaid
  93. flowchart LR
  94. subgraph App["LobsterAI desktop app (Electron)"]
  95. UI["Renderer<br/>React · Redux · Tailwind<br/>sessions · artifacts · Office editors"]
  96. Main["Main process<br/>Cowork sessions · permissions · SQLite<br/>skills · MCP · IM · scheduler"]
  97. UI <-->|"preload IPC"| Main
  98. end
  99. Main <-->|"config sync · events"| Gateway["OpenClaw gateway<br/>bundled agent runtime"]
  100. Gateway --> Models["LLM providers"]
  101. Gateway --> Tools["Local tools<br/>files · shell · browser<br/>computer use · MCP servers"]
  102. Chat["Chat apps<br/>WeChat · Feishu · DingTalk · Telegram …"] <--> Gateway
  103. ```
  104. - **Cowork** is LobsterAI's product layer. It owns sessions, messages, permissions, artifacts, agents, and IM bindings, and stores them locally in SQLite.
  105. - **[OpenClaw](https://github.com/openclaw/openclaw)** is the agent runtime underneath. LobsterAI ships a pinned build, renders its config from app state, and translates its events into the Cowork stream.
  106. - The renderer is sandboxed with context isolation and talks to the main process only through the preload IPC bridge.
  107. ## Build from source
  108. Requirements: Node.js `>=24.15.0 <25`, npm `>=11.17.0 <12`, git, and pnpm.
  109. ```bash
  110. git clone https://github.com/netease-youdao/LobsterAI.git
  111. cd LobsterAI
  112. npm install
  113. # First run: fetches the pinned OpenClaw version into ../openclaw, builds the runtime, and starts the app
  114. npm run electron:dev:openclaw
  115. # Later runs, once the runtime exists
  116. npm run electron:dev
  117. ```
  118. [CONTRIBUTING.md](CONTRIBUTING.md) covers tests, linting, runtime options, packaging installers, and the project layout.
  119. ## Security and privacy
  120. - Sessions, messages, and settings are stored locally in `lobsterai.sqlite` under the app's user data directory. Agent memory and runtime state live alongside it under `openclaw/`.
  121. - File operations, shell commands, and network access are permission-gated, and the agent asks before it acts.
  122. - Renderer windows run with context isolation, sandboxing, and no Node.js integration.
  123. ## Community
  124. Join the WeChat group for help, feedback, and release news. You can also follow [@LobsterAIYoudao](https://x.com/LobsterAIYoudao) on X.
  125. <img src="docs/res/wechat-group.png" alt="WeChat community QR code" width="180" />
  126. Report bugs and request features through [GitHub Issues](https://github.com/netease-youdao/LobsterAI/issues/new/choose).
  127. ## Contributing
  128. Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) to set up your environment, and look for [good first issues](https://github.com/netease-youdao/LobsterAI/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22) to get started.
  129. ## Star history
  130. <a href="https://www.star-history.com/#netease-youdao/lobsterai&Date">
  131. <picture>
  132. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=netease-youdao/lobsterai&type=Date&theme=dark" />
  133. <img src="https://api.star-history.com/svg?repos=netease-youdao/lobsterai&type=Date" alt="Star history chart" width="600" />
  134. </picture>
  135. </a>
  136. ## License
  137. [MIT](LICENSE) © NetEase Youdao

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.