OpenClaw 入门教程（一）：核心概念与架构解析

OpenClaw 是一个 AI 智能体开发框架，在 Coze 平台中提供强大的 Agent 管理能力。本文将从零开始介绍 OpenClaw 的核心概念、架构设计以及基础使用方法。

---

一、OpenClaw 概述

1.1 什么是 OpenClaw？

OpenClaw 是一个开源的 AI 智能体（Agent）开发框架，旨在简化多 Agent 系统的构建和管理。在 Coze 平台中，OpenClaw 被集成为 OpenCloud 功能，提供可视化的 Agent 管理界面。

核心特性：

• 多 Agent 管理：支持创建和切换多个独立的 Agent

• 持久化记忆：每个 Agent 拥有独立的记忆系统

• 可扩展架构：通过 Skills 系统扩展 Agent 能力

• 工具集成：内置丰富的工具集，支持自定义工具

• 配置驱动：基于配置文件的声明式开发

1.2 OpenClaw 与传统聊天机器人的区别

特性	传统聊天机器人	OpenClaw Agent
Agent 数量	单一实例	多实例并行
配置管理	集中式配置	分布式配置
记忆机制	会话级记忆	跨会话持久化记忆
扩展性	有限	通过 Skills 无限扩展
协作能力	无	Agent 间可协作
个性化程度	统一人设	独立个性和身份

---

二、OpenClaw 核心概念

2.1 Agent（智能体）

Agent 是 OpenClaw 的核心执行单元，可以理解为"数字员工"。每个 Agent 都是一个独立的 AI 实体，拥有以下组件：

1. 身份（IDENTITY.md）

• 定义 Agent 的名称、角色和基本属性

• 设定 Agent 的专业领域和能力范围

2. 职责（AGENTS.md）

• 定义 Agent 需要完成的任务

• 设定工作流程和决策逻辑

3. 记忆（MEMORY.md）

• 长期存储用户偏好

• 记住历史交互

• 积累专业知识

4. 个性（SOUL.md）

• 定义 Agent 的性格特点

• 设定沟通风格

• 塑造独特的"人格"

5. 工具（TOOLS.md）

• 配置 Agent 可使用的工具

• 定义工具调用权限

• 管理工具版本

2.2 Workspace（工作空间）

Workspace 是 Agent 赖以生存的环境，存放所有配置和资源文件。

目录结构：

workspace-coze-helper/
├── .openclaw/          # 系统配置目录
├── agents/             # Agent 目录
│   └── agent-name/    # 单个 Agent 目录
│       ├── IDENTITY.md
│       ├── AGENTS.md
│       ├── MEMORY.md
│       ├── SOUL.md
│       └── TOOLS.md
├── skills/            # 技能目录
│   └── skill-name/    # 单个技能目录
│       ├── SKILL.md
│       ├── scripts/
│       └── references/
├── AGENTS.md          # 全局 Agent 清单
├── IDENTITY.md        # 当前 Agent 身份
├── MEMORY.md          # 全局记忆
├── SOUL.md            # 全局个性设定
└── TOOLS.md           # 全局工具配置

2.3 Skills（技能）

Skills 是 Agent 的能力扩展包，采用模块化设计。

Skill 组成：

• SKILL.md：技能定义文件，描述技能的功能和使用方法

• scripts/：技能执行脚本，支持多种编程语言

• references/：引用文件目录，存放配置和资源

常见 Skills：

• 文件读写 Skill

• 网络搜索 Skill

• 飞书操作 Skill

• 图像处理 Skill

---

三、OpenClaw 在 Coze 平台中的位置

3.1 Coze 平台架构

Coze 平台提供完整的 AI 应用开发工具箱，包含以下核心模块：

1. Bot 构建

• 可视化对话设计

• 意图识别配置

• 对话流程管理

2. 工作流编排

• 节点式流程设计

• 条件分支处理

• 循环和并行执行

3. 插件管理

• 第三方服务集成

• API 连接器

• 数据转换工具

4. OpenClaw Agent 管理

• 多 Agent 创建和配置

• Workspace 环境管理

• 配置文件编辑

• Agent 切换和协作

3.2 OpenClaw 环境配置

在 Coze 平台中使用 OpenClaw，需要通过 Coze Dashboard 进行操作：

重要提示：

⚠️ 不要在飞书对话中创建/切换 Agent，这会导致服务崩溃（沙箱限制）

✅ 正确方式：在 Coze Dashboard 界面操作

---

四、快速开始

4.1 创建第一个 Agent

步骤：

1. 登录 Coze 平台

2. 进入 Dashboard

3. 找到 Workspace 设置

4. 创建新的 Agent

5. 配置 Agent 身份和能力

4.2 配置文件说明

AGENTS.md

# Agent 清单

## agent-name
- 角色：助手
- 职责：回答问题
- 能力：对话、搜索

IDENTITY.md

# Agent 身份

- 名称：助手
- 角色：AI 助手
- 专业领域：通用知识

MEMORY.md

# 记忆存储

## 用户偏好
- 暂无

## 历史记录
- 暂无

SOUL.md

# 个性设定

- 性格：友好、专业
- 沟通风格：简洁明了
- 语气：亲切但不过度热情

TOOLS.md

# 工具配置

## 可用工具
- 搜索工具
- 文件读写

---

五、学习路径建议

第一阶段：基础概念（本课）

• 理解 Agent、Workspace、Skills

• 了解 OpenClaw 的定位

• 掌握配置文件作用

第二阶段：Agent 管理

• 创建第一个 Agent

• 配置 Agent 身份

• 切换不同 Agent

• 理解 Agent 组件

第三阶段：Workspace 结构

• 目录结构详解

• 配置文件说明

• 文件组织方式

第四阶段：Skills 开发

• 创建第一个 Skill

• SKILL.md 配置

• 添加自定义能力

• 脚本编写基础

第五阶段：实战案例

• 构建个人助理

• 构建内容创作助手

• 构建数据分析助手

---

六、总结

本文介绍了 OpenClaw 的核心概念和架构设计：

核心概念：

1. Agent = 智能体（员工）

   1. 独立配置和记忆

   2. 专业分工

2. Workspace = 工作空间（办公室）

   1. 存放所有配置

   2. 管理资源

3. Skills = 技能（专业能力）

   1. 模块化扩展

   2. 复用性强

关键要点：

• OpenClaw 在 Coze 平台中提供强大的多 Agent 管理能力

• 通过配置文件实现声明式开发

• Skills 系统提供无限扩展可能

• 必须在 Coze Dashboard 中操作，避免飞书对话操作

---

教程提供方：觅合可及 coze工作流学习分享