coze中OpenClaw入门教程：“龙虾”的概念和架构解析

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

步骤：

登录 Coze 平台
进入 Dashboard
找到 Workspace 设置
创建新的 Agent
配置 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 的核心概念和架构设计：

核心概念：

Agent = 智能体（员工）
1. 独立配置和记忆
2. 专业分工
Workspace = 工作空间（办公室）
1. 存放所有配置
2. 管理资源
Skills = 技能（专业能力）
1. 模块化扩展
2. 复用性强

关键要点：

OpenClaw 在 Coze 平台中提供强大的多 Agent 管理能力
通过配置文件实现声明式开发
Skills 系统提供无限扩展可能
必须在 Coze Dashboard 中操作，避免飞书对话操作

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