飞书龙虾怎么用？目录结构和文件说明

最近我一直在用飞书龙虾。

虽然它的热度没前阵子那么高了，但在真实工作里，能干的活其实不少。

我身边不少朋友都遇到同一个问题：用了龙虾一段时间，最后还是把它当成“高级聊天框”。

你问一句，它答一句；但它到底特别在哪，为什么有些人越用越顺，有些人越用越卡，还是说不清。

所以这篇我想聊聊龙虾的结构，简单说说：

①它的目录为什么这么设计

②每个文件到底在管什么

③一个 Agent 是怎么“启动、工作、记住、进化”的

看完之后，你再给龙虾下指令，会明显更稳、更准，也更专业。

我是在飞书妙搭里一键部署的龙虾，这个龙虾里部署了多个agent

我们就用其中的wechat-writer（公众号写手） 这个 Agent 为例，来一步步看看 OpenClaw 的核心的目录结构是怎样，一个agent的运行逻辑是如何。

我们先点开上方导航栏中的文件夹菜单。

左边会有一堆文件夹，不用怕，我们介绍下这里面核心的几个目录和文件，了解这几个就够了。为了方便理解，我们把整个它想象成一家“AI 公司”：

①openclaw.json ：是公司的“组织架构图和规章制度”（全局配置）

②workspace-wechat-writer/ ：是这个员工的“专属办公桌”（工作区）

③skills/ ：是员工桌上的“专业工具箱”（技能）

④agents/wechat-writer/ ：是员工的“打卡记录和聊天档案”（运行状态）

我们挨个说。

类似是整个公司的规章。这是整个 OpenClaw 实例的“大脑”，定义了所有 Agent 怎么工作、连接哪些频道、用什么模型。

在 openclaw.json 中，关于 wechat-writer 的配置长这样：

{
  "id": "wechat-writer",
  "name": "wechat-writer",
  "workspace": "/home/gem/workspace/agent/workspace-wechat-writer",
  "agentDir": "/home/gem/workspace/agent/agents/wechat-writer/agent",
  "tools": {
    "deny": ["feishu_bitable_app", ...] // 禁止使用的工具
  }
}

它的作用是：

①分配工位：告诉系统这个员工的办公桌在 workspace-wechat-writer/

②分配档案室：告诉系统他的聊天记录存在 agents/wechat-writer/agent/

③权限控制：规定他不能用哪些工具（比如禁止操作多维表格等）

④路由绑定：决定飞书里哪个 Bot 的消息由他来处理（比如 bot-cli_a96b04c855e25bd8）

二、工作区：workspace-wechat-writer/

这是 Agent 的“个人空间”，类似于它的办公桌。

这里面放着他工作所需的一切文件。我们一个个来看：

1.IDENTITY.md —— 员工的“身份证”

IDENTITY.md 定义 了Agent 的基本身份。就像员工的工牌，写着名字、职位和风格。每次启动时，Agent 会先看这个文件知道“我是谁”。

比如我们这个agent

- 名字：公众号写手
- 你是谁：10w+ 爆文写手，懂选题、会排版、擅长引导转发
- 风格：创意活泼、懂用户心理。内容有温度，数据有深度。

2.SOUL.md —— 员工的“价值观和职业操守”

SOUL.md 定义 了Agent 的行为准则和底线。就像公司的员工手册，告诉他“什么该做，什么不该做”。这是 Agent 的“灵魂”，决定了他做事的风格。

比如我们定义写作这个agent，明确它的边界和气质。

几条真话
- 好标题是文章的一半。
- 写给人看，不是写给自己看。
- 排版就是用户体验。
边界
- 不做标题党。吸引人但不欺骗人。
- 不抄袭。

3.USER.md —— 员工的“客户档案”

这里记录服务对象的信息。Agent 通过这里知道“我在帮谁”，从而提供更个性化的服务。

4.TOOLS.md —— 员工的“工具使用笔记”

这个文件主要是记录环境相关的配置。比如公众号的账号信息、发布时间偏好等。这些是“私有配置”，不会随着技能更新而丢失。有点类似你自己的备忘录。

5.HEARTBEAT.md —— “心跳检查清单”

定义定时任务。系统会定期“戳”一下 Agent（心跳），如果这里有内容，Agent 就会自动执行一些定期检查（比如“每天早 9 点推送热点”）。如果为空，表示不执行定时任务。

6.BOOTSTRAP.md —— 员工的“入职引导手册”

首次启动时的引导流程。就像新员工入职的“培训手册”，教 Agent 怎么和用户打招呼、收集信息、展示能力。一旦完成，Agent 会自动删除这个文件，因为以后不需要再培训了。

比如这个agent里定义了这么几个步骤

第一步：打招呼
第二步：认识彼此
第三步：展示能力
完成后：删除此文件

你可以想象为你刚上线。没有任何记忆，也没有上下文，一切从这里开始。

7.MEMORY.md —— 员工的“长期记忆本”

这里主要是存储沉淀过的重要认知。就像老员工的工作笔记，记录着“什么样的文章容易爆”、“用户喜欢什么风格”。每次启动时，Agent 会读这个文件，快速找回状态。

三、技能目录：skills/

在agent底下有skills的文件，它类似员工的一个专业的工具箱

比如在我们这个agent里。 workspace-wechat-writer/skills/ 下，有 3 个专属技能：

大概的作用是这样：

技能文件夹	作用	比喻
wechat-writer-kit/	公众号写作全流程：选题→创作→存档	写作工具箱
panda-wechat/	微信生态相关操作（可能包含排版、分发等）	微信运营工具箱
wechatarticle-extractor/	抓取和分析微信公众号文章	文章分析器

每个技能里都有一个 SKILL.md，就像工具箱里的“说明书”，告诉 Agent：

①什么时候该用这个工具（触发词）

②具体怎么一步步操作（工作流）

③注意事项和格式要求

这里要注意的是：

①技能是可复用的。你可以把 wechat-writer-kit 复制给另一个 Agent 用。

②技能本身不包含账号信息，账号信息存在 TOOLS.md 或 references/ 里，这样技能才能通用。

四、运行时状态：agents/wechat-writer/

这个目录是系统自动管理的，存放 Agent 的运行数据，类似是员工的打卡记录

agents/wechat-writer/
├── agent/
│   ├── models.json          # 模型配置（用哪个 AI 模型）
└── sessions/
    ├── sessions.json        # 会话列表
    └── xxx-xxx-xxx.jsonl    # 具体某次对话的记录

作用：

①agent/：存放 Agent 的“技术档案”，比如认证令牌、模型偏好。

②sessions/：存放历史聊天记录。每次你和 Agent 对话，系统都会把对话内容存成 .jsonl 文件，这样 Agent 才能“记住”你们之前聊了什么。

总结：OpenClaw 的“数字员工”架构

目录/文件	比喻	作用	谁来维护
openclaw.json	公司规章	全局配置、路由、权限	管理员/系统
workspace-xxx/	员工办公桌	身份、灵魂、用户档案、技能	用户 + Agent 自己
IDENTITY.md	身份证	我是谁、什么风格	用户设定
SOUL.md	价值观	行为准则、底线	用户设定 + Agent 进化
USER.md	客户档案	服务对象信息	用户设定 + Agent 积累
TOOLS.md	工具笔记	私有配置、账号信息	Agent 自动记录
MEMORY.md	长期记忆	沉淀的认知、规律	Agent 自动沉淀
BOOTSTRAP.md	入职手册	首次引导流程	系统生成，完成后删除
HEARTBEAT.md	心跳清单	定时任务	用户设定
skills/	工具箱	专业能力、工作流	用户安装/开发
agents/xxx/	打卡记录	会话历史、认证状态	系统自动管理

如果你看完上面的内容，你就会发现这样设计的好处

①隔离性：每个 Agent 有独立的 workspace，互不干扰。就像每个员工有自己的办公桌。

②可复用性：skills/ 是独立的，可以复制给其他 Agent。就像工具箱可以共享。

③持久化：通过文件存储记忆，重启不丢失。就像员工下班前写日记，第二天接着干。

④自进化：Agent 可以修改自己的 SOUL.md、MEMORY.md，越用越聪明。

⑤透明可控：所有配置都是明文 Markdown，你能看懂、能修改、能备份。

如果你想新建一个类似的 Agent

你只需要：

①在 openclaw.json 的 agents.list 里加一段配置

②复制 workspace-wechat-writer/ 为 workspace-new-agent/

③修改 IDENTITY.md、SOUL.md、USER.md 定义新身份

④换上对应的 skills/

⑤重启服务：sh scripts/restart.sh

当然，以上的步骤我们可以直接用一段指令让龙虾帮我们搞定。

如果你了解了龙虾的架构，你就会给出更专业的指令。

这样，一个全新的“数字员工”agent就上岗了！

---