龙虾AI

Prerequisites

• Node.js >= 24 < 25
• npm

Install dependencies

npm install

Install & Develop

```bash

First run: automatically clones and builds OpenClaw (may take several minutes)

npm run electron:dev:openclaw

Subsequent runs: skips build if the pinned version hasn't changed

npm run electron:dev:openclaw

By default, OpenClaw source is cloned/managed at `../openclaw` (relative to this repo). Override with:

To force a rebuild even when the version hasn't changed:

To skip the automatic version checkout (e.g., when developing OpenClaw locally):

Production Build

```bash

Windows (.exe NSIS installer)

npm run dist:win

Build runtime for current host platform (auto-detect mac/win/linux + arch)

npm run openclaw:runtime:host

Build explicit targets

npm run openclaw:runtime:mac-arm64 npm run openclaw:runtime:win-x64 npm run openclaw:runtime:linux-x64

Override OpenClaw source path with an environment variable when needed:

Windows builds bundle a portable Python runtime under resources/python-win (included as installer resource python-win), so end users do not need to install Python manually. The bundled runtime is interpreter-focused and does not preinstall LobsterAI skill Python packages; those can be installed at runtime on demand. By default, packaging downloads the official Python embeddable runtime from python.org if no prebuilt archive is provided. For offline/non-network builds, provide a prebuilt runtime archive explicitly.

Offline/runtime source options for packaging: - LOBSTERAI_PORTABLE_PYTHON_ARCHIVE: Local prebuilt runtime archive path (recommended for offline CI/CD) - LOBSTERAI_PORTABLE_PYTHON_URL: Download URL for the prebuilt runtime archive - LOBSTERAI_WINDOWS_EMBED_PYTHON_VERSION / LOBSTERAI_WINDOWS_EMBED_PYTHON_URL / LOBSTERAI_WINDOWS_GET_PIP_URL: Optional overrides for Windows-host bootstrap sources

Quick Start

Development Guidelines

• TypeScript strict mode, functional components + Hooks
• 2-space indentation, single quotes, semicolons
• Components: PascalCase; functions/variables: camelCase; Redux slices: *Slice.ts
• Tailwind CSS preferred; avoid custom CSS
• Commit messages follow type: short imperative summary (e.g., feat: add artifact toolbar)

Configuration

App Configuration

App-level config is stored in the SQLite kv table, editable through the Settings panel.

Cowork Configuration

Cowork session config includes:

• Working Directory — Root directory for Agent operations
• System Prompt — Customize Agent behavior
• Execution Mode — auto / local

Environment Variables

IM Integration — Mobile Remote Control

LobsterAI can bridge the Agent to multiple IM platforms. Send a message from your phone via IM to remotely trigger the desktop Agent — command your personal assistant anytime, anywhere.

Configure the corresponding platform Token/Secret in the Settings panel to enable. Once set up, you can send instructions directly to the Agent from your phone IM (e.g., "analyze this dataset", "make a weekly summary PPT"), and the Agent will execute on the desktop and return results.

run tests for a specific module (Vitest filename filter)

npm test -- logger npm test -- cowork

New test files go next to the source file they test, using the `.test.ts` extension:

Example (`src/main/logger.test.ts`):

test('log file pattern matches daily name', () => { expect(/^main-\d{4}-\d{2}-\d{2}\.log$/.test('main-2026-03-20.log')).toBe(true); }); ```

Avoid importing Electron-only APIs (e.g. electron-log) in tests — inline any logic that depends on them instead.