Automation
Plugin
youclaw
๐ฆ 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.
Plugin Signal54/100Fair
maintained45
capable29
documented100
adopted61
Install
$ npx -y skills add OtterMind/youclaw --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
723
Stars
168
Forks
Maintained
Maintenance
TypeScript
Language
MIT
License
4mo ago
Last commit
5mo ago
Created
Repo: OtterMind/youclaw
What's inside
Skills
2README
1Download & 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 usersRemote CDPโ for existing advanced automation setupsExtension 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
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
main - Make your changes and ensure
bun typecheckandbun testpass - Submit a pull request
License
MIT ยฉ CHATDATA
File tree
567OtterMind/youclawView on GitHub
.claude/
commands/
release.md
.env.example
.github/
actions/
notify-feishu/
action.yml
setup-build-env/
action.yml
workflows/
build.yml
pr-ci.yml
.gitignore
AGENTS.md
app.config.ts
bun.lock
CLAUDE.md
docs/
browser-profiles.md
browser-profiles.zh.md
contributing/
pull-request-guide.md
pull-request-guide.zh.md
e2e/
fixtures.ts
playwright.config.ts
tests/
agents.spec.ts
browser/
browser-advanced.spec.ts
browser-api.spec.ts
browser-basic-ui.spec.ts
browser-chat-integration.spec.ts
browser-crud.spec.ts
browser-serial-crud.spec.ts
browser-validation.spec.ts
helpers.ts
channels/
channels-basic-ui.spec.ts
channels-crud.spec.ts
channels-validation.spec.ts
helpers.ts
chat/
chat-attachments.spec.ts
chat-basic-ui.spec.ts
chat-messaging.spec.ts
chat-session-restore.spec.ts
chat-session.spec.ts
chat-validation.spec.ts
helpers.ts
logs.spec.ts
memory.spec.ts
multi-agent.spec.ts
navigation.spec.ts
settings/
helpers.ts
port-api.spec.ts
port-ui.spec.ts
skills/
skills.spec.ts
helpers.ts
skills-marketplace.spec.ts
system.spec.ts
tasks/
helpers.ts
tasks-advanced.spec.ts
tasks-agent-tools.spec.ts
tasks-basic-ui.spec.ts
tasks-crud.spec.ts
tasks-execution.spec.ts
tasks-validation.spec.ts
extensions/
main-browser-chromium/
manifest.json
popup.html
popup.js
README.md
service-worker.js
LICENSE
package.json
prompts/
env.md
system.md
README.ja.md
README.md
README.zh-CN.md
scripts/
build-sidecar.mjs
debug-server.bat
validate-recommended-skills.ts
skills/
agent-browser/
SKILL.md
web-search/
SKILL.md
src/
src-tauri/
app.manifest
build.rs
capabilities/
default.json
Cargo.lock
Cargo.toml
gen/
schemas/
acl-manifests.json
capabilities.json
desktop-schema.json
macOS-schema.json
windows-schema.json
icons/
128x128.png
128x128@2x.png
32x32.png
icon.icns
icon.ico
icon.png
trayTemplate.png
trayTemplate@2x.png
nsis/
installer.nsh
src/
lib.rs
main.rs
tauri.conf.json
agent/
abort-registry.ts
bootstrap-cache.ts
builtin-mcp.ts
context-utils.ts
document-converter.ts
document-mcp.ts
hooks.ts
index.ts
manager.test.ts
manager.ts
mcp-tools.ts
message-mcp.ts
message-timestamp.ts
model-resolver.ts
prompt-builder.ts
queue.ts
router.ts
runtime-model.ts
runtime-tools.test.ts
runtime-tools.ts
runtime.ts
schema.ts
secrets.ts
security.ts
task-mcp.ts
templates.ts
types.ts
workspace.test.ts
workspace.ts
browser/
cdp-proxy-bypass.ts
chrome.ts
detect.ts
extension-bridge.ts
extension-package.ts
extension-session.ts
index.ts
main-bridge.ts
manager.ts
mcp.ts
playwright-runner.js
pw-session.ts
relay.ts
router.ts
routes.ts
setup-session.ts
store.ts
types.ts
channel/
config-schema.ts
dingtalk.ts
factory.ts
feishu.ts
index.ts
manager.ts
outbound-service.ts
qq.ts
router.ts
telegram.ts
types.ts
wechat-oa.ts
wechat-personal.test.ts
wechat-personal.ts
wecom.ts
config/
build-constants.ts
env.ts
index.ts
paths.ts
tools.ts
db/
index.ts
document/
chunker.ts
parsers/
office.ts
pdf.ts
types.ts
service.ts
types.ts
events/
bus.ts
index.ts
types.ts
index.ts
logger/
broadcaster.ts
index.ts
model-invocation.test.ts
model-invocation.ts
reader.test.ts
reader.ts
memory/
archiver.ts
extractor.ts
index.ts
indexer.ts
manager.ts
openclaw/
openclaw-plugins/
openclaw-weixin/
CHANGELOG.md
CHANGELOG.zh_CN.md
index.ts
LICENSE
openclaw.plugin.json
package.json
README.md
README.zh_CN.md
src/
api/
api.ts
config-cache.ts
session-guard.ts
types.ts
auth/
accounts.ts
login-qr.ts
pairing.ts
cdn/
aes-ecb.ts
cdn-upload.ts
cdn-url.ts
pic-decrypt.ts
upload.ts
channel.ts
config/
config-schema.ts
log-upload.ts
media/
media-download.ts
mime.ts
silk-transcode.ts
messaging/
debug-mode.ts
error-notice.ts
inbound.ts
process-message.ts
send-media.ts
send.ts
slash-commands.ts
monitor/
monitor.ts
runtime.ts
storage/
state-dir.ts
sync-buf.ts
util/
logger.ts
random.ts
redact.ts
vendor.d.ts
host.ts
plugin-sdk-core.ts
plugin-sdk.ts
realtime/
hub.ts
types.ts
routes/
agents.ts
auth.ts
browser-profiles.ts
channels.ts
credit.ts
health.ts
index.ts
logs.test.ts
logs.ts
memory.ts
messages.ts
proxy.ts
realtime.ts
registry.ts
settings.ts
skills.ts
system.ts
tasks.ts
webhooks.ts
scheduler/
index.ts
scheduler.ts
settings/
manager.ts
schema.ts
skills/
archive.ts
catalog.test.ts
catalog.ts
eligibility.ts
frontmatter.ts
globs.ts
import-manager.ts
index.ts
installer.ts
invoke.ts
loader.ts
project-service.test.ts
project-service.ts
recommendation-sources/
ai-intelligence.json
communication-collaboration.json
content-creation.json
data-analysis.json
developer-tools.json
index.ts
productivity.json
security-compliance.json
recommended/
ai-intelligence.json
communication-collaboration.json
content-creation.json
data-analysis.json
developer-tools.json
index.ts
productivity.json
security-compliance.json
refresh.ts
registry-cursors.ts
registry-pagination.ts
registry-tencent-query.ts
registry.test.ts
registry.ts
types.ts
watcher.ts
task/
index.ts
repository.ts
schedule.ts
service.ts
types/
attachment.ts
pdfjs-worker.d.ts
utils/
chrome.ts
shell-env.ts
tests/
abort-registry.test.ts
abort-session-wiring.test.ts
agent-compiler.test.ts
agent-context-utils.test.ts
agent-message-timestamp.test.ts
agent-router.test.ts
archive.test.ts
browser-disable-wiring.test.ts
browser-discovery-wiring.test.ts
browser-discovery.test.ts
browser-extension-bridge-wiring.test.ts
browser-extension-package-wiring.test.ts
browser-extension-package.test.ts
browser-extension-relay.test.ts
browser-extension-transport.test.ts
browser-main-bridge.test.ts
browser-manager.test.ts
browser-profiles-routes.test.ts
browser-profiles-sync.test.ts
browser-proxy-bypass.test.ts
browser-ref-act-wiring.test.ts
browser-router-dynamic.test.ts
browser-runtime-wiring.test.ts
browser-setup-session-wiring.test.ts
browser-setup-session.test.ts
browser-target-routing.test.ts
channel-dingtalk.test.ts
channel-feishu.test.ts
channel-manager.test.ts
channel-outbound-service.test.ts
channel-qq.test.ts
channel-router.test.ts
channel-wecom.test.ts
chat-abort-wiring.test.ts
chat-agent-binding-wiring.test.ts
chat-attachments.test.ts
chat-store.test.ts
... 254 moreFAQ
youclaw is a Claude Code plugin with 2 hand-picked skills for automation work, indexed on Flowy. Install it with the command on its page. It includes agent-browser, web-search. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is youclaw?
- ๐ฆ 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.
- How do I install youclaw?
- Run these in Claude Code: npx -y skills add OtterMind/youclaw --agent claude-code. Then prompt normally.
- Does youclaw auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is youclaw free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.