Claude Agent

克劳德代理人

将Claude Code转变为具有自主记忆、多渠道支持和智能任务委派的持久个人助理。

Claude Agent已准备就绪 克劳德代码 将克劳德转变为长期个人助理的项目。它从多个渠道（Telegram、Discord、webhooks、终端）接收消息，记住会话中的上下文，并将复杂任务委托给专业代理——所有这些都在Claude Code的原生架构中。

特性

建筑

模块化服务器架构的灵感来自 克劳德代码的内部服务层模式。

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

先决条件

• Node.js >= 18
• 克劳德代码CLI --对于方法1和3。 在此处安装

三种使用方法

______________________________________________________________________

方法1:CLI（终端）

# Start Claude Code in the project directory
claude

# First time? Run guided setup
/setup

/setup 将：

• 检测您的操作系统和已安装的CLI工具
• 配置您的个人资料（姓名、时区、语言）
• 显示按类别分组的可用技能
• 设置预定的例行程序（记忆巩固、每日简报）

设置后，只需自然地说话：

• “台北的天气怎么样？”
• “播放一些音乐”
• “提醒我下午3点给牙医打电话”
• “趋势是什么？”

______________________________________________________________________

方法2：Web UI（浏览器）

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

打开 http://localhost:3456 在您的浏览器中。

共12页：

______________________________________________________________________

方法3：电报/Discord

选项A：通过克劳德代码通道（本地）

# 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

选项B：通过Web UI

1. 启动Web UI： cd app && npm run dev
2. 首选 频道 页
3. 点击“添加Telegram Bot”或“添加Discord Bot”
4. 粘贴您的机器人令牌→ Save → 启用
5. 来自Telegram/Discord的消息通过具有完全技能访问权限的代理传递

如何获取机器人代币：

• 电报：打开@BotFather→ /newbot → 复制令牌
• Discord 的中文翻译是“不和谐”或“纷争”。: https://discord.com/developers/applications → 新应用→ Bot选项卡→ 重置令牌→ 复制令牌。启用“消息内容意图”。通过OAuth2 URL生成器邀请到您的服务器（范围： bot，权限：发送消息，读取消息历史记录）

______________________________________________________________________

安装后

你的代理人已经准备好了。您可以这样做：

"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

所有49种技能都对自然语言有反应。不需要记住命令。

方法4：桌面应用程序（macOS/Windows/Linux）

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

桌面应用程序将web UI+服务器捆绑到一个本地应用程序中。无需浏览器。

生产服务器（无头）

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│                └─────────────────────────────┘
└──────────────┘

上下文管理（Claude代码模式）

从移植的会话质量功能 克劳德代码的内部架构：

任务路由

存储器系统

Claude Agent通过两种互补的机制自主管理自己的内存：

内联标记 --模型可以显式输出 [SAVE_MEMORY] key: value 在对话过程中（从用户输出中删除，在服务器端处理）。

背景提取 --每5圈，一个由俳句驱动的后台进程就会分析最近的消息，并提取4类结构化记忆：

内存文件 （自动管理）：

技能参考（49项技能）

核心助理

内容与研究

生产力

消息传递

智能家居与媒体

系统和安全

迁移

代理商参考

代理将详细输出保存到 workspace/ 并对主要内容进行简洁的总结。

MCP集成

Claude Agent预装了4台MCP服务器，可以解锁高级功能。

先决条件：安装 uv （Python包运行器，需要 uvx):

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

第1层：零授权（立即生效）

无需设置，这些都是开箱即用的。

第2级：需要证书（可选）

设置cf浏览器（无头Chrome）

# 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

设置记事本（AI播客、幻灯片、研究）

# 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    → Research + write + patent-score the post
       ↓
  [with-image flag]        → Generate NotebookLM image card
       ↓
  Ready to publish         → Scored draft in workspace/

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

新技能（MCP驱动）

新代理（MCP供电）

优雅降级

所有MCP供电功能都会正常降级：

• 无趋势脉冲: /trend-scout 退回到WebSearch
• 无cf浏览器: /content-creator 和 /deep-read 改用WebFetch
• 无笔记本：跳过图像卡和播客，显示设置说明
• 根本没有MCP：核心技能+代理无需任何MCP服务器即可工作

从OpenClaw迁移

来自 开爪？Claude Agent包括一键迁移工具。

# 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

迁移的内容：

或者以交互方式使用该技能： /migrate-openclaw

定制

添加新技能

在以下位置创建文件 .claude/skills//SKILL.md:

---
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...

然后在中添加路由条目 CLAUDE.md 在任务委派表下。

添加新代理

在以下位置创建文件 .claude/agents/.md:

---
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...

修改挂钩

钩子在里面 .claude/hooks/ 并配置在 .claude/settings.json每个钩子：

• 在stdin上接收带有会话上下文的JSON
• 在stdout上输出JSON，并为Claude提供指令
• 有一个硬超时以防止阻塞

调整内存策略

编辑 .claude/rules/memory-policy.md 更改保存内容、保存频率和归档规则。

文件所有权

隐私声明

内存模板文件(memory/user-profile.md, memory/active-threads.md, memory/pending-tasks.md)在git中使用空占位符进行跟踪。当克劳德用你的个人数据填充它们时， 不要将这些文件推送到公共存储库。如果你分叉这个项目，请将这些添加到你的 .gitignore:

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

运行时文件(memory/archive/, workspace/, memory/learned-today.md, memory/contacts.md)已经被忽视了。

需求

• 克劳德代码CLI --推荐最新版本
• Node.js >=18--用于挂钩（仅使用内置 fs 和 path 模块）
• 紫外线 （可选）--适用于MCP服务器。安装： curl -LsSf https://astral.sh/uv/install.sh | sh
• 没有其他npm依赖项

许可证

麻省理工学院

学分

建造于 克劳德世界 --Claude Code高级使用社区。