CodePhiliaX / youclaw

YouClaw English | 简体中文 | 日本語 Desktop AI Assistant powered by Claude Agent SDK If YouClaw is useful to you, give it a GitHub Star. More stars help more people discover the project. One click helps keep YouClaw improving. --- Download & Install macOS Download the file from the Releases page, open it and drag **YouClaw** into Applications. > Apple Silicon (M1/M2/M3/M4) and Intel are both supported. Windows Download the installer from Releases and run it. Linux 🚧 Coming soon — stay tuned! --- Features • **Multi-Agent Management** — Create and configure multiple AI agents via YAML, each with its own personality, memory, and skills • **Multi-Channel** — Connect agents to Telegram, DingTalk, Feishu (Lark), QQ, and WeCom • **Browser Automation** — Built-in agent-browser skill with Playwright for web interaction, scraping, and testing • **Scheduled Tasks** — Cron / interval / one-shot tasks with automatic retry and stuck detection • **Persistent Memory** — Per-agent memory system with conversation logs • **Skills System** — Compatible with OpenClaw SKILL.md format, 3-tier priority loading, hot reload, skills marketplace • **Authentication** — Built-in auth system for cloud deployment • **Web UI** — React + shadcn/ui with SSE streaming, i18n (中文 / English) • **Lightweight Desktop App** — Tauri 2 bundle ~27 MB (vs ~338 MB Electron), native system tray Tech Stack | Layer | Choice | |-------|--------| | Runtime & Package Manager | Bun | | Desktop Shell | Tauri 2 (Rust) | | Backend | Hono + bun:sqlite + Pino | | Agent | | | Frontend | Vite + React + shadcn/ui + Tailwind CSS | | Channels | grammY (Telegram) · (DingTalk) · (Feishu) · QQ · WeCom | | Scheduled Tasks | croner | | E2E Testing | Playwright | Architecture • **Desktop mode**: Tauri spawns a Bun sidecar process; WebView loads the frontend • **Web mode**: Vite frontend + Bun backend deployed independently • **Three-layer design**: Entry (Telegram/DingTalk/Feishu/QQ/WeCom/Web/API) → Core (Agent/Scheduler/Memory/Skills) → Storage (SQLite/filesystem) Before Quick Start: Star if you want to see YouClaw keep improving. It is a small click that makes the project easier to sustain. Quick Start (Development) Prerequisites • Bun >= 1.1 • Rust (for Tauri desktop build) • An Anthropic API key Setup Web Mode Open http://localhost:5173 · API at http://localhost:62601 Desktop Mode (Tauri) Build Desktop App Output: (DMG / MSI / AppImage) Commands Environment Variables | Variable | Required | Default | Description | |----------|----------|---------|-------------| | | Yes | — | Anthropic API key | | | No | — | Custom API base URL | | | No | | Backend server port | | | No | | Data storage directory | | | No | | Default Claude model | | | No | | Log level | | | No | — | Enable Telegram channel | | | No | — | DingTalk app client ID | | | No | — | DingTalk app secret | | | No | — | Feishu (Lark) app ID | | | No | — | Feishu (Lark) app secret | | | No | — | QQ bot app ID | | | No | — | QQ bot secret | | | No | — | WeCom corp ID | | | No | — | WeCom corp secret | | | No | — | WeCom agent ID | | | No | — | WeCom callback token | | | No | — | WeCom callback AES key | | | No | — | Cloud service website URL | | | No | — | Cloud service API URL | | | No | — | MiniMax web search API key | | | No | — | MiniMax API host | Project Structure Contributing • Fork the repo and create your branch from • Make your changes and ensure and pass • Submit a pull request License MIT © CHATDATA