OpenClaw 的四层架构

OpenClaw 的四层架构在文件系统中有非常清晰的映射。大部分用户可配置和扩展的文件都存放在~/.openclaw/主目录下，而核心程序则安装在系统的其他位置（如/usr/local/bin/openclaw或通过包管理器管理）。下面我逐层为你梳理对应的文件与目录：

1. 交互层 —— 连接外部世界的“翻译官”

这一层负责与各种聊天平台（如 WhatsApp、飞书、微信等）对接，将不同格式的消息转换为内部标准事件。

文件/目录	路径	作用
渠道配置文件	`~/.openclaw/channels/`	存放各个渠道的配置，例如`whatsapp.yaml`、`feishu.yaml`。你可以在这些文件里设置 API 密钥、回调地址等。
渠道插件	随 OpenClaw 二进制分发或独立安装	实际的协议转换逻辑由内置插件实现，一般不需要手动修改。

2. 网关层 —— 永不掉线的“总指挥官”

网关是整个系统的核心枢纽，负责路由、队列、任务调度和节点管理。它的配置和数据都集中在以下位置：

文件/目录	路径	作用
网关配置文件	`~/.openclaw/gateway.yaml`	网关的全局设置，包括监听端口、日志级别、节点连接超时等。
任务调度数据库	`~/.openclaw/data/jobs.db`	存储所有定时任务（Heartbeat）的定义和执行状态。网关根据这里的记录在指定时间触发任务。
节点状态缓存	`~/.openclaw/data/nodes.db`	记录所有已连接节点的信息（设备ID、IP、最后在线时间等）。网关通过它来路由指令到正确的节点。

3. 智能体层 —— AI 的“大脑”与记忆系统

这是你最熟悉的区域，对应我们之前聊过的workspace。每个智能体（Agent）都有一个独立的工作区，里面包含了它的全部“人格”和记忆。

文件/目录	路径	作用
工作区根目录	`~/.openclaw/workspace/`	默认智能体的工作区（如果你创建了多个智能体，可能有`workspace-agent2/`等）。
核心人格文件	`~/.openclaw/workspace/SOUL.md`	定义智能体的性格、语气和核心价值观。
用户偏好文件	`~/.openclaw/workspace/USER.md`	记录你的称呼、喜好、重要事项，让 AI 更懂你。
工作指南	`~/.openclaw/workspace/AGENTS.md`	告诉 AI 每天的工作流程、记忆规则等。
工具说明书	`~/.openclaw/workspace/TOOLS.md`	列出所有可用技能及其调用方法，AI 通过它来决策使用哪个工具。
主动任务定义	`~/.openclaw/workspace/HEARTBEAT.md`	定义 AI 主动执行的任务（如每天推送天气）。网关会读取此文件并创建定时任务。
身份信息	`~/.openclaw/workspace/IDENTITY.md`	定义 AI 的名字、喜欢的表情符号，用于对外展示。
长期记忆	`~/.openclaw/workspace/MEMORY.md`	长期重要的记忆，AI 会主动维护。
每日记忆日志	`~/.openclaw/workspace/memory/YYYY-MM-DD.md`	每天自动生成的对话日志，按日期归档。
工作区专属技能	`~/.openclaw/workspace/skills/`	仅在该工作区生效的技能，优先级高于全局技能。

4. 执行层 —— AI 的“手脚”

执行层由技能（Skills）和节点（Nodes）组成。技能是 AI 能使用的“工具”，节点是实际执行指令的设备。

技能相关文件

文件/目录	路径	作用
全局技能目录	`~/.openclaw/skills/`	存放所有已安装的全局技能。每个技能是一个子目录，包含`SKILL.md`（说明书）和可能的脚本文件。
ClawHub 缓存	`~/.openclaw/clawhub/`	从 ClawHub（技能市场）下载的临时文件，用于同步和更新技能。

节点相关文件

文件/目录	路径	作用
节点配置文件	`~/.openclaw/nodes.yaml`	定义所有已知节点的基本信息（名称、设备类型、连接方式等）。
节点程序	随 OpenClaw 分发	每个设备上安装的`openclaw-node`程序（或作为守护进程运行）。它通过 WebSocket 与网关保持长连接。
节点本地缓存	`/var/lib/openclaw-node/` （Linux）或`~/Library/Application Support/openclaw-node/`（macOS）	存放节点自身的状态信息，如离线时的任务缓存。

核心程序本身在哪？

OpenClaw 的二进制文件通常安装在系统路径中，可通过which openclaw查看。例如：

Linux:/usr/local/bin/openclaw
macOS:/opt/homebrew/bin/openclaw（如果通过 Homebrew 安装）
源码编译:~/go/bin/openclaw

这些二进制文件是编译好的程序，一般不需要手动修改。

总结

简单来说，OpenClaw 的“灵魂”和“记忆”都在~/.openclaw/workspace/里，由你自由编辑；“工具库”在~/.openclaw/skills/里，可自由增减；“调度中心”的配置在gateway.yaml和nodes.yaml里；而“翻译官”和“执行者”则是内置的二进制程序，默默运行。