Desktop AI assistant powered by a multi-provider coding agent runtime
$git clone https://github.com/ottermind/youclawInstalls into the current project.
Install youclaw by running `git clone https://github.com/ottermind/youclaw`, then use it for the current task and follow its documentation at https://github.com/ottermind/youclaw.
| 1 | <p align="center"> |
| 2 | <img src="web/src/assets/logo.png" width="120" alt="YouClaw Logo" /> |
| 3 | </p> |
| 4 | |
| 5 | <h1 align="center">YouClaw</h1> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <strong>English</strong> | <a href="./README.zh-CN.md">简体中文</a> | <a href="./README.ja.md">日本語</a> |
| 9 | </p> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <strong>Desktop AI Assistant powered by a multi-provider coding agent runtime</strong> |
| 13 | </p> |
| 14 | |
| 15 | <p align="center"> |
| 16 | <a href="https://github.com/CodePhiliaX/youClaw/releases"><img src="https://img.shields.io/github/v/release/CodePhiliaX/youClaw?style=flat-square&color=blue" alt="Release" /></a> |
| 17 | <a href="https://github.com/CodePhiliaX/youClaw/blob/main/LICENSE"><img src="https://img.shields.io/github/license/CodePhiliaX/youClaw?style=flat-square" alt="License" /></a> |
| 18 | <a href="https://github.com/CodePhiliaX/youClaw/stargazers"><img src="https://img.shields.io/github/stars/CodePhiliaX/youClaw?style=flat-square" alt="Stars" /></a> |
| 19 | <a href="https://github.com/CodePhiliaX/youClaw"><img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey?style=flat-square" alt="Platform" /></a> |
| 20 | </p> |
| 21 | |
| 22 | <p align="center"> |
| 23 | <strong>If YouClaw is useful to you, give it a GitHub Star.</strong><br /> |
| 24 | More stars help more people discover the project. |
| 25 | </p> |
| 26 | |
| 27 | <p align="center"> |
| 28 | <a href="https://github.com/CodePhiliaX/youClaw/stargazers"> |
| 29 | <img src="https://img.shields.io/github/stars/CodePhiliaX/youClaw?style=for-the-badge&logo=github&color=ffcb47&label=Star%20YouClaw" alt="Star YouClaw on GitHub" /> |
| 30 | </a> |
| 31 | </p> |
| 32 | |
| 33 | <p align="center"> |
| 34 | <sub>One click helps keep YouClaw improving.</sub> |
| 35 | </p> |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | ## Download & Install |
| 40 | |
| 41 | ### macOS |
| 42 | |
| 43 | Download the `.dmg` file from the [Releases](https://github.com/CodePhiliaX/youClaw/releases) page, open it and drag **YouClaw** into Applications. |
| 44 | |
| 45 | > Apple Silicon (M1/M2/M3/M4) and Intel are both supported. |
| 46 | |
| 47 | ### Windows |
| 48 | |
| 49 | Download the `.exe` installer from [Releases](https://github.com/CodePhiliaX/youClaw/releases) and run it. |
| 50 | |
| 51 | ### Linux |
| 52 | |
| 53 | 🚧 Coming soon — stay tuned! |
| 54 | |
| 55 | --- |
| 56 | |
| 57 | ## Features |
| 58 | |
| 59 | - **Multi-Agent Management** — Create and configure multiple AI agents via YAML, each with its own personality, memory, and skills |
| 60 | - **Multi-Channel** — Connect agents to Telegram, DingTalk, Feishu (Lark), QQ, and WeCom |
| 61 | - **Browser Automation** — Built-in agent-browser skill with Playwright for web interaction, scraping, and testing |
| 62 | - **Scheduled Tasks** — Cron / interval / one-shot tasks with automatic retry and stuck detection |
| 63 | - **Persistent Memory** — Per-agent memory system with conversation logs |
| 64 | - **Skills System** — Compatible with OpenClaw SKILL.md format, 3-tier priority loading, hot reload, skills marketplace |
| 65 | - **Authentication** — Built-in auth system for cloud deployment |
| 66 | - **Web UI** — React + shadcn/ui with SSE streaming, i18n (中文 / English) |
| 67 | - **Lightweight Desktop App** — Tauri 2 bundle ~27 MB (vs ~338 MB Electron), native system tray |
| 68 | |
| 69 | ## Browser Profiles |
| 70 | |
| 71 | YouClaw supports three browser profile drivers: |
| 72 | |
| 73 | - `Managed Chromium` — recommended for most users |
| 74 | - `Remote CDP` — for existing advanced automation setups |
| 75 | - `Extension Relay` — advanced local attach mode for a browser that already exposes a loopback CDP endpoint |
| 76 | |
| 77 | Detailed guide: |
| 78 | |
| 79 | - English: [docs/browser-profiles.md](./docs/browser-profiles.md) |
| 80 | - 简体中文: [docs/browser-profiles.zh.md](./docs/browser-profiles.zh.md) |
| 81 | |
| 82 | ## Tech Stack |
| 83 | |
| 84 | | Layer | Choice | |
| 85 | |-------|--------| |
| 86 | | Runtime & Package Manager | [Bun](https://bun.sh/) | |
| 87 | | Desktop Shell | [Tauri 2](https://tauri.app/) (Rust) | |
| 88 | | Backend | Hono + bun:sqlite + Pino | |
| 89 | | Agent | `@mariozechner/pi-coding-agent` + `@mariozechner/pi-ai` | |
| 90 | | Frontend | Vite + React + shadcn/ui + Tailwind CSS | |
| 91 | | Channels | grammY (Telegram) · `dingtalk-stream` (DingTalk) · `@larksuiteoapi/node-sdk` (Feishu) · QQ · WeCom | |
| 92 | | Scheduled Tasks | croner | |
| 93 | | E2E Testing | Playwright | |
| 94 | |
| 95 | ## Architecture |
| 96 | |
| 97 | ``` |
| 98 | ┌──────────────────────────────────────────────────────┐ |
| 99 | │ Tauri 2 (Rust Shell) │ |
| 100 | │ ┌──────────────┐ ┌────────── |