

> **摘要**：深入理解 OpenClaw 的三大核心概念，掌握 Session 会话管理、Agent 智能体架构、Skill 技能系统，为高级开发打下坚实基础。

---

## 一、OpenClaw 架构概览

### 1.1 整体架构设计

OpenClaw 采用分层架构设计，从用户交互到 AI 模型调用，每一层都有明确的职责边界。理解这个架构是掌握 OpenClaw 的关键第一步。

![image.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/74ae848d396a9890f62c55925a49d2d0.png)

### 1.2 三大核心概念

| 概念 | 定义 | 职责 | 生命周期 |
|------|------|------|----------|
| **Session** | 会话 | 管理用户与 AI 的对话上下文 | 对话期间 |
| **Agent** | 智能体 | 执行任务、调用工具、做出决策 | 持续运行 |
| **Skill** | 技能 | 封装特定能力的可复用模块 | 按需加载 |

---

## 二、Session 会话管理

### 2.1 什么是 Session？

**Session（会话）** 是 OpenClaw 中管理对话上下文的核心单元。每个 Session 包含对话历史、用户信息、会话状态和记忆数据。

### 2.2 Session 生命周期

![image.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/a91b8c7108d9fa5b72da2a9234e127dd.png)

### 2.3 Session 类型

| 类型 | 说明 | 示例 |
|------|------|------|
| **DM（直接消息）** | 一对一私聊 | 用户与 AI 的私人对话 |
| **Group（群聊）** | 多人群组对话 | Discord 频道、Telegram 群组 |
| **Thread（线程）** | 独立对话线程 | Discord 帖子频道 |

### 2.4 Session 配置

```json
{
  "sessions": {
    "maxContextTokens": 4000,
    "autoResetThreshold": 0.8,
    "timeout": 3600,
    "memory": {
      "enabled": true,
      "type": "semantic"
    }
  }
}
```

### 2.5 Session 常用操作

```bash
# 查看所有会话
openclaw sessions list

# 查看特定会话详情
openclaw sessions show <session-id>

# 重置会话（清除上下文）
openclaw sessions reset <session-id>

# 删除会话
openclaw sessions delete <session-id>
```

---

## 三、Agent 智能体

### 3.1 什么是 Agent？

**Agent（智能体）** 是 OpenClaw 的"大脑"，负责理解用户意图、规划执行步骤、调用工具、生成响应。

### 3.2 Agent 架构
![image.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/01146e409e91377e46fc0c4ea8cc28ed.png)

### 3.3 Agent 类型

| 类型 | 说明 | 使用场景 |
|------|------|----------|
| **Main Agent** | 主代理 | 处理用户直接对话 |
| **Subagent** | 子代理 | 执行特定子任务 |
| **ACP Agent** | 代码代理 | 代码编写、文件操作 |

### 3.4 Agent 配置

```json
{
  "agents": {
    "main": {
      "model": "gpt-4o-mini",
      "thinking": "medium",
      "maxTokens": 4000
    }
  }
}
```

### 3.5 Thinking 模式

| 模式 | 说明 | 适用场景 |
|------|------|----------|
| `off` | 无思考过程 | 简单问答 |
| `low` | 低深度思考 | 常规任务 |
| `medium` | 中等深度 | 复杂任务 |
| `high` | 深度思考 | 困难问题 |

---

## 四、Skill 技能系统

### 4.1 什么是 Skill？

**Skill（技能）** 是 OpenClaw 的能力扩展单元，封装了特定领域的知识和工具。

### 4.2 Skill 目录结构

```
skills/
└── my-skill/
    ├── SKILL.md          # 技能说明（必需）
    ├── scripts/          # 脚本文件
    └── references/       # 参考文档
```

### 4.3 Skill 触发机制

![image.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/66c67e22d70a3b61a42c6f23539cca87.png)

### 4.4 Skill 类型

| 类型 | 说明 | 示例 |
|------|------|------|
| **内置技能** | OpenClaw 自带 | 文件操作、网络请求 |
| **自定义技能** | 用户开发 | 业务特定功能 |
| **ClawHub 技能** | 社区共享 | csdn-article、weather |

### 4.5 安装和管理技能

```bash
# 从 ClawHub 安装技能
npx clawhub@latest install <skill-name>

# 查看已安装技能
openclaw skills list
```

---

## 五、三者关系

### 5.1 协作流程

![image.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/88e9ccf3435d48205206c7384256e71f.png)

### 5.2 数据流向

| 数据 | 流向 |
|------|------|
| 用户消息 | Session → Agent |
| 工具调用 | Agent → Skill |
| 执行结果 | Skill → Agent |
| AI 响应 | Agent → Session |

---

## 六、实战案例

### 6.1 创建自定义 Skill

```bash
# 创建技能目录
mkdir -p ~/.openclaw/workspace/skills/hello-world

# 创建技能说明文件
cat > ~/.openclaw/workspace/skills/hello-world/SKILL.md << 'EOF'
---
name: hello-world
description: "简单的问候技能。触发词：你好、hello"
---

# Hello World 技能

当用户打招呼时，友好地回应。

## 功能
- 识别问候语
- 返回友好回复
EOF
```

### 6.2 配置 Session 记忆

```json
{
  "sessions": {
    "memory": {
      "enabled": true,
      "longTerm": {
        "file": "MEMORY.md"
      },
      "daily": {
        "dir": "memory"
      }
    }
  }
}
```

---

## 七、常见问题

### Q1: Session 和 Agent 有什么区别？

**Session** 管理对话上下文，**Agent** 处理业务逻辑。Session 是"容器"，Agent 是"处理器"。

### Q2: 如何选择 Thinking 模式？

| 场景 | 推荐模式 |
|------|----------|
| 简单问答 | `off` |
| 日常任务 | `low` |
| 复杂分析 | `medium` |
| 困难问题 | `high` |

### Q3: Skill 和 Tool 有什么区别？

**Skill** 是完整的技能包，包含说明、脚本、参考文档。**Tool** 是单个工具函数，是 Skill 的组成部分。

---

## 八、总结

### 核心要点

| 概念 | 核心职责 | 关键配置 |
|------|----------|----------|
| **Session** | 对话上下文管理 | `maxContextTokens`, `timeout` |
| **Agent** | 任务执行与决策 | `model`, `thinking` |
| **Skill** | 能力扩展 | `SKILL.md`, `scripts/` |

### 学习路径

![image.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/2a466d00f55f48cd0175a7bc2167e2ff.png)

---

**参考资料**：
- OpenClaw 官方文档：https://docs.openclaw.ai
- ClawHub 技能市场：https://clawhub.com
- GitHub 仓库：https://github.com/openclaw/openclaw


摘要：深入理解 OpenClaw 的三大核心概念，掌握 Session 会话管理、Agent 智能体架构、Skill 技能系统，为高级开发打下坚实基础。

OpenClaw 核心概念详解：Session、Agent、Skill

项目经理

人工智能

架构设计

开发工具

OpenClaw架构解析：Session管理对话上下文，Agent负责任务执行与决策，Skill实现能力扩展。掌握maxContextTokens配置、Thinking模式选择及Skill开发，快速构建智能对话系统。官方文档与ClawHub提供完整学习资源。

数据流

智能体

容器

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw 核心概念详解：Session、Agent、Skill-腾讯云开发者社区-腾讯云

OpenClaw 核心概念详解：Session、Agent、Skill

OpenClaw 核心概念详解：Session、Agent、Skill

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐