持久化个人助手

claude-agent/
├── .claude/
│   ├── settings.json            Hook configuration + env vars
│   ├── hooks/ (4)               Session lifecycle (Node.js)
│   ├── agents/ (4)              researcher, writer, analyst, content-publisher
│   ├── skills/ (49)             7 categories — see Skills Reference below
│   └── rules/ (4)               memory, channels, MCP, content quality
├── app/
│   ├── server/
│   │   ├── index.ts             App assembly + server startup (pure wiring)
│   │   ├── routes/ (14)         Modular REST API routes by domain
│   │   │   ├── sessions.ts      Session CRUD
│   │   │   ├── settings.ts      Language/model/CLI settings
│   │   │   ├── project.ts       Project directory management
│   │   │   ├── skills.ts        Skill management (49 skills)
│   │   │   ├── agents.ts        Agent management
│   │   │   ├── mcp.ts           MCP server configuration
│   │   │   ├── channels.ts      Telegram/Discord channel control
│   │   │   ├── roles.ts         Per-chat role system (14 APIs)
│   │   │   ├── scheduled-tasks.ts  Cron task scheduling
│   │   │   ├── secrets.ts       API key management
│   │   │   ├── discussions.ts   Multi-expert discussion
│   │   │   ├── memory.ts        Memory file read/write
│   │   │   ├── history.ts       Cross-session search
│   │   │   ├── cli.ts           CLI detection + migration
│   │   │   └── system.ts        Health, export, stats, webhook
│   │   ├── ws/handler.ts        WebSocket session management
│   │   ├── agent.ts             AgentSession (Claude CLI wrapper)
│   │   │   ├── sendMessage()     Injects system context + session summary
│   │   │   ├── spawnClaude()     Dynamic 5-layer system prompt
│   │   │   ├── rotate()          Async rotation with compact summary
│   │   │   └── generateCompactSummary()  9-section summary via haiku
│   │   ├── stream-handler.ts    Shared streaming (flush/typing/memory strip)
│   │   ├── memory-extractor.ts  Non-blocking background memory extraction
│   │   ├── telegram.ts          Telegram bridge (polling + media + commands)
│   │   ├── discord.ts           Discord bridge (client + attachments)
│   │   ├── reply-filter.ts      Group reply decision (5 modes)
│   │   ├── discussion.ts        Multi-expert discussion engine
│   │   ├── scheduler.ts         Cron task scheduler
│   │   ├── db.ts                SQLite data layer
│   │   ├── middleware/
│   │   │   ├── security.ts      Path validation + name sanitization
│   │   │   └── rate-limiter.ts  API rate limiting
│   │   ├── prompts/
│   │   │   ├── config-bot.ts    Config Bot system prompt
│   │   │   └── compact.ts       9-section compact summary prompt
│   │   └── constants/
│   │       └── languages.ts     Multi-language rules (en/zh-TW/ja)
│   ├── client/
│   │   ├── App.tsx              React 18 + Tailwind (12 pages)
│   │   ├── i18n.ts              Translations (en, zh-TW, ja)
│   │   └── components/ (12)     Chat, History, Projects, Skills, Agents, Memory, MCP, Secrets, Tasks, Config Bot, Settings, Channels
│   ├── electron/main.cjs        Desktop app entry point
│   └── package.json             App dependencies
├── memory/                      Persistent memory (auto-managed)
├── scripts/migrate-openclaw.cjs One-click OpenClaw migration
├── workspace/                   Runtime output (gitignored)
├── .mcp.json                    4 MCP servers (trend-pulse, claude-101, cf-browser, notebooklm)
├── CLAUDE.md                    Assistant identity + operating rules
└── README.md

git clone https://github.com/claude-world/claude-agent.git
cd claude-agent

# Start Claude Code in the project directory
claude

# First time? Run guided setup
/setup

cd app
npm install    # First time only
npm run dev    # Start the control panel

# Telegram
/plugin install telegram@claude-plugins-official
/telegram:configure YOUR_BOT_TOKEN
claude --channels plugin:telegram@claude-plugins-official
# DM your bot → get pairing code → /telegram:access pair ABCDEF

# Discord
/plugin install discord@claude-plugins-official
/discord:configure YOUR_BOT_TOKEN
claude --channels plugin:discord@claude-plugins-official
# DM your bot → get pairing code → /discord:access pair ABCDEF

# Both together
claude --channels plugin:telegram@claude-plugins-official,plugin:discord@claude-plugins-official

"Good morning"              → Daily briefing with tasks & news
"Research AI coding tools"  → Web research with summary
"Create a post about X"    → Patent-scored social content
"Make a podcast about X"   → AI podcast via NotebookLM
"Play some music"          → Spotify control
"Check my email"           → Email via himalaya
"What's trending?"         → 20 free trend sources
"Remind me at 3pm to..."   → Task with cron reminder

cd app
npm install

# Run as desktop app (dev mode)
npm run electron:dev

# Build distributable
npm run electron:build:mac    # → release/Claude Agent.dmg
npm run electron:build:win    # → release/Claude Agent Setup.exe
npm run electron:build:linux  # → release/Claude Agent.AppImage

cd app
npm install
npm run build        # Build optimized client
npm run start        # Start production server
# → http://localhost:3456

# tmux
tmux new -d -s agent 'cd app && npm run start'

# PM2
pm2 start "npm run start" --name claude-agent --cwd app

┌─────────────────────────────────────────────────────────────┐
│                     Session Start                           │
│  session-bootstrap.cjs → loads memory into context          │
└─────────────┬───────────────────────────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────────────────────────┐
│                   Message Arrives                           │
│  message-classifier.cjs → classifies intent, adds routing   │
│  hints (research? task? brainstorm? simple reply?)          │
└─────────────┬───────────────────────────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────────────────────────┐
│                  Claude Processes                           │
│  - Simple: answer directly in main context                  │
│  - Complex: delegate to skill or agent                      │
│  - Memory: auto-save facts, threads, tasks                  │
└──────┬──────────────────────────────────┬───────────────────┘
       │                                  │
       ▼                                  ▼
┌──────────────┐                ┌─────────────────────────────┐
│  Compaction  │                │       Session End            │
│  context-    │                │  session-farewell.cjs →      │
│  guardian →  │                │  archive session, update     │
│  preserve    │                │  thread state                │
│  active state│                └─────────────────────────────┘
└──────────────┘

curl -LsSf https://astral.sh/uv/install.sh | sh

# 1. Get Cloudflare credentials:
#    https://dash.cloudflare.com → Account ID (in sidebar)
#    https://dash.cloudflare.com/profile/api-tokens → Create Token
#    → Use "Edit Cloudflare Workers" template or custom with Browser Rendering permission

# 2. Add to your shell profile (~/.zshrc or ~/.bashrc):
export CF_ACCOUNT_ID="your-account-id"
export CF_API_TOKEN="your-api-token"

# 3. Reload shell
source ~/.zshrc

# 4. Verify: restart claude in the project dir, then try:
#    /deep-read https://some-javascript-heavy-site.com

# 1. One-time Google login (opens Chromium browser):
uvx notebooklm login
# → Sign in with your Google account
# → Session saved to ~/.notebooklm/

# 2. Verify: restart claude in the project dir, then try:
#    /podcast-maker "AI coding tools in 2026" en

/trend-scout               → Discover what's trending (20 sources)
       ↓
/content-creator <topic>   → Research + write + patent-score the post
       ↓
  [with-image flag]        → Generate NotebookLM image card
       ↓
  Ready to publish         → Scored draft in workspace/

Alternative paths:
/podcast-maker <topic>     → AI podcast (M4A) + optional video (MP4)
/deep-read <URL>           → Extract content from JS-heavy pages
content-publisher agent    → Full autonomous pipeline (trend → package)

# Preview what will be migrated (no changes made)
node scripts/migrate-openclaw.cjs --dry-run

# Run the migration
node scripts/migrate-openclaw.cjs

# Custom OpenClaw path
node scripts/migrate-openclaw.cjs --openclaw-dir /path/to/.openclaw

---
name: my-skill
description: What this skill does
allowed-tools:
  - Read
  - Write
  - WebSearch
model: haiku
user-invocable: true
when_to_use: When the user says "my trigger phrase"
---

# My Skill

Instructions for what the skill should do...

---
name: my-agent
description: What this agent specializes in
tools:
  - Read
  - Write
  - WebSearch
model: sonnet
---

# My Agent

Instructions for the agent's process, output format, and rules...

memory/user-profile.md
memory/active-threads.md
memory/pending-tasks.md