Skip to content

mornikar/OpenClaw_Launcher_LobsterLauncher

Repository files navigation

🦞 LobsterLauncher · 龙虾启动器

专为 OpenClaw 用户打造的桌面管理工具
A powerful desktop launcher for OpenClaw users

功能预览安装使用技术


✨ 功能特点

模块 说明
🏠 仪表盘 自动检测 OpenClaw 路径、一键复制凭证、快捷访问文件
🚀 一键安装 使用官方 install.ps1 脚本自动安装 OpenClaw,无需手动配置
服务管理 一键启停 Gateway / 本地服务,支持批量操作
📁 文件夹管理 自定义文件夹快捷入口,右键删除
常用链接 快速访问 Dashboard、安装向导、文档等
💳 CodingPlan 配置和管理 CodingPlan API

🖼️ 界面预览

1. 仪表盘 — 首页

智能检测 OpenClaw 安装路径,集中展示 Gateway URL、Token 和密码,一键复制。底部可添加常用文件夹快捷入口。

仪表盘首页

2. 服务管理

管理所有 AI 相关服务——OpenClaw Gateway、LM Studio、Ollama 等。支持单个启停和批量操作。

操作方式:点击「添加服务」→ 浏览选择 .exe.bat 文件即可注册。

服务管理

3. 使用统计

实时追踪 API 调用量与 Token 消耗,同时监控本机 CPU、内存、GPU 占用情况。

使用统计

4. 本地模型管理

点击「添加模型文件夹」后,系统自动扫描识别本地模型文件(GGUF 等),统一纳入管理面板。

模型管理

5. Skills 管理

解决痛点: OpenClaw 等 Agent 启动时会全量扫描所有 Skills,导致 Token 开销过大。

通过黑名单机制屏蔽不常用的 Skills,显著降低每次对话的系统提示长度:

导入 Skills 目录 → 选择需屏蔽的 Skill 加入黑名单 → 选择模型来源(本地/远程)→ 保存默认配置

Skills管理

6. 小工具

将常用脚本或工具注册为快捷按钮,支持选择是否在新终端窗口中运行。

小工具

7. 终端

内置终端模拟器,可直接执行命令行操作。也可点击「打开外部终端」调用系统终端。

终端

8. 设置

全局配置中心,包含应用偏好、路径配置等选项。

设置

🚀 快速上手

下载安装

方式一:从 GitHub Releases 下载(推荐)

下载最新的 LobsterLauncher.exe 便携版,双击即可运行(无需安装)。

下载地址: GitHub Releases

方式二:从源码构建

# 克隆仓库
git clone https://github.com/mornikar/OpenClaw_Launcher_LobsterLauncher.git
cd OpenClaw_Launcher_LobsterLauncher

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 生产构建(生成可执行文件)
npm run build:unpack

前置要求: Node.js ≥ 18 · npm ≥ 9 · Git


📖 使用指南

首次启动

  1. 运行 LobsterLauncher.exe
  2. 应用自动检测 OpenClaw 安装路径
  3. 在首页确认 Gateway URL 和 Token 显示正常

一键安装 OpenClaw

如果本地未安装 OpenClaw,点击首页的 "安装向导" 链接:

  1. 点击 "安装向导" 链接
  2. 弹出确认对话框,点击 "确定"
  3. 应用自动执行以下步骤:
    • 下载官方安装脚本 (install.ps1)
    • 安装 Node.js(如需要)
    • 安装 OpenClaw CLI
    • 启动 Gateway
  4. 安装完成后自动打开安装向导

⚠️ 安装过程可能需要几分钟,请耐心等待。

服务管理

  1. 进入首页 "服务管理" 区域
  2. 默认服务:管理 OpenClaw Gateway 等系统服务
  3. 添加服务:点击 "➕ 添加服务" 卡片,填写服务名称和启动文件路径
  4. 本地服务:从 IPC 加载的本地服务列表,独立管理
  5. 单个服务右键操作,或使用底部 全部启动 / 全部停止 按钮

注意: "全部启动/停止" 只操作默认服务,不影响本地服务。

文件夹管理

  1. 首页 "文件夹" 区域显示内置文件夹(OpenClaw 文件、配置目录、Skills 目录等)
  2. 点击 "➕ 添加文件夹" 卡片添加自定义文件夹
  3. 右键文件夹可打开、绑定新路径或删除

常用链接

  1. 首页 "常用" 区域显示快捷链接(Dashboard、安装向导、官方文档等)
  2. 点击 "➕ 添加链接" 卡片添加自定义链接
  3. 右键链接可打开或删除

📦 发布构建

构建可执行文件

# 安装依赖
npm install

# 构建便携版 .exe(位于 dist/win-unpacked/)
npm run build:release

# 或构建安装包(NSIS)
npm run build:win

发布到 GitHub Releases

由于 LobsterLauncher.exe 约 180MB,超过 GitHub 仓库单文件 100MB 限制,需要通过 GitHub Releases 分发。

方式一:使用自动化脚本

# 1. 安装 GitHub CLI
# 从 https://cli.github.com/ 下载并安装

# 2. 登录 GitHub
gh auth login

# 3. 一键构建并发布
npm run release

方式二:手动发布

  1. 构建应用

    npm run build:release
  2. 上传到 GitHub Releases

  3. 用户下载

注意: GitHub Releases 支持最大 2GB 的文件,适合分发大型可执行文件。


🛠️ 技术栈

层级 技术
框架 Electron
前端 Vue 3 + Vite
UI 风格 科技感暗色主题 + Glassmorphism
终端 node-pty + xterm.js
系统监控 systeminformation
数据存储 electron-store
打包 electron-builder

📁 项目结构

LobsterLauncher/
├── src/
│   ├── main/                 # Electron 主进程
│   ├── preload/              # IPC 桥接脚本
│   └── renderer/             # Vue 3 前端
│       ├── components/       # 组件
│       ├── pages/            # 页面
│       └── assets/           # 样式与资源
├── .github/images/           # 文档配图
├── data/                     # 运行时数据
├── SPEC.md                   # 功能规格说明
└── CHANGELOG.md              # 版本历史

📊 数据存储

Windows: %APPDATA%/LobsterLauncher/
├── config.json          # 应用配置
├── services.json        # 服务列表
├── skills-config.json   # Skills 配置
└── models-config.json   # 模型配置

OpenClaw 路径自动检测顺序

  1. %OPENCLAW_HOME% 环境变量
  2. %USERPROFILE%\.openclaw
  3. %APPDATA%\openclaw
  4. %LOCALAPPDATA%\openclaw
  5. C:\Program Files\OpenClaw
  6. D:\Program Files\OpenClaw

🤝 参与贡献

Issue 和 PR 均欢迎!

# Fork → 创建分支 → 提交 → 推送 → 创建 PR
git checkout -b feature/amazing-feature
git commit -m 'Add some amazing feature'
git push origin feature/amazing-feature

📄 许可证

MIT


🙏 致谢


Made with ❤️ for OpenClaw users
为 OpenClaw 用户用心打造

About

基于OpenClaw的一键启动版本,可以通过添加本地文件路径,如Ollama,LM studio,做到本地化小模型一键启动。Based on the one-click startup version of OpenClaw, by adding local file paths such as Ollama, LM studio, it is possible to achieve one-click startup of small local models.

Resources

License

Stars

4 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors