Openclwa入门教程(4)——代理通道与工作区详解
创建日期2026-04-21 |作者AiToMoney团队 |适用版本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工具配置本地环境配置IDENTITY.md身份信息AI 的名字、角色USER.md用户信息你的个人信息和偏好HEARTBEAT.md心跳任务定时任务配置MEMORY.md长期记忆核心记忆存储多代理场景~/.openclaw/agents/ ├── main/ ← 主代理小龙 │ ├── SOUL.md │ └── MEMORY.md ├── dev/ ← 开发代理小发 │ ├── SOUL.md │ └── MEMORY.md └── ops/ ← 运维代理小维 ├── SOUL.md └── MEMORY.md每个代理有独立的性格、记忆和工作区。所有代理共享通道配置、插件配置和 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:xxx},feishu:{enabled:true,groupPolicy:allowlist},wecom:{enabled:false},dingtalk:{enabled:false}}}通道与代理的关系全局通道配置openclaw.json→ 所有代理共享 代理配置agents/main/→ 使用这些通道发送/接收消息关键点✅ 通道配置是全局的所有代理共享✅ workspace 里不存储通道配置✅ workspace 里存储的是代理的记忆和文档3. 工作区Workspace什么是工作区工作区 代理的工作空间存储文档、记忆、脚本等文件。工作区内容~/.openclaw/workspace/ ├── AGENTS.md ← 代理启动规则 ├── SOUL.md ← 性格定义 ├── TOOLS.md ← 工具配置 ├── IDENTITY.md ← 身份信息 ├── USER.md ← 用户信息 ├── HEARTBEAT.md ← 心跳任务 ├── MEMORY.md ← 长期记忆 ├── memory/ ← 每日记忆 ├── docs/ ← 项目文档 └── scripts/ ← 定时任务脚本 AiToMoney虾主联盟社区www.aitomoney.onlineworkspace 存储什么文件用途是否共享AGENTS.md代理启动规则否SOUL.md性格定义否MEMORY.md长期记忆否memory/每日记忆否docs/项目文档否workspace 不存储什么内容存储位置通道配置~/.openclaw/openclaw.json通道凭证~/.openclaw/openclaw.json插件配置~/.openclaw/openclaw.jsonAPI Keys~/.openclaw/openclaw.json会话历史~/.openclaw/agents/main/sessions/4. 完整架构OpenClaw 配置层次1. 全局配置所有代理共享 └─ ~/.openclaw/openclaw.json通道、插件、API Keys 2. 代理配置每个代理独立 └─ ~/.openclaw/agents/main/SOUL、记忆、身份 3. 工作区文件代理使用 └─ ~/.openclaw/workspace/文档、脚本、记忆文件你的当前状态✅ 1 个代理main (default) ✅ 4 个通道QQ、飞书、企业微信、钉钉 ✅ 1 个工作区/home/admin/.openclaw/workspace/ ✅ 智能体小龙 5. 常见问题Q1: 添加通道配置在 workspace 里吗❌ 不在通道配置在~/.openclaw/openclaw.json不在 workspace。Q2: 工作区是共享的还是独立的通道配置所有代理共享openclaw.json工作区每个代理独立记忆每个代理独立Q3: 代理和会话有什么区别维度代理会话本质AI 运行实例对话历史数量可以有多个每个代理多个类比工作岗位工作记录Q4: 我需要配置多个代理吗普通用户不需要用默认的 main 代理就够了。高级用户可创建多个代理。6. 相关文档CLI 与 UI 配置详解Dashboard 页面详解文档维护小龙 |最后更新2026-04-21© 2026 AiToMoney 团队 | AiToMoney虾主联盟社区见内容