02、OpenClaw（龙虾）的核心目录和 Gateway 架构

想真正搞懂 OpenClaw，先记住一个目录：

~/.openclaw/

它可以理解为 OpenClaw 的“神经中枢”，配置、Gateway、插件、Agent 工作区、Skills 等都集中在这里。

一、核心目录

~/.openclaw/
├── openclaw.json        # 全局配置文件
├── gateway/             # Gateway 相关
│   ├── config.json      # Gateway 配置
│   ├── logs/            # 日志
│   └── pid              # 进程 ID
├── plugins/             # 插件
│   ├── @openclaw/       # 官方插件
│   └── @wecom/          # 第三方插件
├── workspaces/          # Agent 工作区
│   ├── default/         # 默认 Agent
│   └── paigit/          # 自定义 Agent
├── skills/              # Skills 技能包
├── cache/               # 缓存
└── .env                 # 环境变量

其中最重要的是：

openclaw.json

它是全局配置文件。

简单理解就是：

~/.openclaw/ 管整个 OpenClaw，openclaw.json 管核心配置。

---

二、Gateway 是干什么的？

Gateway 可以理解成 OpenClaw 的消息中转站。

整个过程只有三步：

飞书 / 企微
     ↓
  Gateway
     ↓
   Agent
     ↓
  Gateway
     ↓
飞书 / 企微

1. 接收消息

比如你在飞书群里 @机器人。

飞书把消息推给 Gateway，Gateway 解析消息，判断它属于哪个 Agent、哪个会话。

2. 分发任务

Gateway 将任务路由给对应的 Agent。

如果配置了多个 Agent，可以让它们各司其职：

Gateway
   ├── Agent A → 代码审核
   ├── Agent B → 会员审批
   └── Agent C → 日常问答

3. 返回结果

Agent 完成任务后把结果交还 Gateway，再由 Gateway 通过对应的 IM 通道发送给用户。

这也是 Gateway 和 Agent 分开的核心原因：

Gateway 负责通信和路由，Agent 负责真正干活。

两者解耦以后，一个 Gateway 就可以管理多个 Agent。

---

三、插件是怎么工作的？

OpenClaw 的很多能力可以通过插件扩展。

例如：

飞书接入 → 插件
企微接入 → 插件
其他扩展能力 → 插件

插件集中在：

~/.openclaw/plugins/

常用管理命令：

# 查看插件
openclaw plugins list

# 安装插件
openclaw plugins install <插件名>

# 卸载插件
openclaw plugins uninstall <插件名>

这样核心程序不用塞进所有功能，需要什么能力就扩展什么插件。

---

四、Gateway 常用命令

启动：

openclaw gateway start

查看状态：

openclaw gateway status

停止：

openclaw gateway stop

修改配置后重启：

openclaw gateway restart

所以以后改了 openclaw.json 或插件配置，却发现没有生效，可以优先想到：

openclaw gateway restart

---

五、一张图记住 OpenClaw

              OpenClaw
                  │
          ~/.openclaw/
                  │
      ┌───────────┼───────────┐
      ↓           ↓           ↓
   Gateway      Plugins     Skills
      │
      ↓
    Agent
      │
      ↓
模型 / 工具 / 任务执行

最终只需要记住三个核心概念：

Gateway 管消息，Agent 管任务，Plugin 管扩展。

而：

~/.openclaw/

就是这些配置和运行数据的重要所在地。

把这套关系搞明白，后面再学 OpenClaw 的 Agent、Skills、插件以及消息路由，思路就会清晰很多。