OpenClaw 评测：个人 AI Agent 的开源实践

┌─────────────────────────────────────────┐
│          Channel 层（渠道）              │
│  WebChat / Discord / WhatsApp / API     │
├─────────────────────────────────────────┤
│          Agent 层（核心）                │
│  LLM 推理 / 工具调用 / 决策循环           │
├─────────────────────────────────────────┤
│          Skill 层（能力）                │
│  邮件 / 搜索 / 文档 / 浏览器 / 自定义      │
├─────────────────────────────────────────┤
│          Memory 层（记忆）               │
│  MEMORY.md / Daily Notes / LCM 压缩      │
├─────────────────────────────────────────┤
│          Scheduler 层（调度）            │
│  Heartbeat / Cron / Event 触发           │
└─────────────────────────────────────────┘

skills/
├── email-skill/
│   ├── SKILL.md          # 技能指令
│   └── scripts/          # 辅助脚本
├── xbrowser/
│   ├── SKILL.md
│   └── scripts/
├── pdf/
│   └── SKILL.md
└── qclaw-cron-skill/
    └── SKILL.md

# Email Skill

## 触发条件
当用户说"发邮件"、"查看邮件"、"回复邮件"时触发

## 执行流程
1. 识别意图：发送 / 查看 / 回复
2. 路由到对应子技能
3. 执行并返回结果

## 配置
- SMTP 服务器配置在 env 中
- 邮箱账号在 TOOLS.md 中

<!-- AGENTS.md 中的 Skill 声明 -->
## Skills
- email-skill: 邮件收发
- xbrowser: 浏览器自动化
- pdf: PDF 处理

# 渠道配置示例
channels:
  webchat:
    enabled: true
  discord:
    enabled: true
    token: ${DISCORD_TOKEN}
    command_prefix: "!"
  whatsapp:
    enabled: false

<!-- MEMORY.md 示例 -->
## 用户偏好
- 偏好简洁的回答，不要废话
- 代码用 Python，不用 JS
- 时区 Asia/Shanghai

## 项目
- blog_opt: AI Agent 框架测评博客
  - 8篇文章，Hugo格式
  - 部署到 GitHub Pages

## 教训
- OpenClaw 的 Skill 文件不要超过 40000 字节，否则截断
- Cron 任务用 /reasoning off 减少 token 消耗

# 对话历史超长时
[旧消息] → LCM压缩 → sum_abc123 (摘要)
[新消息] → 保留在上下文中

# 需要回溯时
lcm_grep(pattern="数据库设计决策") → 找到 sum_abc123
lcm_expand_query(summaryIds=["sum_abc123"], prompt="为什么选了PostgreSQL？")
→ 返回详细的决策上下文

<!-- HEARTBEAT.md -->
## 心跳检查清单
- [ ] 检查邮箱有无重要未读
- [ ] 查看日历未来24小时事件
- [ ] GitHub 仓库有无新 issue/PR
- [ ] 天气预报（如用户可能外出）

// memory/heartbeat-state.json
{
  "lastChecks": {
    "email": 1719288000,
    "calendar": 1719284400,
    "github": 1719288000,
    "weather": 1719273600
  }
}

# Cron 任务示例
- name: "每日晨报"
  schedule: "0 8 * * *"
  prompt: "查看今天的日历事件和未读重要邮件，生成晨报"
  channel: webchat

- name: "周报提醒"
  schedule: "0 18 * * 5"
  prompt: "提醒用户写周报，并列出本周完成的主要事项"
  channel: webchat