龙虾 Agent 人设配置体系
完整功能要求与部署文档

1配置体系全景图

龙虾 Agent 配置采用"通用规则引用链 + 角色定制文件"双层架构。每个 Agent 的 workspace 下有 7 个角色定制文件，每个文件通过第一行 Read ~/.openclaw/龙虾制度体系/XXX-龙虾通用规则.md 引用公司级共享规则。

文件引用链总览

角色workspace/                      ───→  公司共享库 (~/.openclaw/龙虾制度体系/)
──────────────────────────────────────────────────────────────────────
AGENTS.md       →  AGENTS-龙虾通用规范.md  →  LAW-L1/L2/L3 四大法
SOUL.md         →  SOUL-龙虾通用规则.md    →  10项能力清单、公司通讯录、龙虾通讯录
IDENTITY.md     →  IDENTITY-龙虾通用规则.md
USER.md         →  USER-龙虾通用规则.md
HEARTBEAT.md    →  HEARTBEAT-龙虾通用规则.md
TOOLS.md        →  TOOLS-龙虾通用规则.md
MEMORY.md       (独立文件，无引用链)

核心理念：修改通用规则文件 = 全员同步生效，这是整个体系的设计灵魂。不要在单个 Agent 文件中重复定义通用规则的内容。

2各文件功能要求详解

分为通用规则文件（公司共享库）和角色定制文件（Agent workspace）两大类。

2.1 通用规则文件（公司共享库，路径：~/.openclaw/龙虾制度体系/）

2.2 角色定制文件（每个 Agent 的 workspace 目录下）

3引用链加载机制

每次会话启动或心跳唤醒时，Agent 按固定顺序加载配置文件。

启动加载顺序

Token 用量监控（会话连续性保障）

4技能配置规范

技能（Skill）是 Agent 可调用的专项能力模块，按作用范围分为三级。

4.1 技能存放位置

4.2 技能目录标准结构

skill-name/
├── SKILL.md          # 技能说明文件（必需）
├── .env              # 环境变量/API凭证（S级保密）
├── *.py / *.sh       # 执行脚本
├── 历史版本/          # 归档目录
└── 文件夹说明.md      # 目录说明

4.3 SKILL.md 标准格式

4.4 当前全局共享技能清单

5Agent 配置字段要求

每个 Agent 在 openclaw.json 的 agents.list 数组中注册，包含以下字段。

全局 defaults（所有 Agent 继承）

绑定 (bindings)

每个 Agent 需要在 bindings 数组中配一条，含 agentId、channel（如 xiuxiu）、accountId（与 agent id 同名）。

6创建 Agent 完整流程

从参数确定到 Gateway 重启，标准创建流程共 7 步。

6.1 现有脚本工具

6.2 标准化创建流程

6.3 目录结构标准树

~/.openclaw/
├── openclaw.json                    # 主配置
├── 龙虾制度体系/                     # 公司共享库
│   ├── SOUL-龙虾通用规则.md
│   ├── IDENTITY-龙虾通用规则.md
│   ├── USER-龙虾通用规则.md
│   ├── AGENTS-龙虾通用规范.md
│   ├── HEARTBEAT-龙虾通用规则.md
│   ├── TOOLS-龙虾通用规则.md
│   ├── SKILLS-龙虾通用规则.md
│   ├── 10项能力清单.md
│   ├── 公司通讯录.md
│   ├── 龙虾通讯录.md
│   ├── LAW-L1-严格执行版.md
│   ├── LAW-L2-要求执行版.md
│   ├── LAW-L3-方向指引版.md
│   ├── SABC-密码.md
│   ├── templates/                   # 角色文件模板
│   ├── scripts/                     # 运维脚本集
│   ├── skills/                      # 系统级技能
│   ├── extensions/                  # 插件
│   ├── init-agent.sh
│   └── bot-userid-directory.json    # Bot userId 对照表
├── skills/                          # 全局共享技能
├── agents/<agentId>/agent/          # Agent 系统目录
└── workspace-<agentId>/             # Agent 工作区
    ├── AGENTS.md
    ├── SOUL.md
    ├── IDENTITY.md
    ├── USER.md
    ├── HEARTBEAT.md
    ├── TOOLS.md
    ├── MEMORY.md
    ├── memory/                      # 每日记忆文件
    ├── skills/                      # 角色专属技能
    └── 工作文件/
        ├── 优化建议/
        ├── 复盘/
        ├── 任务数据中心/
        └── 词库/

7插件扩展体系

当前 4 大核心插件，覆盖会议管理、法律执行、IM 集成和任务调度。

插件协同关系

主人（任意位置）
  ↓ "组织圆桌会议"指令
某 bot（如 022）
  ↓ lobby-hearing 授予任务（大厅）/ 直接接收（私信）
022 起草会议方案
  ↓ 调用 roundtable-organizer skill
skill 创建会议面板 + refreshRooms + 发首条消息
  ↓ meeting-token 接管该面板
PM 022 组织圆桌会议（令牌制轮转）
  ↓ law-enforcer 全程监控合规
所有参会者发言
  ↓ 散会
meeting-token 封锁 15 分钟 → lobby-hearing 任务结束

8新电脑部署清单

从零搭建龙虾 Agent 运行环境所需的全部文件和步骤。

8.1 需要复制的文件

8.2 部署步骤

8.3 关键环境变量 / API Key（需在新机重新配置）

9稳定性分级清单

按功能模块进行稳定性分级评估。

10部署验证矩阵

新电脑部署完成后，建议按以下矩阵逐项验证。

11历史依据与源码参照

本文档基于当前公司共享库全量文件和实际部署经验编写，以下为主要参照来源。

说明：本页为龙虾 Agent 人设配置体系的功能清单与部署文档，不会自动修改配置或创建 Agent。部署操作请严格按第八章步骤执行，引用链修改需经主人确认。