Productivity
Plugin
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.
Plugin Signal75/100Solid
maintained99
capable29
documented100
adopted80
Stats
5,846
Stars
922
Forks
Active
Maintenance
TypeScript
Language
MIT
License
4m ago
Last commit
5mo ago
Created
Repo: netease-youdao/lobsterai
What's inside
Agents
3README
1LobsterAI is a desktop Agent that can operate in your real working environment: local files, terminal commands, browser workflows, documents, spreadsheets, slides, IM channels, scheduled jobs, and project workspaces.
Cowork is the LobsterAI product/session layer. OpenClaw is the runtime and gateway underneath it. That split lets LobsterAI keep local persistence, permissions, UI state, artifacts, agents, memory, and IM bindings in the desktop app while using OpenClaw for agent execution.
Features
Desktop Cowork Sessions
Run long-form Agent tasks against local projects and files. LobsterAI streams progress, keeps session history, renders tool output, and asks for approval before sensitive actions such as file operations, terminal commands, or network access.
Multi-Agent Workflows
Create custom Agents with their own identity, model choice, skills, working directory, enabled state, and IM bindings. Keep the Main Agent for general work and use specialized Agents for repeatable roles.
Expert Kits
Install scenario-oriented Expert Kits that package capability selections and references for common workflows. Kits are selected independently from direct skills, so a workflow can combine curated kits with individual tools.
Skills
LobsterAI ships with 28 built-in skills configured in SKILLs/skills.config.json, including web search, Word documents, spreadsheets, PowerPoint, PDF processing, Remotion video generation, browser automation, image/video generation, stock research, content writing, email, weather, and skill creation.
MCP Servers
Connect external tools and data sources through Model Context Protocol servers. LobsterAI stores user-configured servers locally and syncs enabled servers into OpenClaw.
Scheduled Tasks
Create recurring work either by conversation or through the scheduled task UI. Use it for daily news digests, inbox summaries, website monitoring, weekly reports, and other repeatable work.
IM Remote Control
Reach your desktop Agent from 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.
Rich Artifacts
Preview and manage generated HTML, SVG, images, video, Mermaid diagrams, code, Markdown, text, documents, and local service artifacts inside the desktop app.
Local Memory And Data
Sessions and app data live locally in SQLite. OpenClaw workspace memory uses files such as MEMORY.md, USER.md, SOUL.md, and daily notes, so durable preferences and project context can carry across sessions.
Real-World Prompts
| Scenario | Example prompt |
|---|---|
| Build a local system | "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." |
| Analyze local data | "Use product-growth.xlsx to build a visual dashboard and summarize the main growth drivers." |
| Generate a deck | "Research the AI Agent market and turn the findings into a presentation." |
| Automate browser checks | "Open the ads dashboard every morning, check spend and conversion anomalies, and summarize likely causes." |
| Screen documents | "Turn the resumes in this folder into a screening sheet and shortlist the strongest candidates against the JD." |
| Run scheduled work | "Every weekday at 9 AM, collect yesterday's AI news and send me a concise digest." |
How It Works
- Renderer: React, Redux Toolkit, Tailwind, artifact renderers, settings, agent/session UI, skills, MCP, scheduled tasks, and IM configuration.
- Main process: Electron lifecycle, IPC, SQLite persistence, auth, logging, OpenClaw startup, runtime repair, skill sync, IM gateways, and artifact services.
- OpenClaw integration:
openclawEngineManager,openclawConfigSync,openclawRuntimeAdapter, andcoworkEngineRoutertranslate LobsterAI state into OpenClaw runtime behavior.
Install
Desktop
Download the latest macOS and Windows installers from Official Website or GitHub Releases.
Run From Source
Requirements:
- Node.js
>=24.15.0 <25 - npm
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.
Developing
# Production renderer bundle
npm run build
# Electron main/preload TypeScript build
npm run compile:electron
# Official Vitest entry used by CI
npm test
# Full ESLint across src; may expose existing legacy debt
npm run lint
# CI-style lint for touched TypeScript files
npx eslint --ext ts,tsx --report-unused-disable-directives --max-warnings 0 <files>
OpenClaw Runtime
The pinned OpenClaw version and third-party plugin list live in package.json under openclaw.
# Build the current-platform runtime manually
npm run openclaw:runtime:host
# Use a custom OpenClaw source checkout
OPENCLAW_SRC=/path/to/openclaw npm run electron:dev:openclaw
# Force runtime rebuild
OPENCLAW_FORCE_BUILD=1 npm run electron:dev:openclaw
# Keep a local OpenClaw checkout on its current branch/tag
OPENCLAW_SKIP_ENSURE=1 npm run electron:dev:openclaw
Packaging
# macOS
npm run dist:mac
npm run dist:mac:x64
npm run dist:mac:arm64
npm run dist:mac:universal
# Windows
npm run dist:win
# Linux
npm run dist:linux
Packaging bundles the OpenClaw runtime under Resources/cfmind. Windows builds also bundle a portable Python runtime under resources/python-win, so end users do not need to install Python manually.
Offline or private-source packaging can use:
LOBSTERAI_PORTABLE_PYTHON_ARCHIVELOBSTERAI_PORTABLE_PYTHON_URLLOBSTERAI_WINDOWS_EMBED_PYTHON_VERSIONLOBSTERAI_WINDOWS_EMBED_PYTHON_URLLOBSTERAI_WINDOWS_GET_PIP_URL
Project Map
| Path | Purpose |
|---|---|
src/main/main.ts | Electron lifecycle, IPC registration, auth, logging, runtime startup, and service wiring |
src/main/libs/openclawEngineManager.ts | OpenClaw gateway process, runtime state, ports, logs, restart, and repair |
src/main/libs/openclawConfigSync.ts | Renders LobsterAI providers, models, agents, IM bindings, skills, MCP, and workspace instructions into OpenClaw config |
src/main/libs/agentEngine/openclawRuntimeAdapter.ts | Translates OpenClaw gateway events into Cowork stream events |
src/main/coworkStore.ts | Cowork sessions, messages, config, agents, memory metadata, and SQLite CRUD |
src/renderer/components/cowork/ | Main Cowork UI, prompt input, session detail, permissions, thinking/tool display, media, and voice input |
src/renderer/components/agent/ | Agent creation and settings UI |
src/renderer/components/skills/ | Skill management UI |
src/renderer/components/mcp/ | MCP server management UI |
src/renderer/components/scheduledTasks/ | Scheduled task list, form, detail, run history, and templates |
src/renderer/services/i18n.ts | Renderer i18n dictionary and t() helper |
SKILLs/ | Bundled LobsterAI skills |
Security And Data
- Renderer windows use context isolation, disabled Node integration, and sandboxing.
- Renderer-to-main access goes through preload IPC APIs.
- Sensitive tool actions are permission-gated and logged.
- App data is stored locally in
lobsterai.sqliteunder ElectronuserData. - OpenClaw state, workspace memory, generated config, and gateway logs live under
userData/openclaw.
Community & Support
Join the WeChat group for help, feedback, and release updates:
Please use the repository issue templates for bugs and feature requests. For pull requests, include a short summary, linked issue when relevant, screenshots for UI changes, and notes for Electron-specific behavior such as IPC, storage, runtime, or windowing changes.
Star History
License
Built and maintained by NetEase Youdao.
File tree
1666netease-youdao/lobsteraiView on GitHub
.codexignore
.editorconfig
.env.example
.eslintrc.cjs
.git-blame-ignore-revs
.gitattributes
.github/
dependabot.yml
ISSUE_TEMPLATE/
bug_report.yml
feature_request.yml
labeler.yml
PULL_REQUEST_TEMPLATE.md
workflows/
build-platforms.yml
ci.yml
electron-verify.yml
labeler.yml
openclaw-check.yml
security.yml
stale.yml
welcome.yml
.gitignore
.husky/
commit-msg
pre-commit
.npmignore
.npmrc
.nvmrc
.prettierignore
.prettierrc
AGENTS.md
build/
entitlements.mac.plist
icons/
mac/
icon.icns
png/
1024x1024.png
128x128.png
16x16.png
24x24.png
256x256.png
32x32.png
48x48.png
512x512.png
64x64.png
win/
icon.ico
CLAUDE.md
commitlint.config.mjs
docs/
architecture-openclaw-gui-cowork.md
res/
architecture_v1_en.png
architecture_v1_zh.png
architecture_v2_en.png
architecture_v2_zh.png
mainpage_en.png
mainpage_zh.png
star-history-202677.png
server-integration/
2026-05-26-doubao-seedance-fast-video.md
2026-05-26-happyhorse-video-models.md
2026-05-26-kling-v3-video-generation.md
2026-05-29-html-share-moderation.md
2026-06-01-html-share-code-only.md
2026-06-01-html-share-status-api.md
2026-06-02-html-share-put-status-separation.md
2026-06-04-banana-pro-internal-image-model.md
2026-06-04-canvas20-banana2-internal-image-models.md
2026-06-10-artifact-image-svg-share.md
2026-06-16-html-share-active-limit-restore.md
2026-06-17-markdown-mermaid-share.md
2026-06-23-happyhorse-1-1-video.md
2026-06-24-explicit-context-cache-models.md
2026-06-24-service-deployment-host.md
2026-06-26-static-service-deployment.md
2026-06-30-credits-reset-campaign.md
2026-07-01-client-sidebar-banner.md
2026-07-03-client-sidebar-banner-carousel.md
2026-07-03-share-deployment-vefaas-tos-upload.md
2026-07-08-share-deployment-persistence.md
2026-07-09-doubao-seedream-5-pro.md
2026-07-09-share-deployment-persistence-management.md
2026-07-15-credits-final-reward-campaign.md
2026-07-16-share-deployment-persistence-binding-validation.md
2026-07-16-share-deployment-persistence-recovery.md
2026-07-22-sites-management-analytics-api.md
electron-builder.json
electron-tsconfig.json
eslint.config.mjs
index.html
LICENSE
openclaw-extensions/
ask-user-question/
index.ts
openclaw.plugin.json
package.json
sessionKey.ts
lobster-media-generation/
index.ts
openclaw.plugin.json
package.json
sessionKey.ts
statusPolling.ts
lobsterai-model-compat/
index.ts
openclaw.plugin.json
package.json
profileMapping.ts
mcp-bridge/
index.ts
openclaw.plugin.json
package.json
package.json
patches/
app-builder-lib+24.13.3.patch
postcss.config.js
public/
dingding.png
discord.svg
email.svg
feishu.png
hand.png
logo.png
love.png
netease-bee.png
nim.png
popo.png
qq_bot.jpeg
quick-actions-i18n.json
quick-actions.json
telegram.svg
wecom.png
weixin.png
README_zh.md
README.md
resources/
error.html
node-runtime/
darwin/
.keep
linux/
.keep
README.md
win32/
.keep
openclaw-bootstrap/
manifest.json
SYSTEM_PROMPT.md
tray/
tray-icon-mac.png
tray-icon-mac@2x.png
tray-icon.ico
tray-icon.png
scripts/
apply-openclaw-patches.cjs
build-env.cjs
build-keyfrom.cjs
build-openclaw-runtime.sh
build-skill-tech-news.js
bundle-openclaw-gateway.cjs
dev.js
dist-win-channel.cjs
dist-win-web.cjs
electron-builder-config.cjs
electron-builder-hooks.cjs
ensure-openclaw-plugins.cjs
ensure-openclaw-version.cjs
finalize-openclaw-runtime.cjs
fix-mac-icon-display.sh
generate-app-icon.js
generate-keyfrom-build-info.cjs
generate-tray-icons.js
install-openclaw-channel-deps.cjs
notarize.js
nsis-installer.nsh
openclaw-plugin-patches/
common.cjs
dingtalk.cjs
index.cjs
lark.cjs
weixin.cjs
openclaw-plugin-preparers/
netease-bee.cjs
nim-channel.cjs
typescript-plugin.cjs
openclaw-runtime-host.cjs
openclaw-runtime-packaging.cjs
openclaw-worker-shims.cjs
pack-openclaw-tar.cjs
patches/
openclaw-llm-request-debug-log.patch
v2026.3.2/
openclaw-cron-current-time-suffix.patch
openclaw-cron-delivery-inference.patch
openclaw-cron-isolated-session-key.patch
openclaw-cron-owner-fallback.patch
openclaw-cron-reminder-prompt.patch
openclaw-cron-skip-missed-cron-jobs.patch
openclaw-cron-tool-owner-only.patch
openclaw-gateway-entry.patch
openclaw-wecom-exec-deny.patch
v2026.4.14/
openclaw-aborted-tool-loop-breaker.patch
openclaw-browser-blocked-hostnames.patch
openclaw-browser-duplicate-launch.patch
openclaw-chat-send-cwd-decoupling.patch
openclaw-chat-send-image-attachment-30mb.patch
openclaw-codex-use-native-transport.patch
openclaw-cron-skip-missed-jobs.patch
openclaw-deepseek-mimo-reasoning-replay.patch
openclaw-deepseek-v4-thinking-mode.patch
openclaw-disable-model-pricing-bootstrap.patch
openclaw-empty-sse-data.patch
openclaw-extra-body-passthrough.patch
openclaw-facade-runtime-static-import.patch
openclaw-gateway-startup-profiler.patch
openclaw-im-bound-agent-run-cwd.patch
openclaw-jiti-alias-prenormalize.patch
openclaw-mcp-shared-runtime.patch
openclaw-mcp-stdio-process-tree-kill.patch
openclaw-memory-atomic-reindex-ebusy-retry.patch
openclaw-qwen-coding-plan-qwen36-plus.patch
openclaw-qwen-vision-catalog-fallback.patch
openclaw-skip-derive-prompt-segments-deadloop.patch
openclaw-subagent-cleanup-finalize-best-effort.patch
openclaw-web-fetch-env-proxy.patch
openclaw-widen-incomplete-turn-retry-guard.patch
zz-openclaw-first-response-timing-logs.patch
v2026.4.5/
openclaw-disable-model-pricing-bootstrap.patch
v2026.4.8/
openclaw-allow-loopback-scope-upgrade-silent-pairing.patch
openclaw-build-all-win32-shell.patch
openclaw-cron-skip-missed-jobs.patch
openclaw-disable-model-pricing-bootstrap.patch
openclaw-facade-runtime-static-import.patch
openclaw-gateway-entry.patch
openclaw-skip-legacy-config-checks-on-startup.patch
openclaw-skip-provider-hook-plugins-preactivation.patch
openclaw-ui-js-win32-space-in-path.patch
v2026.6.1/
openclaw-aborted-tool-loop-breaker.patch
openclaw-browser-blocked-hostnames.patch
openclaw-chat-send-cwd-decoupling.patch
openclaw-codex-missing-content-type-sse.patch
openclaw-cron-skip-missed-jobs.patch
openclaw-current-model-session-status-prompt.patch
openclaw-dashscope-context-cache.patch
openclaw-empty-sse-data.patch
openclaw-im-bound-agent-run-cwd.patch
openclaw-kimi-k3-support.patch
openclaw-live-tool-result-cache-stability.patch
openclaw-lobsterai-model-compat-api.patch
openclaw-mcp-shared-runtime.patch
openclaw-openai-compatible-replay-errors.patch
openclaw-provider-fetch-transient-retry.patch
openclaw-repeated-tool-call-id.patch
openclaw-run-failure-detail.patch
openclaw-safe-error-metadata.patch
openclaw-session-goal-rpc.patch
openclaw-sessions-queue-steer-rpc.patch
openclaw-shell-snapshot-electron-node-env.patch
openclaw-skip-derive-prompt-segments-deadloop.patch
openclaw-stop-loop-after-aborted-tool-run.patch
openclaw-subagent-cleanup-finalize-best-effort.patch
openclaw-terminate-run-on-critical-tool-loop.patch
openclaw-user-turn-cache-stability.patch
zz-openclaw-task-cwd-system-prompt.patch
precompile-openclaw-extensions.cjs
prune-openclaw-runtime.cjs
regenerate-mac-icon.sh
run-build-openclaw-runtime.cjs
setup-mingit.js
setup-python-runtime.js
setup-windows-env.bat
setup-wsl.ps1
sync-local-openclaw-extensions.cjs
sync-openclaw-runtime-current.cjs
test-inject-messages.js
unpack-cfmind.cjs
warmup-compile-cache.cjs
win-sign.cjs
wsl-build-image.sh
SKILLs/
article-writer/
SKILL.md
canvas-design/
canvas-fonts/
ArsenalSC-OFL.txt
ArsenalSC-Regular.ttf
BigShoulders-Bold.ttf
BigShoulders-OFL.txt
BigShoulders-Regular.ttf
Boldonse-OFL.txt
Boldonse-Regular.ttf
BricolageGrotesque-Bold.ttf
BricolageGrotesque-OFL.txt
BricolageGrotesque-Regular.ttf
CrimsonPro-Bold.ttf
CrimsonPro-Italic.ttf
CrimsonPro-OFL.txt
CrimsonPro-Regular.ttf
DMMono-OFL.txt
DMMono-Regular.ttf
EricaOne-OFL.txt
EricaOne-Regular.ttf
GeistMono-Bold.ttf
GeistMono-OFL.txt
GeistMono-Regular.ttf
Gloock-OFL.txt
Gloock-Regular.ttf
IBMPlexMono-Bold.ttf
IBMPlexMono-OFL.txt
IBMPlexMono-Regular.ttf
IBMPlexSerif-Bold.ttf
IBMPlexSerif-BoldItalic.ttf
IBMPlexSerif-Italic.ttf
IBMPlexSerif-Regular.ttf
InstrumentSans-Bold.ttf
InstrumentSans-BoldItalic.ttf
InstrumentSans-Italic.ttf
InstrumentSans-OFL.txt
InstrumentSans-Regular.ttf
InstrumentSerif-Italic.ttf
InstrumentSerif-Regular.ttf
Italiana-OFL.txt
Italiana-Regular.ttf
JetBrainsMono-Bold.ttf
JetBrainsMono-OFL.txt
JetBrainsMono-Regular.ttf
Jura-Light.ttf
Jura-Medium.ttf
Jura-OFL.txt
LibreBaskerville-OFL.txt
LibreBaskerville-Regular.ttf
Lora-Bold.ttf
Lora-BoldItalic.ttf
Lora-Italic.ttf
Lora-OFL.txt
Lora-Regular.ttf
NationalPark-Bold.ttf
NationalPark-OFL.txt
NationalPark-Regular.ttf
NothingYouCouldDo-OFL.txt
NothingYouCouldDo-Regular.ttf
Outfit-Bold.ttf
Outfit-OFL.txt
Outfit-Regular.ttf
PixelifySans-Medium.ttf
PixelifySans-OFL.txt
PoiretOne-OFL.txt
PoiretOne-Regular.ttf
RedHatMono-Bold.ttf
RedHatMono-OFL.txt
RedHatMono-Regular.ttf
Silkscreen-OFL.txt
Silkscreen-Regular.ttf
SmoochSans-Medium.ttf
SmoochSans-OFL.txt
Tektur-Medium.ttf
Tektur-OFL.txt
Tektur-Regular.ttf
WorkSans-Bold.ttf
WorkSans-BoldItalic.ttf
WorkSans-Italic.ttf
WorkSans-OFL.txt
WorkSans-Regular.ttf
YoungSerif-OFL.txt
YoungSerif-Regular.ttf
LICENSE.txt
SKILL.md
content-planner/
scripts/
wechat_search.js
SKILL.md
create-plan/
LICENSE.txt
SKILL.md
daily-trending/
SKILL.md
develop-web-game/
agents/
openai.yaml
assets/
game-small.svg
game.png
LICENSE.txt
references/
action_payloads.json
scripts/
web_game_playwright_client.js
SKILL.md
docx/
docx-js.md
LICENSE.txt
ooxml/
ooxml.md
... 1600 moreShowing a partial view of a very large repo.
FAQ
lobsterai is a Claude Code plugin with hand-picked skills for productivity work, indexed on Flowy. Install it with the command on its page. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is 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.
- How do I install lobsterai?
- Run these in Claude Code: . Then prompt normally.
- Does lobsterai auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is lobsterai free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.