Tools
Talons
By Talons is a modern, enterprise-grade web-based control center for **OpenClaw**. Built with Next.js 15, React 19, and Horizon UI, it provides a premium interface to orchestrate your AI agents, manage plugins, build knowledge bases, and monitor gateway health with unparalleled efficiency.
Install
npm install
```README
<p align="center">
<img src="public/talons_sidebar.png" width="128" alt="Talons Logo" />
</p>
<p align="center">
<a href="./README.md">English</a> | <a href="./README_ZH.md">简体中文</a>
</p>
# Talons 🦅 - The Ultimate OpenClaw Control Center
[](https://nextjs.org/)
[](https://react.dev/)
[](https://www.typescriptlang.org/)
[](https://tailwindcss.com/)
[](./LICENSE)
[](./package.json)
Talons is a modern, enterprise-grade web-based control center for **OpenClaw**. Built with Next.js 15, React 19, and Horizon UI, it provides a premium interface to orchestrate your AI agents, manage plugins, build knowledge bases, and monitor gateway health with unparalleled efficiency.
> [!IMPORTANT]
> **License Note**: This platform is provided for **Personal and Non-Commercial Research** purposes only. Commercial use, redistribution for profit, or use of the software for commercial services is strictly prohibited.
---
## ✨ Key Features
- **🚀 Real-time Gateway Monitoring**: Seamlessly track OpenClaw Gateway connectivity, latency, and status via a high-performance proxy.
- **🤖 Agent Lifecycle Management**: Full control over AI agents, including configuration, individual capabilities, and real-time interaction.
- **🧩 OpenClaw Plugin Ecosystem**: Complete plugin management system. Features include dynamic configuration forms (via `uiHints`), CLI-based synchronization, and lifecycle control.
- **📚 Advanced Knowledge Base**:
- **Hierarchical Structure**: Organize documents in multi-level nested directories.
- **Multi-format Parsing**: Native support for PDF, DOCX, XLSX, and Markdown.
- **Granular Permissions**: Public/Private visibility and agent-specific read/write access control.
- **Semantic Retrieval**: Two-stage RAG (Retrieval-Augmented Generation) with PageIndex-style structural indexing.
- **🔍 Unified Global Search**: Lightning-fast, platform-wide search for quickly locating agents, plugins, and documents.
- **🛡️ Enterprise RBAC**: Robust Role-Based Access Control to manage users and secure your AI infrastructure.
- **⏰ Visual Cron Scheduling**: A comprehensive dashboard to schedule, monitor, and toggle automated tasks.
- **💬 Premium Chat UI**: A responsive, integrated interface for direct, low-latency communication with your AI agents.
- **🔐 Secure Identity**: Device-level verification using ed25519 signing and challenge-response protocols.
- **🌗 Responsive Dark Mode**: A stunning, developer-first design that adapts perfectly to any lighting environment.
---
## 📸 Screenshots
Check out the [Talons Platform Screenshots](docs/screenshot.md) for a visual overview of the interface and features.
---
## 🛠️ Tech Stack
- **Framework**: [Next.js 15](https://nextjs.org/) (App Router) & [React 19](https://react.dev/)
- **Styling**: [Tailwind CSS](https://tailwindcss.com/)
- **Database**: SQLite with [Drizzle ORM](https://orm.drizzle.team/)
- **UI Architecture**: [Horizon UI](https://horizon-ui.com/) (React Tailwind Version)
- **Communication**: WebSockets & Socket.IO for real-time state synchronization
- **Engine**: Node.js with native module support (Pty, Libsql)
---
## 🚀 Getting Started
### Prerequisites
- **Node.js**: v20 or higher (Recommended for React 19 compatibility)
- **Package Manager**: [pnpm](https://pnpm.io/) (Mandatory for workspace management)
- **OpenClaw**: A running OpenClaw instance
### Installation
1. **Clone the repository**:
```bash
git clone https://github.com/seboluo/talons.git
cd talons
```
2. **Install dependencies**:
```bash
pnpm install
```
3. **Database Setup**:
```bash
npx drizzle-kit push
```
4. **Environment Configuration**:
Talons centralizes configuration at `~/.talons/.env`. Link it for development:
```bash
ln -s ~/.talons/.env .env.local
```
### Development & Build
- **Development Mode**: `pnpm dev`
- **Electron (Desktop)**: `pnpm electron:dev`
- **Build & Package**: `pnpm electron:build` (Handles multi-arch compilation automatically)
---
## 🏗️ Project Structure
- `src/app/openclaw`: Core domains (Agents, Plugins, Knowledge, Chat, Cron).
- `plugins/`: Definitions and UI metadata for OpenClaw extensions.
- `electron-src/`: Desktop integration and native bridge logic.
- `src/lib/knowledge`: Document parsing, indexing, and retrieval engines.
- `src/db`: Database schema and migrations.
---
## 📈 Automatic Versioning
Talons follows a date-based release cycle (e.g., `v2026.3.26`). Versions are automatically updated via `scripts/update-version.js` during the pre-build phase.
---
## 🚧 Current Status & Roadmap
- [ ] **Multi-OS Support**: Currently only verified on macOS (Apple Silicon). Testing and adaptation for Windows and Linux are ongoing.
- [ ] **Plugin Creation**: The "New Plugin" feature in the management interface is not yet implemented.
- [ ] **Desktop Distribution**: Electron-based application packaging and distribution setup are in progress.
- [ ] **IM Channel Support**: Only the Feishu channel has been fully verified. Other OpenClaw channels (Telegram, Discord, etc.) require further testing.
---
## 📄 License
Distributed under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/). See `LICENSE` for the full legal text. This project prohibits any form of commercialization and is intended for individual research only.
---
<p align="center">Empowering the OpenClaw community with premium orchestration. Made with ❤️</p>
tools
Comments
Sign in to leave a comment