youclaw

Name: youclaw
Author: CodePhiliaX

Warning

🦞 Your AI Personal Assistant. An intelligent assistant with memory, skills, and scheduled tasks that truly understands you . Helping you tackle everything in work and life.

714stars

166forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/CodePhiliaX/youclaw

Getting Started

Guides for using ai agents skills like youclaw.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportWarning

Last scanned: 5/8/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@larksuiteoapi/node-sdk: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "axios: Axios has a NO_PROXY Hostname Normalization Bypass that Leads to SSRF",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "xlsx: Prototype Pollution in sheetJS",
      "severity": "high"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-05-08T05:58:37.632Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is youclaw?

youclaw is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by CodePhiliaX. 🦞 Your AI Personal Assistant. An intelligent assistant with memory, skills, and scheduled tasks that truly understands you . Helping you tackle everything in work and life. It has 714 GitHub stars.

Is youclaw safe to use?

youclaw returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install youclaw?

Clone the repository with "git clone https://github.com/CodePhiliaX/youclaw" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is youclaw written in?

youclaw is primarily written in TypeScript. It is open-source under CodePhiliaX on GitHub, so you can review or fork the full source.

Are there alternatives to youclaw?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh youclaw against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

216,924

OpenBiliClaw ai-trader

Download & Install

macOS

Download the .dmg 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 .exe 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

Browser Profiles

YouClaw supports three browser profile drivers:

Managed Chromium — recommended for most users
Remote CDP — for existing advanced automation setups
Extension Relay — advanced local attach mode for a browser that already exposes a loopback CDP endpoint

Detailed guide:

English: docs/browser-profiles.md
简体中文: docs/browser-profiles.zh.md

Tech Stack

Layer	Choice
Runtime & Package Manager	Bun
Desktop Shell	Tauri 2 (Rust)
Backend	Hono + bun:sqlite + Pino
Agent	`@mariozechner/pi-coding-agent` + `@mariozechner/pi-ai`
Frontend	Vite + React + shadcn/ui + Tailwind CSS
Channels	grammY (Telegram) · `dingtalk-stream` (DingTalk) · `@larksuiteoapi/node-sdk` (Feishu) · QQ · WeCom
Scheduled Tasks	croner
E2E Testing	Playwright

Architecture

┌──────────────────────────────────────────────────────┐
│                Tauri 2 (Rust Shell)                   │
│   ┌──────────────┐    ┌────────────────────────────┐ │
│   │   WebView     │    │   Bun Sidecar              │ │
│   │  Vite+React   │◄──►  Hono API Server           │ │
│   │  shadcn/ui    │ HTTP│  Multi-provider Agent RT  │ │
│   │               │ SSE │  bun:sqlite               │ │
│   └──────────────┘    └────────────────────────────┘ │
└──────────────────────────────────────────────────────┘
         │                        │
    Tauri Store              EventBus
   (settings)          ┌────────┴────────────┐
                        │                     │
                   Web / API         Multi-Channel
                              ┌───────┼───────┐
                           Telegram DingTalk Feishu
                              QQ    WeCom
                                     │
                              Browser Automation
                               (Playwright)

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)

Quick Start (Development)

Prerequisites

Bun >= 1.1
Rust (for Tauri desktop build)
A model API key for your chosen provider

Setup

git clone https://github.com/CodePhiliaX/youClaw.git
cd youClaw

# Install dependencies
bun install
cd web && bun install && cd ..

# Configure environment
cp .env.example .env
# Edit .env and set MODEL_API_KEY

Web Mode

# Terminal 1 — backend
bun dev

# Terminal 2 — frontend
bun dev:web

Open http://localhost:5173 · API at http://localhost:62601

Desktop Mode (Tauri)

bun dev:tauri

Build Desktop App

bun build:tauri

Output: src-tauri/target/release/bundle/ (DMG / MSI / AppImage)

Commands

bun dev              # Backend dev server (hot reload)
bun dev:web          # Frontend dev server
bun dev:tauri        # Tauri dev mode (frontend + backend + WebView)
bun start            # Production backend
bun typecheck        # TypeScript type check
bun test             # Run tests
bun build:sidecar    # Compile Bun sidecar binary
bun build:tauri      # Build Tauri desktop app
bun build:tauri:fast # Build without bundling (faster dev builds)
bun test:e2e         # Run E2E tests (Playwright)
bun test:e2e:ui      # Run E2E tests with UI

Environment Variables

Variable	Required	Default	Description
`MODEL_PROVIDER`	No	`builtin`	Default model provider or runtime mode
`MODEL_ID`	No	`minimax/MiniMax-M2.7-highspeed`	Default model reference
`MODEL_API_KEY`	Yes	—	Model API key
`MODEL_BASE_URL`	No	—	Custom model API base URL
`PORT`	No	`62601`	Backend server port
`DATA_DIR`	No	`./data` in dev, `~/.youclaw` in desktop production	Data storage directory. For dev, set `DATA_DIR=~/.youclaw-dev` if you want an isolated user-home data dir
`LOG_LEVEL`	No	`info`	Log level
`TELEGRAM_BOT_TOKEN`	No	—	Enable Telegram channel
`DINGTALK_CLIENT_ID`	No	—	DingTalk app client ID
`DINGTALK_SECRET`	No	—	DingTalk app secret
`FEISHU_APP_ID`	No	—	Feishu (Lark) app ID
`FEISHU_APP_SECRET`	No	—	Feishu (Lark) app secret
`QQ_BOT_APP_ID`	No	—	QQ bot app ID
`QQ_BOT_SECRET`	No	—	QQ bot secret
`WECOM_CORP_ID`	No	—	WeCom corp ID
`WECOM_CORP_SECRET`	No	—	WeCom corp secret
`WECOM_AGENT_ID`	No	—	WeCom agent ID
`WECOM_TOKEN`	No	—	WeCom callback token
`WECOM_ENCODING_AES_KEY`	No	—	WeCom callback AES key
`YOUCLAW_WEBSITE_URL`	No	—	Cloud service website URL
`YOUCLAW_API_URL`	No	—	Cloud service API URL
`MINIMAX_API_KEY`	No	—	MiniMax web search API key
`MINIMAX_API_HOST`	No	—	MiniMax API host

Project Structure

src/
├── agent/          # AgentManager, AgentRuntime, AgentQueue, PromptBuilder
├── channel/        # Multi-channel support
│   ├── router.ts   # MessageRouter
│   ├── telegram.ts # Telegram (grammY)
│   ├── dingtalk.ts # DingTalk (dingtalk-stream)
│   ├── feishu.ts   # Feishu / Lark (@larksuiteoapi/node-sdk)
│   ├── qq.ts       # QQ
│   └── wecom.ts    # WeCom
├── config/         # Environment validation, path constants
├── db/             # bun:sqlite init, CRUD operations
├── events/         # EventBus (stream/tool_use/complete/error)
├── ipc/            # File-polling IPC between Agent and main process
├── logger/         # Pino logger
├── memory/         # Memory helpers for root MEMORY.md plus per-agent logs/archives
├── routes/         # Hono API routes (/api/*)
├── scheduler/      # Cron/interval/once task scheduler
├── skills/         # Skills loader, watcher, frontmatter parser
src-tauri/
├── src/            # Rust main process (sidecar, window, tray, updater)
agents/             # Agent workspaces (agent.yaml + bootstrap docs + MEMORY.md + skills/)
skills/             # Project-level skills (SKILL.md format)
e2e/                # E2E tests (Playwright)
web/src/
├── pages/          # Chat, Agents, Skills, Memory, Tasks, Channels, BrowserProfiles, Logs, System, Login
├── components/     # Layout + shadcn/ui
├── api/            # HTTP client + transport
├── i18n/           # i18n (Chinese / English)

Contributing

Fork the repo and create your branch from `ma