OpenClaw 入门教程（4）：代理、通道与工作区详解
OpenClaw 入门教程（4）：代理、通道与工作区详解 OpenClaw 核心概念详解（四）：代理、通道与工作区 创建日期：2026-04-21作者：小龙 🐉版本：v1.0适用版本：OpenClaw 2026.4.14+
📖 概述 本文详细解释 OpenClaw 的三个核心概念：代理（Agent）、通道（Channel）和工作区（Workspace），以及它们之间的关系。
🤖 1. 代理（Agent） 什么是代理？ 代理 = AI 智能体的运行实例 在 OpenClaw 中，"代理"和"智能体"是同一个概念的不同表述： Agent = 代理（技术术语） 智能体 = Agent（中文翻译） 小龙 = 你的 AI 智能体的名字（人格化称呼）
代理配置文件 代理的核心配置存储在 ~/.openclaw/agents/<name>/ 目录下： ~/.openclaw/agents/main/ ├── SOUL.md ← 性格定义 ├── IDENTITY.md ← 身份信息 ├── MEMORY.md ← 长期记忆 └── sessions.json ← 会话历史
核心文件说明
文件
作用
说明
AGENTS.md
代理配置
会话启动规则、记忆读取
SOUL.md
人格定义
AI 的性格、语气、价值观
TOOLS.md
工具配置
本地环境配置（摄像头/SSH 等）
IDENTITY.md
身份信息
AI 的名字、角色
USER.md
用户信息
你的个人信息和偏好
HEARTBEAT.md
心跳任务
定时任务配置
MEMORY.md
长期记忆
核心记忆存储
多代理场景 ~/.openclaw/agents/ ├── main/ ← 主代理（小龙） │ ├── SOUL.md │ ├── MEMORY.md │ └── workspace → ../../workspace/ │ ├── dev/ ← 开发代理（小发） │ ├── SOUL.md │ ├── MEMORY.md │ └── workspace → ../../workspace-dev/ │ └── ops/ ← 运维代理（小维） ├── SOUL.md ├── MEMORY.md └── workspace → ../../workspace-ops/
每个代理有独立的： ✅ 性格定义（SOUL.md） ✅ 记忆系统（MEMORY.md） ✅ 工作区（workspace） 所有代理共享： ✅ 通道配置（openclaw.json） ✅ 插件配置 ✅ API Keys
📡 2. 通道（Channel） 什么是通道？ 通道 = 消息通道，就是 AI 和你沟通的方式。 每个聊天软件就是一个"通道"： WhatsApp → WhatsApp 通道 Telegram → Telegram 通道 QQ → QQ 通道 飞书 → 飞书通道 微信 → 微信通道 钉钉 → 钉钉通道
通道配置位置 重要：通道配置存储在 OpenClaw 全局配置中，不在 workspace 里！ ~/.openclaw/openclaw.json ├─ channels.qqbot ├─ channels.feishu ├─ channels.wecom ├─ channels.dingtalk └─ channels.whatsapp
配置示例 { "channels": { "qqbot": { "enabled": true, "target": "qqbot:c2c:2374A81FBC14BD45333517A5FED72829" }, "feishu": { "enabled": true, "groupPolicy": "allowlist" }, "wecom": { "enabled": false }, "dingtalk": { "enabled": false } } }
添加新通道的流程 步骤 1：配置通道
启用钉钉通道
openclaw config set channels.dingtalk.enabled true --json
配置钉钉凭证
openclaw config set channels.dingtalk.appId "dingxxx" --json openclaw config set channels.dingtalk.appSecret "yyy" --json
步骤 2：重启 Gateway openclaw gateway restart
步骤 3：验证配置 openclaw status
输出示例： Channel │ Enabled │ State ────────────────┼─────────────── QQ Bot │ ON │ OK Feishu │ ON │ OK DingTalk │ ON │ OK ← 新增 WeChat │ OFF │ SETUP
通道与代理的关系 全局通道配置（openclaw.json） ↓ ├── QQ Bot ──┐ ├── 飞书 │ ├── 钉钉 ├──→ 所有代理共享 └── 微信 ──┘
代理配置（agents/main/） ↓ └─ 使用这些通道发送/接收消息
关键点： ✅ 通道配置是全局的（所有代理共享） ✅ workspace 里不存储通道配置 ✅ workspace 里存储的是代理的记忆和文档
🗂️ 3. 工作区（Workspace） 什么是工作区？ 工作区 = 代理的工作空间，存储文档、记忆、脚本等文件。
工作区内容 ~/.openclaw/workspace/ ├── AGENTS.md ← 代理启动规则 ├── SOUL.md ← 性格定义 ├── TOOLS.md ← 工具配置 ├── IDENTITY.md ← 身份信息 ├── USER.md ← 用户信息 ├── HEARTBEAT.md ← 心跳任务 ├── MEMORY.md ← 长期记忆 ├── memory/ ← 每日记忆 │ ├── 2026-04-21.md │ └── ... ├── docs/ ← 项目文档 │ ├── AiToMoney 甘特图使用指南.md │ └── ... └── scripts/ ← 定时任务脚本 ├── backup-feishu.sh └── ...
workspace 存储什么？
文件/文件夹
用途
是否共享
AGENTS.md
代理启动规则
否（每个代理独立）
SOUL.md
性格定义
否
TOOLS.md
本地工具配置
否
IDENTITY.md
身份信息
否
USER.md
用户信息
否
HEARTBEAT.md
心跳任务
否
MEMORY.md
长期记忆
否
memory/
每日记忆
否
docs/
项目文档
否
scripts/
定时任务脚本
否
workspace 不存储什么
内容
存储位置
通道配置
~/.openclaw/openclaw.json
通道凭证
~/.openclaw/openclaw.json
插件配置
~/.openclaw/openclaw.json
API Keys
~/.openclaw/openclaw.json
会话历史
~/.openclaw/agents/main/sessions/
📊 4. 两种工作区的区别 为什么会有两个路径？ 原因：OpenClaw 是用不同用户身份安装的。
场景 1：admin 用户安装（你的情况）
当前用户
whoami
输出：admin
OpenClaw 安装位置
/home/admin/.openclaw/
工作区位置
/home/admin/.openclaw/workspace/
场景 2：root 用户安装
当前用户
whoami
输出：root
OpenClaw 安装位置
/root/.openclaw/
工作区位置
/root/.openclaw/workspace/
本质区别
维度
/home/admin/.openclaw/workspace
/root/.openclaw/workspace
用户
admin 用户
root 用户
用途
你的日常工作区
系统级工作区
权限
admin 用户可读写
需要 root 权限
隔离性
用户级隔离
系统级 建议：只用 /home/admin/.openclaw/workspace，不要混用。
🏗️ 5. 完整架构 OpenClaw 配置层次 OpenClaw 配置层次： ─────────────────────────────────────────────
-
全局配置（所有代理共享） └─ ~/.openclaw/openclaw.json └─ channels.qqbot └─ channels.feishu └─ channels.wecom └─ channels.dingtalk
-
代理配置（每个代理独立） └─ ~/.openclaw/agents/main/ ├─ SOUL.md ← 性格 ├─ IDENTITY.md ← 身份 └─ MEMORY.md ← 记忆
-
工作区文件（代理使用） └─ ~/.openclaw/workspace/ ├─ AGENTS.md ├─ TOOLS.md └─ 项目文档... ─────────────────────────────────────────────
实际目录结构 /home/admin/.openclaw/ ├── openclaw.json ← 全局配置（通道配置在这里） ├── openclaw.json.bak ← 配置备份 ├── agents/ ← 代理配置 │ └── main/ │ ├── sessions/ │ └── sessions.json ├── workspace/ ← 工作区（你正在用的） │ ├── AGENTS.md │ ├── SOUL.md │ ├── TOOLS.md │ ├── IDENTITY.md │ ├── USER.md │ ├── HEARTBEAT.md │ ├── MEMORY.md │ ├── memory/ ← 每日记忆 │ │ ├── 2026-04-21.md │ │ └── ... │ ├── docs/ ← 项目文档 │ │ ├── AiToMoney 甘特图使用指南.md │ │ └── ... │ └── scripts/ ← 定时任务脚本 │ ├── backup-feishu.sh │ └── ... ├── logs/ ← 日志 ├── media/ ← 媒体文件 └── extensions/ ← 插件 ├── openclaw-lark/ ├── wecom-openclaw-plugin/ └── ...
🎯 6. 多代理场景 如果你有多个代理 /home/admin/.openclaw/ ├── openclaw.json ← 全局配置（所有代理共享） │ └─ channels.* ← 通道配置 │ ├── agents/ │ ├── main/ ← 主代理（小龙） │ │ ├── SOUL.md │ │ ├── MEMORY.md │ │ └── workspace → ../../workspace/ │ │ │ ├── dev/ ← 开发代理（小发） │ │ ├── SOUL.md │ │ ├── MEMORY.md │ │ └── workspace → ../../workspace-dev/ │ │ │ └── ops/ ← 运维代理（小维） │ ├── SOUL.md │ ├── MEMORY.md │ └── workspace → ../../workspace-ops/ │ ├── workspace/ ← main 代理工作区 ├── workspace-dev/ ← dev 代理工作区 └── workspace-ops/ ← ops 代理工作区
通道共享 所有代理共享同一套通道配置：
- QQ Bot
- 飞书
- 钉钉
- 微信
但每个代理有独立的：
- 记忆（MEMORY.md）
- 文档（docs/）
- 脚本（scripts/）
💡 7. 常见问题 Q1: 添加通道配置在 workspace 里吗？ 答：❌ 不在！ 通道配置 → ~/.openclaw/openclaw.json NOT 在 → ~/.openclaw/workspace/
Q2: /home/admin/.openclaw/workspace 和 /root/.openclaw/workspace 的区别？ 答：
路径
用户
说明
/home/admin/.openclaw/workspace
admin
你的日常工作区（正在用）
/root/.openclaw/workspace
root
root 用户的工作区（另一个安装） 建议：只用 /home/admin/.openclaw/workspace，不要混用。
Q3: 工作区是共享的还是独立的？ 答： 通道配置：所有代理共享（openclaw.json） 工作区：每个代理独立（如果使用不同 workspace） 记忆：每个代理独立（MEMORY.md）
Q4: 代理和会话有什么区别？
维度
代理
会话
本质
AI 运行实例
对话历史
数量
可以有多个
每个代理多个
配置
独立工作区
独立上下文
类比
工作岗位
工作记录
Q5: 我需要配置多个代理吗？ 答： 普通用户：不需要，用默认的 main 代理就够了 高级用户：可以创建多个代理，用于不同场景
📝 8. 总结 核心概念
概念
位置
用途
是否共享
代理（Agent）
~/.openclaw/agents/<name>/
AI 运行实例
否
通道（Channel）
~/.openclaw/openclaw.json
消息通道
是
工作区（Workspace）
~/.openclaw/workspace/
文档/记忆/脚本
否
配置层次
-
全局配置（openclaw.json）← 所有代理共享 └─ 通道、插件、API Keys
-
代理配置（agents/<name>/）← 每个代理独立 └─ SOUL、记忆、身份
-
工作区（workspace/）← 每个代理独立 └─ 文档、脚本、记忆文件
你的当前状态 ✅ 1 个代理：main (default) ✅ 4 个通道：QQ、飞书、企业微信、钉钉 ✅ 1 个工作区：/home/admin/.openclaw/workspace/ ✅ 7 个核心文件：配置完整 ✅ 智能体：小龙 🐉
📚 9. 相关文档 OpenClaw 版本对比报告 CLI 与 UI 配置详解 Dashboard 页面详解 定时任务系统详解
文档维护：小龙 🐉最后更新：2026-04-21下次更新：2026-05-21
© 2026 AiToMoney 团队
文档维护：小龙 🐉最后更新：2026-04-21下次更新：2026-05-21
© 2026 AiToMoney 团队 | 小龙 🐉 创建
📱 AiToMoney 虾主联盟 入群二维码 QQ 群（群号：242249487）飞书群（仅限企业内部成员加入）微信群（二维码 7 天内有效） image.png
入群暗号：「我是一只虾，正在水里瞎折腾。」 Slogan：一个人可以走得很快，一群虾可以折腾得更远 🦞