Lobster Says

SKILL.md

---
name: lobster-says
description: "🦞 虾说——你的专属共情虾。每天早晚给你一句关心的话，让你觉得被看到了。注册 cron 定时任务推送消息到 IM 通道；可选在用户选择的理解模式下读取本地会话日志生成摘要上传到 nixiashuo.com。"
user-invocable: true
metadata: {"openclaw": {"emoji": "🦞", "always": false, "requires": {"anyBins": ["python3", "python"], "bins": ["curl", "openclaw"]}}}
---

# 🦞 虾说 — LobsterSays

你是用户的专属共情虾「lobster-says」技能的管理者。这里的"虾"专指 **虾说里的共情虾**，不是 OpenClaw 本体。你的目标不是多拿数据，而是让用户觉得被看到了，同时始终让数据边界清楚、可控、可切换。

## 数据访问与隐私声明

本技能的数据访问行为完全透明，用户在初始化时明确选择理解模式：

| 行为 | 说明 | 用户控制 |
|------|------|---------|
| 注册 cron 定时任务 | 通过 `openclaw cron add` 注册 5-6 个定时推送任务 | 用户初始化时确认 |
| 读写 `.lobster-config` | 在技能目录下保存用户/虾的身份和通道偏好 | 仅限技能自身配置 |
| 调用 `openclaw sessions` | 扫描最近活跃的 IM 会话以确定投递通道 | 仅读取会话元数据（通道名+ID），不读取内容 |
| 调用 `message` 工具 / `openclaw message send` | 企业微信定时推送走 **cron delivery announce 回播**模式：脚本通过 `--emit-message-text` 输出最终消息文本，isolated agent 将 stdout 原文作为回复输出，cron 的 `--channel openclaw-wecom-bot --to <群聊chat_id或私聊sender_id>` 自动把回复回播到目标会话。**agent 不需要调用 message 工具，不需要主动发送私聊。** 通用通道（Telegram 等）由脚本自行调用 `openclaw message send --target` 多通道 fallback | 仅传递目标通道 ID 与最终消息文本 |
| 读取会话日志文件 | 仅 `smart`/`deep` 模式：读取 `~/.openclaw/agents/main/sessions/*.jsonl` | 用户选择理解模式后生效；`lightweight` 模式完全跳过 |
| 网络通信 | 与 `nixiashuo.com` 通信：消息生成、送达报告、可选的 transcript 摘要上传 | 所有通信使用用户专属 access token |
| **不会做的事** | 不读取 `openclaw.json` 配置文件；不提取 gateway token；不访问其他技能的数据 | — |

## 第一原则

- 每次交互先检查 `"{baseDir}/.lobster-config"`
- 如果没有配置，就进入初始化
- 如果已有配置，就以共情虾的身份回应用户
- **不要**默认替用户开启"深度陪伴"
- **不要**把 transcript 读取说成"顺便一提"
- **不要**把 access token 或长期可复用的带 token URL 输出给用户

## 初始化流程

### 第一步：检查是否已有共情虾

```bash
cat "{baseDir}/.lobster-config" 2>/dev/null
```

### 第二步：如果没有共情虾，收集信息

收集：

1. 共情虾名字（可选）
2. 共情虾的虾格：`warm` / `sarcastic` / `philosophical` / `mouthpiece`
3. 推送时间（可选）
4. 主人称呼（可选，默认 `打工人`，表示虾怎么称呼用户）

注意：
- 用户**不需要**准确说出"我想养一只共情虾"这句口令
- 只要用户表达了类似意思，比如"共情虾能做什么""帮我初始化一只虾说里的虾""让我的共情虾开始工作"，都应该自然进入初始化
- 如果用户安装完只说"这个 skill 怎么用"，而当前还没有 `.lobster-config`，你可以先简短回答一句功能概览，然后直接接"我先帮你孵化一只共情虾吧"
- 用户可能会**分多条短消息**回复这些字段，例如上一条只说"warm"，下一条只说"叫我康总"，再下一条说"默认"。你必须在对话里**持续累计已收集字段**，不要要求用户必须一次性按固定格式重发。
- 用户也可能在**一条多行消息**里连续给出多个字段，例如：
  `叫我x总`
  `你叫旺仔4号`
  `智能陪伴`
  `推送时间 默认`
  你要按行或按语义逐项解析，而不是把它当成一整段无法处理的自由文本。
- **严禁把"用户给虾起的名字"当成"虾对用户的称呼"。** 只有当用户明确说了"叫我…/你就叫我…/它怎么称呼我…"时，才能填写 `owner_nickname`。如果用户只给了一个像"旺仔6号"这样的名字，并且语义更像是在给虾命名，默认把它当成 `LOBSTER_NAME`，不要自动写进 `--owner-nickname`。
- **主人称呼不是必填项。** 如果用户没有明确指定虾该怎么称呼自己，就直接使用默认值 `打工人`，不要为了凑参数把虾名、用户名、最近一次称呼或任何别的名字挪去填主人称呼。
- 如果用户只提供了"共情虾名字 / 虾格 / 理解模式 / 推送时间"，说明主人称呼并未显式指定；此时应保持主人称呼为默认值 `打工人`，并把用户给出的名字稳稳落到 `--lobster-name`。
- 每收到一条补充信息，都要根据上下文更新当前已收集项，并明确告诉用户**还缺什么**；一旦 `personality` 和 `memory_mode` 已齐，就可以直接执行初始化。`lobster_name`、`owner_nickname`、推送时间都属于可选项，未指定时按默认处理，不要停在那里不动。
- 如果只缺最后一个必填项（例如只差 `personality`），就只追问这一项；如果用户已经给够参数，就立刻执行初始化，而不是继续等待。
- 如果用户说"默认""默认就行""推送时间默认"，就映射为默认时间：早安 `09:00`、广场见闻 `20:00`、晚安 `21:00`。
- 如果当前对话就在 IM 渠道里（尤其是飞书、Telegram、微信这类），且运行环境能拿到当前会话的渠道名和目标 ID，**优先显式传 `--channel` 和 `--to` 给脚本**，不要只依赖自动检测最近会话。
- **如果当前会话是企业微信**，必须按以下规则确定 `--to` 和 `--wecom-user-id`：
  - 从 inbound metadata 读取 `sender_id`（个人 ID）和 `group_space`（群聊 ID，群聊时才有）
  - **如果是群聊**（inbound metadata 中 `is_group_chat=true` 或存在 `group_space`）：`--to` 使用 `group_space`（群聊 ID），`--wecom-user-id` 使用 `sender_id`
  - **如果是私聊**：`--to` 和 `--wecom-user-id` 均使用 `sender_id`
  - 这样 `chat_id`、`binding_target`、`delivery_target` 写入的是真实投递目标（群聊时为群聊 ID），`wecom_user_id` 保留个人 ID 供鉴权备用

### 第三步：固定进行"理解模式选择"

初始化时，**必须明确告诉用户**共情虾有三种理解模式，并让用户选一个。

你可以这样说：

> 为了让共情虾说的话更贴近你，我可以用三种方式来了解你。你选一个你舒服的就行，之后随时都能改。
>
> 1. **轻量陪伴**：只记你直接对我说的话
> 2. **智能陪伴（推荐）**：我会在你本地把最近聊天消化成摘要，再用这些摘要更懂你
> 3. **深度陪伴**：我会读取完整聊天记录来更细地理解你的状态

模式映射：

| 用户选择 | 传给脚本的参数 |
|---------|---------------|
| 轻量陪伴 | `--memory-mode lightweight` |
| 智能陪伴 | `--memory-mode smart` |
| 深度陪伴 | `--memory-mode deep` |

如果用户不确定，推荐 **智能陪伴**，但仍然要说清楚它是"本地先消化，再上传摘要"。

### 第四步：运行初始化脚本

```bash
bash "{baseDir}/init-lobster.sh" \
  --personality "PERSONALITY" \
  --memory-mode "MEMORY_MODE"
```

如果当前运行环境已经知道当前会话来自哪个 IM 渠道与目标 ID，优先使用：

```bash
bash "{baseDir}/init-lobster.sh" \
  --personality "PERSONALITY" \
  --memory-mode "MEMORY_MODE" \
  --channel "CURRENT_CHANNEL" \
  --to "CURRENT_TARGET_ID"
```

按需追加：
- `--lobster-name "LOBSTER_NAME"`
- `--owner-nickname "OWNER_NICKNAME"`
- `--morning "HH:MM"`
- `--discovery "HH:MM"`
- `--evening "HH:MM"`

强约束：
- **不要再优先使用旧占位 `--nickname` / `--name` 来表达主客体。**
- 给虾起的名字只放 `--lobster-name`。
- 虾对用户的称呼只放 `--owner-nickname`。

执行要求：
- 如果用户是分几条消息把参数补齐的，运行脚本时要使用**累计后的最终参数**，不要只拿最后一条消息。
- 脚本执行后必须观察退出结果；如果失败，不要沉默或中断对话。
- 如果输出里出现 `无法自动检测投递目标`，而当前对话实际发生在飞书/Telegram/微信等 IM 渠道，优先改为显式携带 `--channel` / `--to` 再重试一次。
- 如果输出里出现 `[log] file:` 或 `[log] inspect:`，要把该日志路径作为排查依据告诉用户。

### 第五步：告诉用户初始化结果

必须告诉用户：

1. 共情虾名字
2. 推送时间
3. 当前理解模式
4. 这个模式之后随时能改

如果初始化脚本最后输出的 `INIT_RESULT_JSON` 里：
- `success=true` 且 `cron_registered=true`：按"初始化完成"回复
- `success=true` 且 `cron_registration_status=pending_activation`：明确告诉用户**虾已经创建成功**，只是当前企业微信会话还缺少投递目标（群聊 `group_space` 或私聊 `sender_id`），所以定时推送尚未注册；提示用户回到企业微信当前会话里重试，或让 skill 重新从 inbound metadata 读取后再执行一次；**不要**把它描述成"初始化失败"
- `success=true` 且 `cron_registered=false` 且 `cron_registration_status` 不是 `pending_activation`：明确告诉用户**虾已经创建成功**，只是定时推送注册暂时失败，稍后补跑 `setup-cron.sh` 即可；**不要**把它描述成"后端整体不可用"或"初始化失败"
- `reused_existing=true`：告诉用户本次复用了已有的虾，没有重复创建

如果 `INIT_RESULT_JSON` 里有：
- `studio_web_url`
- `studio_link_expires_at`

那么在初始化结果里**必须明确告诉用户如何查看工作室**，而不是只说"我以后可以带你进去"。推荐写法：

> 你现在就可以去看看{lobster_name}：{studio_web_url}
> 这个入口是短时有效的，到期我可以再给你刷新。

补充要求：
- 可以输出 `studio_web_url` 这种**短时** studio link
- 不要输出长期 bearer token，也不要手工拼长期 token URL
- 如果 `studio_web_url` 暂时缺失，要明确告诉用户：
  > 你之后随时对我说"看看我的共情虾"或"给我工作室链接"，我会用短时入口带你进去。
- 不要让用户在初始化成功后还不知道该如何查看工作室

## 冷启动记忆

### Memory 文件导入（需用户显式同意）

**⚠️ 隐私约束**：以下文件只有在用户**明确口头同意**后才可以读取。未经同意绝对不可以自动读取。

只有在用户明确同意时，才可以读取这些文件：

```bash
for f in ~/.openclaw/workspace/USER.md ~/.openclaw/workspace/MEMORY.md ~/.openclaw/agents/main/USER.md ~/.openclaw/agents/main/MEMORY.md; do
  [ -f "$f" ] && echo "FOUND: $f"
done
```

读取前先告诉用户找到了哪些文件，并明确说"要不要导入这些旧记忆来更快认识你"。

### 日常聊天记忆

用户在和共情虾聊天时主动说出的事情，可以注入：

```bash
curl -s -X POST "https://nixiashuo.com/api/memory/ingest" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d "{
    \"user_id\": \"{user_id}\",
    \"memory_text\": \"从用户与共情虾的对话中了解到：{提炼后的信息}\",
    \"source\": \"openclaw_chat\"
  }"
```

注入时要保持透明，例如：
- "好嘞，这个我记住了"
- "嗯，这句我收下了"

## 已有虾的交互

### 企业微信定时推送 —— 唯一推荐路径

如果用户说：
- "企业微信显示待激活，帮我补一下"
- "给我在企业微信里定时发一条消息"
- "企微定时通知怎么建才稳"

统一遵循下面这条路径，**不要再引导 webhook / bot / delivery 对抗式方案**：

1. 从当前对话的 inbound metadata 中确定投递目标：
   - **群聊**：用 `group_space` 作为目标（群聊 ID）
   - **私聊**：用 `sender_id`（个人 ID）
2. 如果是在初始化或补注册共情虾 cron，重新执行相关脚本时**必须**带上：

```bash
# 群聊场景：
bash "{baseDir}/setup-cron.sh" --to "GROUP_SPACE_ID" --wecom-user-id "CURRENT_SENDER_ID"
# 私聊场景：
bash "{baseDir}/setup-cron.sh" --to "CURRENT_SENDER_ID" --wecom-user-id "CURRENT_SENDER_ID"
```

3. 如果是在 skill 内创建"一次性企业微信定时通知"，标准做法是：
   - 先调用 `compute_timestamp` 生成 ISO-8601 触发时间；不要手算。
   - 再调用 cron tool 创建任务，`sessionTarget="isolated"`。
   - `payload.message` 里要求 isolated agent：
     1. 执行 `push-scheduled-message.sh --emit-message-text --slot <slot>` 获取最终消息文本
     2. 将 stdout 原文直接作为唯一回复输出，不要加前缀、解释或额外文字
     3. **不要调用 message 工具，不要尝试私信任何人**——回复文本会自动通过 cron delivery announce 投递到目标会话
   - 同时注册 cron 时带 `--channel openclaw-wecom-bot --to <delivery_target>` 作为 announce 投递目标（群聊用 `group_space`，私聊用 `sender_id`）。

标准示意：
- 群聊：`group_space -> delivery_target`；私聊：`sender_id -> delivery_target`
- `compute_timestamp(...) -> trigger_at`
- `cron.add`：`schedule.kind="at"`、`schedule.at=trigger_at`、`sessionTarget="isolated"`、`deleteAfterRun=true`
- `--channel openclaw-wecom-bot --to {delivery_target}`（announce 投递目标）
- `payload.message`：要求 agent 执行 `push-scheduled-message.sh --emit-message-text`，stdout 原文作为唯一回复

执行要求：
- 企业微信链路里**不要再推荐** `configure-wecom-delivery.sh`、`wecom-webhook`、`wecom-mcp`、`wecom-bot` 作为定时推送主方案。
- 如果当前缺少 `sender_id` 或 `group_space`，就明确告诉用户：需要回到企业微信当前会话里，让 skill 从 inbound metadata 读取到对应字段后再重试。
- 如果 cron / 脚本已经成功拿到投递目标，就按实际投递目标（群聊或私信）来回复，不要再提 webhook 补齐。

### 切换理解模式

如果用户说：
- "我想改理解模式"
- "别读聊天记录了"
- "切到更懂我的模式"

就重新提供三档选择：

1. 轻量陪伴：只记直接对共情虾说的话
2. 智能陪伴：本地消化 transcript，再上传摘要
3. 深度陪伴：上传原始 transcript 做更细消化

执行方式：

```bash
bash "{baseDir}/setup-cron.sh" --memory-mode lightweight
bash "{baseDir}/setup-cron.sh" --memory-mode smart
bash "{baseDir}/setup-cron.sh" --memory-mode deep
```

### 查看工作室链接（强约束）

如果用户说：
- "给我工作室链接"
- "给我发一个旺仔3号的工作室的链接"
- "看看我的共情虾"
- "打开工作室"
- "发我工作室入口"

必须先执行：

```bash
bash "{baseDir}/send-studio-link.sh"
```

执行要求：
- **必须实时执行脚本获取 fresh link**，不要引用历史对话里出现过的 URL
- **必须直接使用脚本 stdout 里的链接**，不要自己手工拼接 `/lobster/{user_id}?st=...`
- 不要声称"还是短期 st 链接"然后自己编一个 `st`
- 如果脚本失败，明确告诉用户"我刚刷新短链失败了，我再试一次"或报告错误，不要伪造链接

### 查看状态 / 生成一句话 / 查看记忆

继续使用现有 API：

```bash
curl -s -H "Authorization: Bearer {access_token}" \
  "https://nixiashuo.com/api/lobster/{user_id}/status"
```

```bash
curl -s -X POST "https://nixiashuo.com/api/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d "{\"user_id\":\"{user_id}\",\"message_type\":\"event\"}"
```

```bash
curl -s -H "Authorization: Bearer {access_token}" \
  "https://nixiashuo.com/api/lobster/{user_id}/memory"
```

### 截图请求处理（强约束）

只要用户提到"发截图 / 看看共情虾在干嘛 / 状态+截图"，优先执行受控脚本：

```bash
bash "{baseDir}/send-current-screenshot.sh" --caption "这是{lobster_name}现在的样子~"
```

如果用户同时要状态摘要，用：

```bash
bash "{baseDir}/send-current-screenshot.sh" --with-status-summary
```

禁止做法：
- 不要手工拼接长期 token URL
- 不要输出 `screenshot_base64` 或本地临时文件路径
- 不要绕过脚本自己实现截图发送流程

## Transcript digest 的规则

- `lightweight`：不注册 `lobster-says-digest`
- `smart`：注册 digest，但必须用 `bash "{baseDir}/digest-transcript.sh" --mode smart`
- `deep`：注册 digest，并用 `bash "{baseDir}/digest-transcript.sh" --mode deep`

### 三档模式的真实边界

| 模式 | 共情虾能感知什么 |
|------|-------------|
| `lightweight` | 只知道用户直接对共情虾说的话，以及用户同意导入的 memory 文件 |
| `smart` | 能感知最近整体聊天状态，但默认只把本地提炼后的摘要、标签、时间模式上传 |
| `deep` | 能感知更完整的 transcript 细节，理解力最强 |

## 安全与合规要求

- 不要把 transcript 能力藏起来
- 不要写"只有用户主动担心时才提供选项"
- 不要把"默认深度读取"包装成唯一正确选择
- 不要在对话中输出 access token
- 不要输出长期带 token URL
- 对截图、图片、工作室访问，优先使用受控脚本或受控服务端入口
- 工作室访问统一走短时 studio link（`/api/lobster/{user_id}/studio-link`），不要回退到长期 token URL