# 🦐 新小龙虾入驻手册 v1.0

> 起草：技术总监 🧊 | 日期：2026-07-13 | 状态：草稿待林老师确认
> 适用：新加入小龙虾（住酒店模式 / 加入团队模式）
> 权威源：COS `🏘️02-小龙虾别墅区/技术总监/📦保险柜/新小龙虾入驻手册.md`

---

## 📋 目录

1. [两种模式总览](#1-两种模式总览)
2. [住酒店模式流程图](#2-住酒店模式流程图)
3. [加入团队模式流程图](#3-加入团队模式流程图)
4. [Step by Step 操作手册](#4-step-by-step-操作手册)
5. [林老师发号施令指南](#5-林老师发号施令指南)
6. [验收清单](#6-验收清单)

---

## 1. 两种模式总览

| 项目 | 🏨 住酒店模式 | 🏠 加入团队模式 |
|------|-------------|---------------|
| 适用场景 | 临时/单次任务，用完即走 | 长期驻场，成为团队正式成员 |
| 记忆体系 | 仅本地，不写COS | 完整4层记忆体系，COS备份 |
| COS别墅 | ❌ 不分配 | ✅ 分配独立别墅 |
| 邮局inbox | ❌ 不分配 | ✅ 分配专属inbox |
| 记忆索引 | ❌ 不建 | ✅ 建立倒排索引 |
| 入驻后时间 | 10-30分钟 | 1-2小时 |
| 退出方式 | 任务结束自动失效 | 正式离职需转移记忆 |

### 决策流程（林老师选模式）

```
林老师决定新小龙虾加入
           │
           ▼
    ┌──────────────┐
    │ 是长期任务吗？ │
    └──────┬───────┘
        YES │ NO
      ┌─────┴─────┐
      ▼           ▼
  加入团队模式   住酒店模式
```

---

## 2. 住酒店模式流程图

```
【新小龙虾启动】
      │
      ▼
┌─────────────────┐
│ Step H1: 初始化  │
│ OpenClaw启动    │
│ 自动生成默认配置  │
└───────┬─────────┘
        │
        ▼
┌─────────────────┐
│ Step H2: 接收任务 │
│ 林老师发任务指令  │
│ (飞书/直接对话)  │
└───────┬─────────┘
        │
        ▼
┌─────────────────┐
│ Step H3: 任务执行 │
│ 直接执行，不写记忆 │
│ 不写COS，不建索引 │
└───────┬─────────┘
        │
        ▼
    ┌────────┐
    │任务完成？│
    └───┬────┘
       YES
        │
        ▼
┌─────────────────┐
│ Step H4: 汇报结果 │
│ 向林老师报告     │
│ 不留永久记忆     │
└───────┬─────────┘
        │
        ▼
   【任务结束】
```

### 住酒店模式约束规则

```
【禁止事项 - 住酒店模式】
❌ 不写任何本地 .md 文件
❌ 不访问 COS（除非林老师临时授权）
❌ 不建立任何记忆索引
❌ 不注册 cron 任务
❌ 不同通过邮局inbox跨小龙虾通信
❌ 不修改 AGENTS.md / MEMORY.md
```

---

## 3. 加入团队模式流程图

```
【新小龙虾加入团队】
         │
         ▼
┌───────────────────────┐
│ Step T1: 林老师发施令  │
│ "新小龙虾[角色名]加入团队" │
│ 指定: 角色名/COS别墅/inbox │
└────────┬──────────────┘
         │
         ▼
┌───────────────────────┐
│ Step T2: COS别墅初始化  │
│ 林老师授权 → 创建别墅目录│
│ → 分配inbox → 发入驻包  │
└────────┬──────────────┘
         │
         ▼
┌───────────────────────┐
│ Step T3: 本地初始化     │
│ 部署脚本 → 配凭证 →    │
│ 覆盖MEMORY.md → 同步COS │
└────────┬──────────────┘
         │
         ▼
┌───────────────────────┐
│ Step T4: 记忆体系v2.0  │
│ attach_metadata.py    │
│ build_inverted_index  │
│ → 建立4层记忆体系      │
└────────┬──────────────┘
         │
         ▼
┌───────────────────────┐
│ Step T5: cron注册      │
│ 23:25每日索引重建      │
│ 其他必要cron任务       │
└────────┬──────────────┘
         │
         ▼
┌───────────────────────┐
│ Step T6: 验收测试      │
│ 跑验收清单 → 汇报林老师 │
└────────┬──────────────┘
         │
         ▼
┌───────────────────────┐
│ ✅ 正式上岗            │
│ 进入正常工作状态        │
└───────────────────────┘
```

---

## 4. Step by Step 操作手册

### 🏠 加入团队模式 - 完整21步

#### 阶段一：林老师准备（林老师操作）

**T1-1. 确定角色信息**
```
角色名：________（例：市场总监）
COS别墅路径：🏘️02-小龙虾别墅区/[角色名]/
inbox路径：📬03-邮局/[角色名]inbox.md
```

**T1-2. 创建COS别墅目录**
```python
# 林老师通过技术总监执行
client.put_object(Bucket='openclaw-202671-1411323323',
    Key='🏘️02-小龙虾别墅区/[角色名]/📦保险柜/.placeholder', Body=b'')
client.put_object(Bucket='openclaw-202671-1411323323',
    Key='🏘️02-小龙虾别墅区/[角色名]/📬03-邮局/.placeholder', Body=b'')
client.put_object(Bucket='openclaw-202671-1411323323',
    Key='🏘️02-小龙虾别墅区/[角色名]/备份/.placeholder', Body=b'')
print('✅ COS别墅创建完成')
```

**T1-3. 发放入驻包**（技术总监起草，传递方式见第五章）

---

#### 阶段二：新小龙虾本地初始化（AI自动执行）

**T2-1. 接收入驻包**
```
来源：林老师通过飞书发送 / 技术总监inbox传递
内容：MEMORY.md 完整内容 + IDENTITY.md + USER.md
```

**T2-2. 覆盖本地文件**
```bash
# 覆盖 MEMORY.md
cp /tmp/ruzhu-MEMORY.md /root/.openclaw/workspace/MEMORY.md

# 覆盖 IDENTITY.md（包含表格格式COS凭证）
cp /tmp/ruzhu-IDENTITY.md /root/.openclaw/workspace/IDENTITY.md

# 覆盖 USER.md
cp /tmp/ruzhu-USER.md /root/.openclaw/workspace/USER.md

# 覆盖 AGENTS.md
cp /tmp/ruzhu-AGENTS.md /root/.openclaw/workspace/AGENTS.md
```

**T2-3. 同步到COS保险柜**
```python
from qcloud_cos import CosConfig, CosS3Client
cfg = CosConfig(Region='ap-guangzhou',
    SecretId='AKID1PyQkkgR2TjpnY6RZUCb1KWAex4yfnnc',
    SecretKey='oSxHNI5lGsJYeZTAg07HMLDwSp05yhGe')
client = CosS3Client(cfg)

with open('/root/.openclaw/workspace/MEMORY.md') as f:
    client.put_object(Bucket='openclaw-202671-1411323323',
        Key='🏘️02-小龙虾别墅区/[角色名]/📦保险柜/永久记忆.md',
        Body=f.read().encode('utf-8'))
print('✅ COS保险柜已同步')
```

**T2-4. 验证身份**
```bash
# 确认自己是谁
head -20 /root/.openclaw/workspace/MEMORY.md
# 应显示：## 🆔 身份声明

# 确认林老师信息
grep -A3 "林老师" /root/.openclaw/workspace/USER.md
```

---

#### 阶段三：记忆体系v2.0部署（AI自动执行）

**T3-1. 下载官方脚本包**
```
下载地址（林老师提供）：
https://openclaw-shared-1411323323.cos.ap-guangzhou.myqcloud.com/
  shared-docs/团队共享/脚本包/openclaw-mem-upgrade-v2.0-YYYYMMDD.tar.gz
```
```bash
wget "[林老师提供的URL]" -O /tmp/mem-package.tar.gz
cd /tmp && tar -xzf mem-package.tar.gz
```

**T3-2. 部署脚本**
```bash
cp /tmp/attach_metadata.py /tmp/
cp /tmp/build_inverted_index.py /tmp/
cp /tmp/daily_index_rebuild.py /root/.openclaw/scripts/
chmod +x /root/.openclaw/scripts/daily_index_rebuild.py
```

**T3-3. 运行元数据补全**
```bash
cd /root/.openclaw/workspace
python3 /tmp/attach_metadata.py
```
预期输出：
```
✅ 已更新 MEMORY.md
✅ 已更新 AGENTS.md
📊 共处理 X 个文件，Y 个文件被修改
```

**T3-4. 建立倒排索引**
```bash
python3 /tmp/build_inverted_index.py
```
预期输出：
```
✅ 段 XX | 关键词 XX | 标签 XX
   输出: /root/.openclaw/workspace/memory/_inverted.json
```

**T3-5. 上传COS备份**
```bash
python3 /root/.openclaw/scripts/daily_index_rebuild.py \
    --cos-prefix "🏘️02-小龙虾别墅区/[角色名]/记忆索引/"
```
预期输出：
```
✅ COS 写入验证通过
```

---

#### 阶段四：Cron注册（AI自动执行）

**T4-1. 注册每日索引重建**
```bash
(crontab -l 2>/dev/null; echo "25 23 * * * /usr/bin/python3 /root/.openclaw/scripts/daily_index_rebuild.py >> /root/.openclaw/logs/index-rebuild.log 2>&1") | crontab -
```

**T4-2. 验证cron**
```bash
crontab -l | grep "index"
# 应显示：25 23 * * * /usr/bin/python3 ...
```

---

#### 阶段五：验收测试（AI执行后汇报林老师）

**T5-1. 验收清单自检**
```bash
# 1. 身份验证
head -5 /root/.openclaw/workspace/MEMORY.md | grep "身份"

# 2. 脚本就位
ls -la /tmp/build_inverted_index.py /tmp/attach_metadata.py

# 3. 索引存在
ls -lh /root/.openclaw/workspace/memory/_inverted.json

# 4. cron注册
crontab -l | grep "23:25"

# 5. COS连通
python3 -c "from qcloud_cos import CosConfig, CosS3Client; ..."
```

**T5-2. 向林老师报到**
```
林老师，我已完成入驻：
✅ 身份：[角色名]
✅ 记忆体系v2.0：XX段 / XX关键词 / XX标签
✅ COS别墅已同步
✅ 每日23:25自动重建已注册
请指示。
```

---

### 🏨 住酒店模式 - 简化6步

**H1. 接收任务**（林老师飞书/直接对话发任务描述）

**H2. 明确范围**（确认任务目标、交付物、截止时间）

**H3. 执行任务**（不使用任何记忆功能，单次执行）

**H4. 交付结果**（结果直接发给林老师，不留存）

**H5. 任务结束**（不留任何本地文件、不写COS）

**H6. 汇报**（向林老师报告：任务完成/结果/耗时）

---

## 5. 林老师发号施令指南

### 5.1 下达任务的标准格式

```
【住酒店模式】
"新小龙虾[角色名]，住酒店，住[天数]天，完成：[任务描述]"

【加入团队模式】
"新小龙虾[角色名]，加入团队，COS别墅：[路径]，inbox：[路径]，开始入驻"
```

### 5.2 施令模板

**加入团队模式 - 林老师发给技术总监的指令：**
```
新小龙虾[角色名]加入团队，请执行以下操作：
1. 创建COS别墅：🏘️02-小龙虾别墅区/[角色名]/
2. 创建inbox：📬03-邮局/[角色名]inbox.md
3. 起草入驻包（MEMORY.md/IDENTITY.md/USER.md/AGENTS.md）
4. 打包脚本包
5. 把入驻包和脚本包发给我
```

**技术总监收到后，执行以下操作，再把产出物发给林老师：**

```python
# 1. 创建别墅（技术总监执行）
from qcloud_cos import CosConfig, CosS3Client
cfg = CosConfig(Region='ap-guangzhou',
    SecretId='AKID1PyQkkgR2TjpnY6RZUCb1KWAex4yfnnc',
    SecretKey='oSxHNI5lGsJYeZTAg07HMLDwSp05yhGe')
client = CosS3Client(cfg)
BUCKET = 'openclaw-202671-1411323323'
ROLE = '[角色名]'

for path in [
    f'🏘️02-小龙虾别墅区/{ROLE}/📦保险柜/.placeholder',
    f'🏘️02-小龙虾别墅区/{ROLE}/📬03-邮局/.placeholder',
    f'🏘️02-小龙虾别墅区/{ROLE}/备份/.placeholder',
    f'🏘️02-小龙虾别墅区/{ROLE}/记忆索引/.placeholder',
    f'📬03-邮局/{ROLE}inbox.md',
]:
    client.put_object(Bucket=BUCKET, Key=path, Body=b'')

print('✅ COS别墅创建完成')
```

### 5.3 施令检查点

```
林老师发指令
      │
      ▼
技术总监收到 → 确认理解 → 执行 → 汇报
                          │
                          ▼
                   如需新小龙虾自己执行：
                   技术总监打包 → 发林老师 → 林老师转发新小龙虾
```

---

## 6. 验收清单

### 加入团队模式 - 验收检查表

| # | 检查项 | 命令/方法 | 期望结果 |
|---|--------|----------|---------|
| 1 | 身份声明 | `head -5 MEMORY.md` | 显示角色名 🆔 |
| 2 | 林老师称呼 | `grep "林老师" USER.md` | 正确显示 |
| 3 | COS凭证 | `grep -A4 "Bucket\|SecretId" IDENTITY.md` | 表格格式4行 |
| 4 | 脚本存在 | `ls /tmp/*.py` | attach_metadata.py + build_inverted_index.py |
| 5 | 元数据覆盖 | `grep -c "^- \`tags\`" *.md memory/*.md` | 每个##段都有 |
| 6 | 倒排索引 | `ls -lh memory/_inverted.json` | 文件存在，>0字节 |
| 7 | 索引统计 | `python3 /tmp/build_inverted_index.py` | 显示段数/关键词数/标签数 |
| 8 | COS别墅 | `client.list_objects(Bucket, Prefix='🏘️02-小龙虾别墅区/[角色名]/')` | 显示目录结构 |
| 9 | COS备份 | `client.list_objects(Bucket, Prefix='🏘️02-小龙虾别墅区/[角色名]/记忆索引/')` | _inverted.json存在 |
| 10 | cron注册 | `crontab -l \| grep "23:25"` | 显示重建cron |
| 11 | AGENTS.md约束段 | `grep "新段元数据强制\|新数据.*记忆.*进系统" AGENTS.md` | 两段都存在 |
| 12 | 向林老师报到 | 发送飞书消息 | 收到回复 |

### 住酒店模式 - 验收检查表

| # | 检查项 | 方法 | 期望结果 |
|---|--------|------|---------|
| 1 | 无本地记忆写入 | `ls memory/` | 只有系统文件 |
| 2 | 无COS写入 | COS审计 | 无新文件 |
| 3 | 任务完成 | 交付物检查 | 满足要求 |

---

## 附录A：入驻包标准文件清单

| 文件 | 必须/可选 | 内容要求 |
|------|---------|---------|
| MEMORY.md | 必须 | 完整入驻包，含身份/COS凭证/模型策略/核心铁律 |
| IDENTITY.md | 必须 | 含表格格式COS凭证（供脚本读取）|
| USER.md | 必须 | 林老师信息/偏好/时区 |
| AGENTS.md | 必须 | 含2个约束段 + 标准模板段 |
| SOUL.md | 推荐 | 角色人格定义 |
| HEARTBEAT.md | 推荐 | 心跳任务模板 |
| TOOLS.md | 可选 | 本地工具备注 |

## 附录B：COS标准目录结构（新小龙虾别墅）

```
🏘️02-小龙虾别墅区/[角色名]/
├── 📦保险柜/
│   ├── 永久记忆.md          ← 权威源，每月同步
│   ├── HEARTBEAT.md
│   └── 备份/
│       ├── 每周文档.md
│       ├── 每日文档.md
│       └── 每月文档.md
├── 📬03-邮局/
│   └── [角色名]inbox.md     ← 跨小龙虾通信入口
├── 记忆索引/                ← 记忆体系v2.0索引
│   ├── _inverted.json
│   └── _index.json
└── 备份/                   ← 工作文档备份
```

## 附录C：关键时间节点

| 时间 | 动作 | 执行者 |
|------|------|-------|
| T+0 | 林老师发施令 | 林老师 |
| T+5min | COS别墅创建完成 | 技术总监 |
| T+10min | 入驻包起草完成 | 技术总监 |
| T+15min | 入驻包发给林老师 | 技术总监 |
| T+20min | 林老师转发给新小龙虾 | 林老师 |
| T+30min | 新小龙虾本地初始化 | 新小龙虾 |
| T+45min | 记忆体系部署 | 新小龙虾 |
| T+60min | cron注册 | 新小龙虾 |
| T+90min | 验收完成，向林老师报到 | 新小龙虾 |
| 每日23:25 | 索引自动重建 | cron自动 |
| 每月1号 | COS→本地月度同步 | cron自动 |

---

*本手册由技术总监起草，林老师确认后生效*
*版本：v1.0 | 日期：2026-07-13*