核心概念

理解 OpenClaw 的核心概念，是用好它的关键。

🤖 Agent

Agent 是 OpenClaw 的核心实体，可以理解为一个"AI 助手"。

Agent 的组成

Agent = 模型 + 技能 + 记忆 + 性格

• 模型：AI 大脑（GPT-4、Claude 等）
• 技能：Agent 能做的事情
• 记忆：Agent 记住的信息
• 性格：Agent 的行为风格

Agent 配置

agents:
  my-agent:
    model: gpt-4
    skills:
      - weather
      - web-search
      - calendar
    memory:
      enabled: true
    personality:
      tone: friendly
      style: concise

🛠️ Skill

Skill 是 Agent 的能力单元，每个 Skill 提供特定功能。

Skill 类型

• 内置技能：OpenClaw 自带（天气、搜索、文件操作等）
• 社区技能：从 ClawHub 安装
• 自定义技能：自己开发

Skill 结构

my-skill/
├── SKILL.md      # 技能说明
├── skill.yaml    # 技能配置
├── tools/        # 工具定义
└── scripts/      # 脚本文件

安装技能

openclaw skill install <skill-name>

💬 Session

Session 是用户与 Agent 的交互会话。

Session 类型

• 主会话：用户直接与 Agent 对话
• 子会话：Agent 创建的子任务会话
• 临时会话：一次性任务会话

Session 上下文

Session = 消息历史 + 当前状态 + 临时数据

🧠 Memory

Memory 是 Agent 的记忆系统。

记忆层级

短期记忆（会话内）
    ↓
长期记忆（持久化）
    ↓
用户画像（跨会话）

记忆配置

memory:
  shortTerm:
    maxMessages: 50
  longTerm:
    enabled: true
    storage: sqlite
  userProfile:
    enabled: true

记忆文件

• MEMORY.md - 长期记忆
• memory/YYYY-MM-DD.md - 每日记录
• USER.md - 用户画像

📡 Channel

Channel 是 Agent 与用户交互的渠道。

支持的渠道

• 即时通讯：Telegram、Discord、微信、飞书、Slack
• Web：Web Chat、API
• 其他：IRC、Matrix

渠道配置

channels:
  telegram:
    enabled: true
    token: ${TELEGRAM_BOT_TOKEN}
  discord:
    enabled: true
    token: ${DISCORD_BOT_TOKEN}

🔄 Heartbeat

Heartbeat 是 Agent 的定时检查机制。

用途

• 定期检查邮件、日历
• 主动提醒用户
• 执行定时任务

配置

heartbeat:
  enabled: true
  interval: 10m
  prompt: "检查是否需要提醒用户"

🎭 Persona

Persona 定义 Agent 的性格和行为风格。

配置示例

persona:
  name: 小龙虾
  creature: AI 助手
  vibe: 友好、专业、简洁
  emoji: 🦞

📊 架构图

┌─────────────────────────────────────────┐
│              Channels                    │
│  Telegram │ Discord │ Web │ API │ ...   │
└─────────────────┬───────────────────────┘
                  │
┌─────────────────▼───────────────────────┐
│              Gateway                     │
│         (消息路由 & 会话管理)            │
└─────────────────┬───────────────────────┘
                  │
┌─────────────────▼───────────────────────┐
│              Agent                       │
│  ┌─────────┬─────────┬─────────┐        │
│  │  Model  │ Skills  │ Memory  │        │
│  └─────────┴─────────┴─────────┘        │
└─────────────────────────────────────────┘

下一步

• Skill 开发指南 - 开发你的第一个 Skill
• 多 Agent 协作 - 多 Agent 协作模式