🧠 核心概念

用人话讲清楚 OpenClaw 的那些术语，从此告别一脸懵逼

🎯 一句话总结

OpenClaw = Gateway（大脑）+ Agent（助理）+ Session（记忆）+ Channel（通讯）
你在 WhatsApp 发条消息 → Gateway 接收并转发给 Agent → Agent 思考并回复 → Gateway 把回复发回 WhatsApp。 Session 负责记住你们聊过什么，Channel 负责和各种聊天App打交道。

🦞

🦞 Gateway（网关）

整个系统的大脑和交通枢纽

🌍 现实类比

想象一下：Gateway 就像你们小区的物业中心

Gateway 是 OpenClaw 的核心，它是所有消息的集散地。所有聊天App的消息都先到这里，再由它决定怎么处理、发给谁。

主要职责：

📨 接收来自 WhatsApp/Telegram/Discord 的消息

🧠 决定消息该发给哪个 AI Agent 处理

💾 管理会话状态（谁在跟谁聊天）

🔐 权限验证（这个人有权限使用吗？）

📤 把 AI 的回复发回给对应的聊天App

💡 小贴士

一台电脑/服务器运行一个 Gateway 就够了
可以跑在本地电脑，也可以跑在云服务器
Web 控制台就是 Gateway 提供的网页界面

🤖

🤖 Agent（代理）

真正的 AI 大脑，负责思考和行动

🌍 现实类比

Agent 就像你的私人助理/秘书

Agent 是实际干活的 AI。你发消息问问题，它思考、查资料、写代码、然后给你答案。OpenClaw 默认使用 Pi Agent（Anthropic Claude）。

主要职责：

💭 理解你的问题并思考答案

🌐 使用浏览器工具搜索网页

💻 编写和执行代码

📁 读写文件

🔧 调用各种工具完成任务

支持的模型：

Anthropic Claude (Opus) 推荐

最聪明，推荐

Anthropic Claude (Sonnet)

性价比高

OpenAI GPT-4

也可用

💡 小贴士

Agent 本身可以跑在远程（RPC模式），也可以本地运行
Pi 是 OpenClaw 默认且唯一支持的 Agent 类型
长上下文模型更适合复杂任务

💬

💬 Session（会话）

保持对话的连续性，让 AI 记得你们聊过什么

🌍 现实类比

Session 就像你和朋友的聊天记录

Session 保存了你和 AI 的对话历史。这样 AI 就能记住'之前我说了什么'、'我们在讨论什么话题'，保持对话的连贯性。

类型：

main - 私聊默认会话，所有直接消息都在这里

群组会话 - 每个群组有独立的 Session，群成员共享上下文

工作区会话 - 不同工作区完全隔离，数据不互通

💡 小贴士

长期对话会占用大量 token，可能触发上下文限制
可以开启自动清理，只保留最近 N 条消息
不同 Session 完全隔离，A Session 不知道 B Session 的事

📱

📱 Channel（频道）

连接各种聊天平台的桥梁

🌍 现实类比

Channel 就像不同快递公司的收件点

Channel 是 Gateway 和外部聊天平台（WhatsApp、Telegram 等）的连接层。它负责把平台的消息格式转换成 OpenClaw 能理解的格式，反之亦然。

支持的频道：

💬

通过 WhatsApp Web 协议连接

✈️

Bot API，最稳定

🎮

Discord

Bot 模式，支持 Slash 命令

💼

Slack

工作团队首选

🍎

iMessage

Apple 设备专属

🔐

Signal

注重隐私

🌐

WebChat

浏览器直接聊，无需配置

💡 小贴士

一个 Gateway 可以同时接入多个 Channel
不同 Channel 的消息最终会汇聚到同一个 Gateway
可以设置 allowFrom 白名单，只允许特定用户

🛠️

🛠️ Skill（技能）

给 AI 增加超能力的插件系统

🌍 现实类比

Skill 就像给手机安装 App

Skill 是 OpenClaw 的扩展机制。通过安装不同的 Skill，你可以让 AI 获得新能力：查天气、管理待办、操作 GitHub、发送邮件...

类型：

内置技能 - OpenClaw 自带的，如 browser、node、canvas

托管技能 - 从 npm 安装的官方/社区技能

工作区技能 - 你自己开发的本地技能

常用技能示例：

🌐 browser - 控制浏览器搜索网页

📷 node - 调用手机摄像头拍照

🎨 canvas - 可视化交互界面

⏰ cron - 定时任务调度

📧 email - 发送邮件

💡 小贴士

技能可以在 ClawHub 技能市场发现
安装技能：openclaw skills install xxx
技能有权限控制，需要用户授权才能使用

📁

📁 Workspace（工作区）

隔离不同项目或用途的数据

🌍 现实类比

Workspace 就像电脑上的不同用户账户

Workspace 提供完全隔离的环境。你可以为工作创建一个 Workspace，为个人生活创建另一个，两者数据、配置、会话完全独立。

💡 小贴士

切换工作区：openclaw workspace switch xxx
默认工作区是 'default'
工作区之间数据完全隔离，适合多租户场景

🔄 完整数据流转：一条消息的一生

看看当你发了一条消息后，OpenClaw 内部是怎么处理的：

你 → WhatsApp 发送消息

'帮我查一下今天的天气'

WhatsApp → Gateway 转发消息

Channel 层转换格式

Gateway → Session 查找/创建会话

确定消息上下文

Gateway → Agent 发送请求

携带完整对话历史

Agent → 工具调用浏览器

搜索天气网站

工具 → Agent 返回结果

获取天气数据

Agent → Gateway 生成回复

'今天北京晴，25°C'

Gateway → WhatsApp 发送回复

转换回 WhatsApp 格式

WhatsApp → 你收到回复

看到 AI 的消息

🎓 概念串烧

Gateway 是物业中心， Channel 是各家快递公司， Agent 是跑腿小哥， Session 是你们的聊天记录， Skill 是小哥的装备（电动车、手机、工具箱）， Workspace 是不同的片区（朝阳区、海淀区）。

你在淘宝下单（发消息）→ 菜鸟驿站接收（Channel）→ 物业中心分拣（Gateway）→ 分配给朝阳区的跑腿小哥（Workspace + Agent）→ 小哥用电动车（Skill）送货上门 → 过程中记得住你的地址和偏好（Session）。

←

🚀 快速开始

频道配置 📱

→