阶段一：入门 | 预计用时：30分钟
学习目标
完成本课后，你将能够：
- 用自己的话描述OpenClaw是什么
- 列举至少3个支持的聊天平台
- 画出简单的架构图
- 说明OpenClaw的核心价值
理论知识
1.1 什么是OpenClaw
定义： OpenClaw是一个自托管的AI Agent网关，连接多个聊天应用到AI助手。
关键词解释：
| 关键词 | 含义 |
|---|---|
| 自托管 | 运行在你自己的服务器上，数据自主可控 |
| AI Agent | 能够执行任务、使用工具的AI助手 |
| 网关 | 连接多个平台的中间层 |
1.2 为什么需要OpenClaw
问题场景：
你想要：
- 在Telegram上和AI对话
- 在Discord上和AI对话
- 在WhatsApp上和AI对话
传统方案：
- 每个平台单独开发一个Bot
- 每个Bot单独管理会话
- 每个Bot单独配置AI模型
问题：
- 重复开发
- 维护困难
- 体验不一致
OpenClaw方案：
┌─────────────────────────────────────────────────────┐
│ OpenClaw │
│ │
│ Telegram ──┐ │
│ │ │
│ Discord ───┼──→ Gateway ──→ Agent ──→ AI模型 │
│ │ │
│ WhatsApp ──┘ │
│ │
│ 统一管理：会话、记忆、工具、安全 │
└─────────────────────────────────────────────────────┘
1.3 核心能力
| 能力 | 说明 | 价值 |
|---|---|---|
| 多通道支持 | WhatsApp、Telegram、Discord、iMessage、Teams、Slack | 一个网关连接所有平台 |
| AI Agent集成 | 支持OpenAI、Claude、DeepSeek、Ollama等 | 自由选择模型 |
| 会话管理 | 持久化对话上下文 | 对话不丢失 |
| 工具调用 | Agent可执行工具操作 | AI能做实际事情 |
| 记忆系统 | 长期记忆存储 | Agent记得你 |
| 安全机制 | Token认证、访问控制 | 数据安全 |
1.4 架构概览
┌─────────────────────────────────────────────────────────────┐
│ OpenClaw 架构 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 用户 │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ Channel │ 消息通道 │
│ │ (Telegram) │ 接收/发送消息 │
│ │ (Discord) │ │
│ │ (WhatsApp) │ │
│ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ Gateway │ 核心网关 │
│ │ │ 路由、认证、会话管理 │
│ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ Agent │────→│ Session │ 会话 │
│ │ (AI) │ └─────────────┘ │
│ └──────┬──────┘ │
│ │ │
│ ├──────────→ ┌─────────────┐ │
│ │ │ Memory │ 记忆 │
│ │ └─────────────┘ │
│ │ │
│ └──────────→ ┌─────────────┐ │
│ │ Tools │ 工具 │
│ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
1.5 核心概念速览
| 概念 | 类比 | 说明 |
|---|---|---|
| Gateway | 电话交换机 | 接收所有连接，路由消息 |
| Channel | 电话线路 | 连接不同平台（Telegram、Discord等） |
| Agent | 客服人员 | 实际处理消息的AI |
| Session | 通话记录 | 保留对话上下文 |
| Memory | 客户档案 | 长期记忆用户信息 |
| Tools | 办公工具 | AI可以使用的工具（读文件、执行命令等） |
验证步骤
验证1：访问官方资源
| 资源 | 地址 | 任务 | 预期结果 |
|---|---|---|---|
| 官方文档 | docs.openclaw.ai | 浏览首页 | 看到文档首页 |
| GitHub | github.com/openclaw/op… | 查看README | 了解项目介绍 |
| Discord | discord.com/invite/claw… | 加入社区 | 进入Discord频道 |
| ClawHub | clawhub.com | 浏览Skills | 查看可用的技能 |
验证2：理解架构
任务： 画出OpenClaw架构图
要求：
- 包含以下组件：Gateway、Channel、Agent、Session、Memory、Tools
- 用箭头表示数据流向
- 标注各组件的作用
参考答案： 见上文1.4节
实战任务
任务1：浏览官方文档
# 打开官方文档
open https://docs.openclaw.ai
# 或使用命令行打开
openclaw docs
完成标准：
- 找到"Getting Started"页面
- 浏览"Concepts"目录下的文档
- 了解至少3个核心概念
任务2：查看GitHub仓库
# 克隆仓库（可选，用于后续学习）
git clone https://github.com/openclaw/openclaw
cd openclaw
# 查看目录结构
ls -la
完成标准：
- 找到源码目录结构
- 查看
src/目录下的核心模块 - Star项目以便后续关注
任务3：加入社区
- 打开 discord.com/invite/claw…
- 加入Discord服务器
- 浏览
#general和#help频道
完成标准：
- 成功加入Discord
- 了解社区活跃度
- 知道去哪里提问
课后思考
思考题
-
OpenClaw与直接使用ChatGPT有什么区别？
点击查看参考答案
对比项 ChatGPT OpenClaw 访问方式 网页/App 多平台（Telegram、Discord等） 数据控制 存储在OpenAI 自托管，数据自主 扩展性 有限 可开发插件、工具 多用户 单用户 多用户、多Agent 记忆 有限 完整记忆系统 工具调用 插件有限 完全自定义 -
为什么需要"网关"这个概念？
点击查看参考答案
网关解决了以下问题：
- 统一接入：一个入口管理所有平台
- 路由分发：将消息路由到正确的Agent
- 安全控制：统一的认证和授权
- 会话管理：跨平台一致的会话体验
- 扩展性：新增平台只需新增Channel，无需改动核心
-
OpenClaw适合什么场景？
点击查看参考答案
适合：
- 个人AI助手（多平台接入）
- 企业客服机器人
- 团队协作AI助手
- 自动化工作流
- AI Agent开发研究
不适合：
- 只需要简单聊天（直接用ChatGPT更简单）
- 不想自己部署维护
- 对数据隐私没有特别要求
扩展阅读
| 资源 | 说明 |
|---|---|
| OpenClaw架构文档 | 官方架构说明 |
| GitHub README | 项目介绍 |
| Discord社区 | 问答和讨论 |
课时：第1课 / 共29课 阶段：入门 / 共5阶段
