OTOClaw - 智能龙虾，一键部署OpenClaw龙虾、轻松养龙虾

🦞 OTOClaw - 智能龙虾，一键部署

OpenClaw 一键整合包 | OTOClaw = One-Touch OpenClaw
「点击一下，AI 全家桶即刻就位」

🌐 官方网站 ：www.otoclaw.com ------ 一站式下载 | 详细文档 | 社区交流

📌 目录

项目名称由来
项目背景
界面预览
功能特性
常见问题（macOS）
快速开始
项目结构
技术栈
构建产物
设计理念
开发命令
配置说明
贡献指南
许可证
相关链接

🦞 项目名称由来

OTOClaw = O ne-T ouch O penClaw
寓意：一次点击，智能部署，开箱即用
中文昵称：一键龙虾（简单、高效、有力量）

📖 项目背景

本工具基于 GitHub 热门开源项目 OpenClaw Manager （⭐ 1.2k）进行二次开发，将原有 React 技术栈全面重构为 Vue 3 + TypeScript ，并引入 Tauri 2.0 作为跨平台底层框架。

初衷是探索 Vue 3 Composition API + Pinia + Tauri 的现代应用架构，同时保持原项目的完整功能，打造一款更轻量、更易用的 AI 助手管理工具。

📸 界面预览

📊 仪表盘 ------ 实时监控，一键操控

实时查看所有服务状态，轻点鼠标即可控制 AI 服务的启停。

https://pic/dashboard.png

状态监控：端口、进程 ID、内存占用、运行时长
快捷操作：一键启动 / 停止 / 重启 / 诊断
日志实时查看：支持自动刷新，排查问题更高效

🤖 AI 模型配置 ------ 多模型随心切换

集成主流 AI 服务商，支持自定义 API 地址，轻松切换主模型。

https://pic/ai.png

支持 14+ 家 AI 提供商：Anthropic、OpenAI、DeepSeek、Moonshot、Gemini、智谱、文心一言等
自定义 API 端点：兼容 OpenAI 格式的第三方服务
一键主模型切换：快速配置常用模型，省时省力

📱 消息渠道配置 ------ 全平台 AI 助手

将 AI 接入各大聊天平台，打造全渠道智能助手。

<table> <tr> <td width="50%"> <img src="pic/telegram.png" alt="Telegram 配置"> <p align="center"><b>Telegram 机器人</b></p> </td> <td width="50%"> <img src="pic/feishu.png" alt="飞书配置"> <p align="center"><b>飞书应用</b></p> </td> </tr> </table>

Telegram：Bot Token 配置、私聊/群组策略、权限管理
飞书：App ID/Secret、WebSocket 连接、多区域部署
更多渠道：Discord、Slack、WhatsApp、iMessage、微信、钉钉、企业微信

✨ 功能特性

模块	核心功能
📊 仪表盘	服务状态监控、内存统计、一键启停 / 重启 / 诊断、实时日志查看
🤖 AI 配置	支持 14+ AI 服务商、自定义 API 地址、主模型切换、模型列表自动获取
📱 消息渠道	Telegram、Discord、Slack、飞书、微信、iMessage、钉钉、WhatsApp 全接入
⚡ 服务管理	后台服务守护、开机自启、日志持久化、进程守护
🧪 测试诊断	系统环境检测、AI 连接测试、渠道连通性验证、一键修复提示
🛠️ 设置中心	主题切换（深色/浅色）、语言选择（中/英）、代理配置、数据备份与还原

🍎 macOS 常见问题

"已损坏，无法打开" 错误

由于 macOS Gatekeeper 安全机制，未签名的应用可能会被阻止运行。解决方法如下：

方法一：移除隔离属性（推荐）

bash 复制代码

# 对已安装的 .app 文件执行
xattr -cr /Applications/OTOClaw.app

# 若安装前为 .dmg 文件，也可对其执行
xattr -cr ~/Downloads/OTOClaw.dmg

方法二：通过系统设置允许

打开 系统设置 > 隐私与安全性
在「安全性」部分找到被阻止的应用，点击 仍要打开

方法三：临时禁用 Gatekeeper（不推荐）

bash 复制代码

# 禁用（需管理员密码）
sudo spctl --master-disable

# 安装完成后重新启用
sudo spctl --master-enable

权限问题

若应用无法正常访问文件或执行操作：

授予完全磁盘访问权限

打开 系统设置 > 隐私与安全性 > 完全磁盘访问权限
解锁后，点击 + 添加 OTOClaw.app

重置权限数据库

bash 复制代码

# 重置辅助功能权限
sudo tccutil reset Accessibility

# 重置完全磁盘访问权限
sudo tccutil reset SystemPolicyAllFiles

🚀 快速开始

环境要求

Node.js ≥ 22.0
Rust ≥ 1.70
pnpm（推荐）或 npm / yarn

各平台额外依赖

macOS

bash 复制代码

xcode-select --install

Windows

Linux（Ubuntu/Debian 为例）

bash 复制代码

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

安装与运行

bash 复制代码

# 克隆项目
git clone https://github.com/your-username/otoclaw.git
cd otoclaw

# 安装依赖
pnpm install

# 开发模式运行（热重载）
pnpm tauri:dev

# 构建发布版本
pnpm tauri:build

bash 复制代码

otoclaw/
├── src-tauri/                     # Rust 后端
│   ├── src/
│   │   ├── main.rs                # 程序入口
│   │   ├── commands/               # Tauri 命令
│   │   │   ├── service.rs          # 服务管理
│   │   │   ├── config.rs           # 配置读写
│   │   │   ├── process.rs          # 进程控制
│   │   │   └── diagnostics.rs      # 诊断工具
│   │   ├── models/                 # 数据模型
│   │   ├── utils/                  # 工具函数
│   │   └── error.rs                 # 错误处理
│   ├── Cargo.toml
│   └── tauri.conf.json
│
├── src/                            # Vue 3 前端
│   ├── App.vue                     # 根组件
│   ├── main.ts                     # 入口文件
│   ├── components/
│   │   ├── Layout/                  # 布局组件（侧边栏、顶部栏）
│   │   ├── Dashboard/                # 仪表盘页面
│   │   ├── AIConfig/                 # AI 配置页面
│   │   ├── Channels/                 # 渠道配置页面
│   │   ├── Testing/                  # 测试诊断页面
│   │   ├── Logs/                     # 日志查看页面
│   │   ├── Settings/                 # 设置页面
│   │   └── Setup/                    # 首次安装向导
│   ├── composables/                 # 组合式逻辑
│   │   ├── useService.ts             # 服务管理逻辑
│   │   ├── useConfig.ts              # 配置管理逻辑
│   │   └── useTheme.ts               # 主题切换
│   ├── stores/                      # Pinia 状态管理
│   │   ├── appStore.ts               # 全局状态
│   │   ├── serviceStore.ts           # 服务状态
│   │   └── configStore.ts            # 配置状态
│   ├── lib/                         # 工具库
│   │   ├── tauri.ts                  # Tauri API 封装
│   │   ├── logger.ts                 # 前端日志
│   │   └── constants.ts              # 常量定义
│   └── styles/
│       └── globals.css               # 全局样式（Tailwind）
│
├── package.json
├── vite.config.ts
├── tailwind.config.js
└── README.md

🛠️ 技术栈

层级	技术	说明
前端框架	Vue 3.5	Composition API + `<script setup>`
状态管理	Pinia	官方推荐，轻量且类型安全
路由	Vue Router 4	动态路由 + 路由守卫
样式	TailwindCSS + 深色模式	原子化 CSS，支持深色主题
动画	@vueuse/motion	流畅的交互动画
图标	Lucide Vue Next	一致且美观的图标集
HTTP 请求	axios + @tanstack/vue-query	数据请求与缓存管理
后端核心	Rust	高性能系统调用与进程管理
跨平台框架	Tauri 2.0	轻量、安全、原生性能

📦 构建产物

执行 pnpm tauri:build 后，产物位于 src-tauri/target/release/bundle/：

平台	格式
macOS	`.dmg`（安装包）、`.app`（可直接运行）
Windows	`.msi`、`.exe`（便携版可选）
Linux	`.deb`、`.AppImage`

🎨 设计理念

沉浸式深色主题：默认深色模式，护眼且适合长时间使用
毛玻璃与动效：现代感 UI，毛玻璃背景 + 细腻过渡动画
响应式布局：完美适配笔记本到 4K 显示器
极速启动：得益于 Tauri，内存占用比 Electron 版本减少 60%

🔧 开发命令

bash 复制代码

# 开发模式（前端热重载 + Tauri 实时更新）
pnpm tauri:dev

# 仅运行前端（便于调试 UI）
pnpm dev

# 构建前端静态文件
pnpm build

# 构建完整应用
pnpm tauri:build

# Rust 代码检查
cd src-tauri && cargo check

# Rust 单元测试
cd src-tauri && cargo test

# 前端代码格式化
pnpm format

# 前端代码检查
pnpm lint

📝 配置说明

Tauri 主配置（tauri.conf.json）

app.windows：窗口尺寸、标题、透明效果
bundle：打包标识符、图标、版权信息
plugins.shell.scope：允许执行的 Shell 命令白名单
plugins.fs.scope：允许读写访问的文件路径

环境变量

应用启动时会自动加载 ~/.openclaw/.env 文件，支持自定义环境变量。

🤝 贡献指南

Fork 本项目
创建功能分支：git checkout -b feature/awesome-feature
提交更改：git commit -m 'feat: add awesome feature'（遵循 Conventional Commits）
推送分支：git push origin feature/awesome-feature
提交 Pull Request，并详细描述改动内容

欢迎提交 Issue 或 Discussion，一起让 OTOClaw 更好用！

📄 许可证

本项目采用 MIT License ，详情请见 LICENSE 文件。

🔗 相关链接

官方网站 ：otoclaw.com ------ 下载、文档、社区
原项目 ：OpenClaw Manager ⭐ 1.2k（React 版）
命令行版本 ：OpenClawInstaller
Tauri 官方文档 ：tauri.app
Vue 3 官方文档 ：vuejs.org
TailwindCSS ：tailwindcss.com

Made with 🧡 by OTOClaw Team
让 AI 部署，像吃龙虾一样简单。