Skip to content

miaoxworld/openclaw-manager

Repository files navigation

🦞 虾池子 (OpenClaw Manager)

高性能跨平台 AI 助手管理工具,基于 Tauri 2.0 + React + TypeScript + Rust 构建。

English

Platform Tauri React Rust License


📸 界面预览

📊 仪表盘概览

实时监控服务状态,一键管理 AI 助手服务。

仪表盘

  • 服务状态实时监控(端口、进程 ID、内存、运行时间)
  • 快捷操作:启动 / 停止 / 重启 / 诊断
  • 实时日志查看,支持自动刷新

🤖 AI 模型配置

灵活配置多个 AI 提供商,支持自定义 API 地址。

AI 配置

  • 支持 14+ AI 提供商(Anthropic、OpenAI、DeepSeek、Moonshot、Gemini 等)
  • 自定义 API 端点,兼容 OpenAI 格式的第三方服务
  • 一键设置主模型,快速切换

📱 消息渠道配置

连接多种即时通讯平台,打造全渠道 AI 助手。

Telegram 配置

Telegram Bot

飞书配置

飞书机器人

  • Telegram — Bot Token 配置、私聊/群组策略
  • 飞书 — App ID/Secret、WebSocket 连接、多部署区域
  • 更多渠道 — Discord、Slack、WhatsApp、iMessage、微信、钉钉、QQ
  • 配置说明 — 每个渠道提供官方文档链接,一键跳转配置指南

🤝 Agent 管理

多智能体管理,为不同角色分配独立身份、模型与渠道。

Agent 管理

  • 创建和管理多个虚拟员工(Agent),支持自定义名称、Emoji 标识和角色描述
  • 每个 Agent 可独立配置 AI 模型、绑定消息渠道、设置工具权限
  • 支持沙箱模式、工作空间隔离、@提及模式和子代理权限控制
  • 一键设置主 Agent,处理未绑定渠道的消息

🧩 技能库

统一管理内置、官方、社区与自定义技能插件。

技能库

  • 浏览并搜索所有技能,按来源分类筛选(内置 / 官方 / 社区)
  • 一键安装、卸载、启用、禁用技能
  • 可视化配置每个技能的参数(文本、密码、下拉选择、开关)
  • 支持通过 npm 包或本地路径自定义安装第三方技能

🛡️ 安全防护

全面的安全风险检测与一键修复功能。

  • 安全警告提醒 — 醒目的风险提示,提醒 AI 过强权限可能导致的文件丢失、邮件误发、数据泄露等风险
  • 一键安全扫描 — 自动检测 IP 地址暴露、端口绑定、Gateway Token、技能库权限、配置文件权限等
  • 风险分级展示 — 高/中/低风险排序,复选框列表展示,可修复项勾选
  • 一键修复 — 自动修复可处理的安全问题,不可修复项提供详细的手动操作指南

🎨 界面主题

支持亮色/暗色双主题切换,默认亮色模式。

  • 亮色模式 — Apple 风格柔白设计,清新舒适
  • 暗色模式 — 深色主题,护眼适合长时间使用
  • 一键切换 — 顶部导航栏 🌙/☀️ 按钮
  • 状态持久化 — 刷新或重启后自动恢复上次主题选择

✨ 功能特性

模块 功能
📊 仪表盘 实时服务状态监控、进程内存统计、一键启动/停止/重启
🤖 AI 配置 14+ AI 提供商、自定义 API 地址、模型快速切换
📱 消息渠道 Telegram、Discord、Slack、飞书、微信、iMessage、钉钉、QQ,每个渠道附配置说明文档
🤝 Agent 管理 多智能体管理、角色分工、模型覆盖、渠道绑定、沙箱隔离
🧩 技能库 技能搜索与分类、安装/卸载/启用/禁用、可视化配置、自定义安装
🛡️ 安全防护 IP 暴露检测、端口安全、Token 认证、技能权限扫描、一键修复
服务管理 后台服务控制、实时日志、开机自启
🧪 测试诊断 系统环境检查、AI 连接测试、渠道连通性测试
🎨 主题切换 亮色 / 暗色双主题,持久化保存

🚀 快速开始

方式一:直接下载安装

从 GitHub Releases 下载对应平台的安装包,无需配置开发环境。

👉 下载最新版本

平台 安装包格式 安装方式
macOS .dmg 双击打开,拖入 Applications 文件夹
Windows .msi / .exe 双击运行安装向导
Linux .deb / .AppImage sudo dpkg -i *.deb 或直接运行 AppImage

⚠️ macOS 用户提示:首次打开如遇 "已损坏" 提示,请参考下方 macOS 常见问题


方式二:自行编译运行

环境要求

  • Node.js >= 18.0
  • Rust >= 1.70
  • npm 或 pnpm

平台额外依赖

macOS
xcode-select --install
Windows
Linux (Ubuntu/Debian)
sudo apt update
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev \
  libgtk-3-dev libsoup-3.0-dev libjavascriptcoregtk-4.1-dev

安装与运行

# 克隆项目
git clone https://github.com/miaoxworld/openclaw-manager.git
cd openclaw-manager

# 安装依赖
npm install

# 开发模式运行(热重载)
npm run tauri dev

# 构建发布版本
npm run tauri build

构建产物

运行 npm run tauri build 后,安装包生成在 src-tauri/target/release/bundle/

平台 格式
macOS .dmg, .app
Windows .msi, .exe
Linux .deb, .AppImage

🍎 macOS 常见问题

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

macOS 的 Gatekeeper 安全机制可能会阻止运行未签名的应用。解决方法:

方法一:移除隔离属性(推荐)

xattr -cr /Applications/OpenClaw\ Manager.app

方法二:通过系统偏好设置允许

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

📁 项目结构

openclaw-manager/
├── src-tauri/                 # Rust 后端
│   ├── src/
│   │   ├── main.rs            # 入口
│   │   ├── commands/          # Tauri Commands
│   │   │   ├── service.rs     # 服务管理
│   │   │   ├── config.rs      # 配置管理
│   │   │   ├── process.rs     # 进程管理
│   │   │   └── diagnostics.rs # 诊断 + 安全扫描
│   │   ├── models/            # 数据模型
│   │   └── utils/             # 工具函数
│   ├── Cargo.toml
│   └── tauri.conf.json
│
├── src/                       # React 前端
│   ├── App.tsx
│   ├── lib/
│   │   └── ThemeContext.tsx    # 主题切换
│   ├── components/
│   │   ├── Layout/            # 布局(Sidebar + Header)
│   │   ├── Dashboard/         # 仪表盘
│   │   ├── AIConfig/          # AI 配置
│   │   ├── Channels/          # 渠道配置
│   │   ├── Agents/            # Agent 管理
│   │   ├── Skills/            # 技能库
│   │   ├── Security/          # 安全防护
│   │   ├── Testing/           # 测试诊断
│   │   ├── Logs/              # 应用日志
│   │   └── Settings/          # 设置
│   └── styles/
│       └── globals.css        # 主题变量 + 全局样式
│
├── package.json
├── vite.config.ts
└── tailwind.config.js

🛠️ 技术栈

层级 技术 说明
前端框架 React 18 用户界面
样式 TailwindCSS + CSS 变量 主题切换 + 原子化 CSS
动画 Framer Motion 流畅过渡动画
图标 Lucide React 精美图标
后端 Rust 高性能系统调用
跨平台 Tauri 2.0 原生应用封装

🔧 开发命令

npm run tauri dev        # 开发模式(热重载)
npm run dev              # 仅运行前端
npm run build            # 构建前端
npm run tauri build      # 构建完整应用
cd src-tauri && cargo check   # 检查 Rust 代码

🤝 贡献指南

  1. Fork 项目
  2. 创建功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 创建 Pull Request

📄 许可证

MIT License - 详见 LICENSE

🔗 相关链接


Made with ❤️ by OpenClaw Community

Made with ❤️ by OpenClaw Team


🦞 OpenClaw Manager (English)

A high-performance cross-platform AI assistant management tool, built with Tauri 2.0 + React + TypeScript + Rust.

Platform Tauri React Rust

📸 Screenshots

📊 Dashboard Overview

Real-time service status monitoring with one-click AI assistant service management.

Dashboard

  • Real-time service status monitoring (port, process ID, memory, uptime)
  • Quick actions: Start / Stop / Restart / Diagnose
  • Live log viewer with auto-refresh support

🤖 AI Model Configuration

Flexibly configure multiple AI providers with custom API endpoint support.

AI Config

  • 14+ AI providers supported (Anthropic, OpenAI, DeepSeek, Moonshot, Gemini, etc.)
  • Custom API endpoints, compatible with OpenAI-format third-party services
  • One-click primary model selection with quick switching

📱 Message Channel Configuration

Connect to multiple messaging platforms to build an omni-channel AI assistant.

Telegram Config

Telegram Bot

Feishu Config

Feishu Bot

  • Telegram - Bot Token setup, DM/group policies
  • Feishu - App ID/Secret, WebSocket connection, multi-region deployment
  • More Channels - Discord, Slack, WhatsApp, iMessage, WeChat, DingTalk

✨ Features

Module Features
📊 Dashboard Real-time service status monitoring, process & memory stats, one-click start/stop/restart
🤖 AI Config 14+ AI providers, custom API endpoints, quick model switching
📱 Channels Telegram, Discord, Slack, Feishu, WeChat, iMessage, DingTalk
Service Management Background service control, live logs, auto-start on boot
🧪 Testing & Diagnostics System environment checks, AI connection tests, channel connectivity tests

🍎 macOS Troubleshooting

"Damaged and can't be opened" Error

macOS Gatekeeper may block unsigned applications. Solutions:

Method 1: Remove quarantine attribute (Recommended)

# For .app files
xattr -cr /Applications/OpenClaw\ Manager.app

# Or for .dmg files (before installation)
xattr -cr ~/Downloads/OpenClaw-Manager.dmg

Method 2: Allow through System Preferences

  1. Open System Preferences > Privacy & Security
  2. Find the blocked app in the "Security" section
  3. Click Open Anyway

Method 3: Temporarily disable Gatekeeper (Not recommended)

# Disable (requires admin password)
sudo spctl --master-disable

# Re-enable after installation
sudo spctl --master-enable

Permission Issues

If the app cannot access files or perform operations:

Grant Full Disk Access

  1. Open System Preferences > Privacy & Security > Full Disk Access
  2. Click the lock icon to unlock, then add OpenClaw Manager

Reset Permissions

If permissions are misconfigured, try resetting:

# Reset accessibility permissions database
sudo tccutil reset Accessibility

# Reset full disk access permissions
sudo tccutil reset SystemPolicyAllFiles

🚀 Quick Start

Requirements

  • Node.js >= 18.0
  • Rust >= 1.70
  • pnpm (recommended) or npm

macOS Additional Dependencies

xcode-select --install

Windows Additional Dependencies

Linux Additional Dependencies

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

# Fedora
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file libxdo-devel

Installation & Running

# Clone the project
git clone https://github.com/miaoxworld/openclaw-manager.git
cd openclaw-manager

# Install dependencies
npm install

# Run in development mode
npm run tauri:dev

# Build release version
npm run tauri:build

📁 Project Structure

openclaw-manager/
├── src-tauri/                 # Rust Backend
│   ├── src/
│   │   ├── main.rs            # Entry point
│   │   ├── commands/          # Tauri Commands
│   │   │   ├── service.rs     # Service management
│   │   │   ├── config.rs      # Configuration management
│   │   │   ├── process.rs     # Process management
│   │   │   └── diagnostics.rs # Diagnostics
│   │   ├── models/            # Data models
│   │   └── utils/             # Utilities
│   ├── Cargo.toml
│   └── tauri.conf.json
│
├── src/                       # React Frontend
│   ├── App.tsx
│   ├── components/
│   │   ├── Layout/            # Layout components
│   │   ├── Dashboard/         # Dashboard
│   │   ├── AIConfig/          # AI configuration
│   │   ├── Channels/          # Channel configuration
│   │   ├── Service/           # Service management
│   │   ├── Testing/           # Testing & diagnostics
│   │   └── Settings/          # Settings
│   └── styles/
│       └── globals.css
│
├── package.json
├── vite.config.ts
└── tailwind.config.js

🛠️ Tech Stack

Layer Technology Description
Frontend Framework React 18 User interface
State Management Zustand Lightweight state management
Styling TailwindCSS Atomic CSS
Animation Framer Motion Smooth animations
Icons Lucide React Beautiful icons
Backend Rust High-performance system calls
Cross-platform Tauri 2.0 Native app wrapper

📦 Build Artifacts

After running npm run tauri:build, artifacts are generated in src-tauri/target/release/bundle/:

Platform Format
macOS .dmg, .app
Windows .msi, .exe
Linux .deb, .AppImage

🎨 Design Philosophy

  • Dark Theme: Easy on the eyes, suitable for extended use
  • Modern UI: Frosted glass effects, smooth animations
  • Responsive: Adapts to different screen sizes
  • High Performance: Rust backend with minimal memory footprint

🔧 Development Commands

# Development mode (hot reload)
npm run tauri:dev

# Run frontend only
npm run dev

# Build frontend
npm run build

# Build full application
npm run tauri:build

# Check Rust code
cd src-tauri && cargo check

# Run Rust tests
cd src-tauri && cargo test

📝 Configuration Notes

Tauri Configuration (tauri.conf.json)

  • app.windows - Window configuration
  • bundle - Bundling configuration
  • plugins.shell.scope - Shell command allowlist
  • plugins.fs.scope - File access allowlist

Environment Variables

The app reads environment variable configuration from ~/.openclaw/env.

🤝 Contributing

  1. Fork the project
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Create a Pull Request

📄 License

MIT License - See LICENSE for details

🔗 Links


Made with ❤️ by OpenClaw Team

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors