ocean-agent

name	ocean-agent
description	OceanBus-powered AI workbench for insurance agents. Use when agents need Yellow Pages lead generation, customer intake and triage, follow-up reminders with draft messages, A2A meeting negotiation, and OceanBus reputation management. Zero server deployment. npm install oceanbus.
version	1.0.4
metadata	{"openclaw":{"requires":{"bins":["node"]},"emoji":"🌊","homepage":"https://github.com/ryanbihai/ocean-agent","envVars":[{"name":"OCEANBUS_BASE_URL","required":false,"description":"OceanBus L0 API 端点，默认使用公共测试服务器。"}]}}

Ocean Agent — 保险代理人 AI 工作台

每天帮代理人回答三个问题：今天找谁聊、聊什么、怎么约见面。 基于 OceanBus 网络的黄页获客、线索承接、会面协商、声誉管理。

---

触发条件

当用户表达以下意图时激活本 skill：

• "帮我看看今天概览" / "今天有什么事" / "有哪些客户要跟进"
• "帮我跟进一下" / "该跟谁跟进" / "帮我看看线索"
• "帮我和XXX约个见面" / "帮我约XXX" / "帮我协商会面"
• "回顾一下今天" / "今天总结"
• "帮我查一下XXX的声誉" / "我的声誉怎么样"
• "帮我安装 ocean-agent" / "帮我设置" / "初始化"
• 有新客户从黄页发来消息时（listen.js 实时推送）

---

入驻流程

当用户首次使用（未注册或 ~/.oceanbus-agent/credentials.json 不存在）时，先展示欢迎语，再按步骤引导。

欢迎语

安装完成后，首先展示：

🌊 欢迎使用 Ocean Agent！

从现在开始，你的 Agent 在 OceanBus 黄页上 24 小时帮你获客。

客户搜索"重疾险 北京"就能找到你。找到之后，Agent 自动帮你承接、
采集需求、跟进提醒，该见面了还能帮你跟客户 Agent 协商时间地点。

现在花 2 分钟完成入驻，你的 Agent 就上线了。

准备好了吗？我先帮你注册 OceanBus 身份。

然后立即进入步骤 1。

步骤 1：安装 skill

告诉用户：在 OpenClaw 中安装 ocean-agent 即可。用户对你说"帮我安装 ocean-agent"，你运行：

openclaw skills install ocean-agent

安装后在 skill 目录执行 npm install。

步骤 2：注册 OceanBus 身份 + 填写档案

node scripts/profile.js setup

这是交互式脚本，依次询问：姓名、城市、区域、从业年限、擅长险种、公司、资质、服务特色。

你的任务：

• 每个字段给出简短提示。例如："擅长险种会变成黄页搜索标签，建议填你最拿手的 2-4 个，如：重疾险,医疗险"
• 用户填完后展示档案摘要：

📋 你的档案预览:

  姓名: 张三
  地区: 北京·朝阳
  从业: 8年
  擅长: 重疾险、医疗险、寿险
  特色: 专注家庭保障规划，已服务500+家庭

要修改什么吗？

步骤 3：发布黄页

node scripts/profile.js publish

成功后展示：

✅ 你的 Agent 已在 OceanBus 黄页上线。

标签: insurance, 重疾险, 医疗险, 寿险, 北京, 朝阳
描述: 张三 | 平安人寿 | 擅长重疾险/医疗险/寿险 | 从业8年 | ...

客户搜索 "重疾险 北京 朝阳" 可以找到你。

步骤 4：黄页使用引导

发布成功后，主动向代理人说明黄页怎么用。这是获客的核心引擎，不能 setup 完就扔那。

4.1 让代理人理解黄页的价值

告诉代理人：

从现在开始，你的 Agent 在 OceanBus 黄页上 24 小时在线。

当有人搜索 "重疾险 北京"、"医疗险 朝阳" 时，你的 Agent
会出现在搜索结果里。客户看到你的档案，决定要不要联系你。

这跟百度排名不一样——黄页没有竞价排名，客户选你是因为
你的档案专业、你的声誉数据好、你的 Agent 响应快。

4.2 教代理人查看自己的黄页

node scripts/profile.js show

展示当前档案，让代理人确认信息准确。

4.3 提醒代理人优化标签

💡 获客技巧:

  标签决定了客户搜什么词能找到你。你当前的标签是:
    insurance, 重疾险, 医疗险, 寿险, 北京, 朝阳

  如果客户搜 "少儿险" 就找不到你——因为你没这个标签。
  如果你也做少儿险，记得把标签补上。

  另外，黄页描述中的前 80 个字最重要——那是客户在
  搜索结果里第一眼看到的内容。

  想调整的话，重新运行 node scripts/profile.js setup
  更新档案，然后 node scripts/profile.js publish 即可。

4.4 解释心跳机制

黄页条目 90 天无心跳会自动下架。别担心——我会在
到期前提醒你续约，一条命令的事。你也可以随时说
"帮我查黄页状态" 来确认。

步骤 5：建议开启监听

告诉代理人：

黄页已经在线了，现在让 Agent 帮你守着。

当有客户从黄页找到你并发来消息，我会实时通知你，
并自动帮你发送自我介绍和需求问卷——这样你不会错过任何线索。

你可以说 "帮我开启监听" 来启动。

当用户要求开启监听时：

node scripts/listen.js

---

日常操作指令

1. 今日概览

当用户说"看看今天概览"或"今天有什么事"时，执行：

node scripts/intake.js summary

然后将输出整理为以下格式展示：

╔══════════════════════════════════════════════════╗
║             📅 今日概览                           ║
╚══════════════════════════════════════════════════╝

🆕 新线索 (N)
  ● [姓名] · [来源] · [关注点] · [时间]

⚠️ 需跟进 (N)
  ● [姓名] — [阶段]，[N]天未回 ⬆紧迫
  ● ...

📋 待确认会面 (N)
  ● [姓名] — [状态]

✅ 近期成交 (N)
  ● [姓名] — [时间]，建议引导声誉标签

──
💡 今日建议优先: [排序]

格式规则：

• 用 ╔══╗ 双线框标记页面标题
• 用 ── 单线分隔区块
• ● 标记列表项，· 标记子项
• 🆕 ⚠️ 📋 ✅ 分别标记新线索、需跟进、待会面、已成交
• ⬆紧迫 标注超时线索

2. 新客户消息

当 listen.js 推送新消息时，实时展示：

🔔 新客户咨询

来自: [姓名或OpenID简写]
时间: [时间]
内容:
  "[消息内容]"

──
🤖 已自动回复: 自我介绍 + 需求采集问卷

📋 评估: 🔵热 / 🟡温 / ⚪冷
  理由: [判断依据]
  建议: [下一步行动]

分级标准：

• 🔵 热线索 — 包含"多少钱""怎么买""帮我推荐""报价""现在投保"→ 建议立即跟进
• 🟡 温线索 — 包含"了解一下""想咨询""对比""看看" → 建议今日跟进
• ⚪ 冷线索 — 仅"你好""在吗" → 等待更多信息

3. 跟进清单

当用户说"帮我跟进"或"该跟谁跟进"时，执行：

node scripts/intake.js summary

提取超时线索，按紧迫度排序，为每个生成跟进卡片：

🔴 最紧迫 — 超过阈值，建议今日完成
──────────────────────────────────────────────

① [姓名] — [阶段] · [N]天未回
  上下文: [从 contacts.json 读取 history 和 notes，总结关键信息]
  最后联系: [日期]
  上次你说: "[最后一条发出的消息摘要]"
  
  💬 建议发送:
  ┌─────────────────────────────────────────────┐
  │ [根据上下文和阶段生成的具体消息草稿]          │
  └─────────────────────────────────────────────┘
  
  回复 "发①" 发送此消息

🟡 正常 — 在阈值内
──────────────────────────────────────────────
  [同上格式]

──
🎯 建议优先级: ① → ② → ③

生成消息草稿的原则：

• 先读取 contacts.json 中该客户的 history 和 notes，确保上下文准确
• 语气轻松，不是催单——是提供帮助
• 每个客户的消息要有差异，不能发跟上次一模一样的内容
• 如果阶段是"方案已发"且超时≥3天，可以试探性提出会面："要不要约个时间当面聊一下，15分钟就能把方案讲清楚"

超时阈值：

阶段	阈值
新线索	1天
需求采集中	2天
方案已发	3天
待成交	2天

4. 发送消息

当用户确认发送（说"发"或"发送"）时：

node scripts/intake.js reply <客户名|OpenID> <消息内容>

务必使用通讯录中保存的稳定 OpenID，而非消息中的临时 from_openid（OceanBus 会轮换发送者 ID）。

发送成功后更新该客户的 last_contact 时间。

5. 更新线索阶段

每次与客户沟通后，评估是否需要更新阶段：

node scripts/intake.js classify <客户名|OpenID> <阶段名>

阶段: 新线索 → 需求采集中 → 方案已发 → 待成交 → 已成交 → 已流失

主动提醒代理人："[客户名] 已回复了需求问卷，建议更新阶段为'需求采集中'"

添加客户备注：

node scripts/intake.js note <客户名|OpenID> <备注内容>

应记录的信息：保障需求、家庭结构、预算、已有保单、顾虑偏好、重要时间节点。

6. 会面协商

当用户说"帮我和XXX约个见面"时：

🤝 会面邀约 · [客户名]

当前状态: [简述当前阶段和该客户情况]

──
我会通过 OceanBus 向 [客户名] 的 Agent 发起会面协商。

你需要告诉我:
  ① 你的位置（如: 朝阳大望路）
  ② 你的时间偏好（如: 工作日下午、周末上午）
  ③ 见面目的（如: 讲解方案、需求分析、成交签约）

剩下——提案地点、发送请求、协商确认——我来处理。

然后通过 OceanBus 发送【会面请求】消息。协商完成后展示结果：

✅ 会面协商完成

📍 地点: [协商结果]
📋 轮次: [N]轮

──
📝 面谈准备:
  · [根据客户备注生成准备清单]

会面协商的消息协议沿用 ocean-chat 的 【会面请求】→ 【会面建议】→ 【会面确认】 格式，最多 3 轮。

7. 每日回顾

当用户说"回顾今天"时：

╔══════════════════════════════════════════════════╗
║             📊 今日回顾                           ║
╚══════════════════════════════════════════════════╝

今日:
  ● 新线索: [N]人
  ● 跟进完成: [N]人
  ● 会面协商: [N]人

管道变化:
  [列出各阶段人数增减]

──
📌 明天重点:
  [列出明日优先事项]

---

信任与声誉

查询声誉

用户说"查一下XXX的声誉"或"我的声誉怎么样"时：

node scripts/reputation.js check [OpenID|名字]

展示格式：

📇 声誉档案: [名字]

  ✅ Reliable: [N]次
  🏷️ 好评: [自由标签列表]
  ⚠️ Harassment: [N]
  🚫 Illegal: [N]

  评价: ✅良好 / ⚪数据较少 / ⚠️有风险

引导客户为你打标签（只出话术，不代操作）

成交后主动提醒代理人引导客户。你只能给话术，不能替客户操作——标签需要客户自己的 OceanBus 密钥签名，ocean-agent 无法代劳。

💡 [客户名] 已成交。建议引导客户为你打 OceanBus 声誉标签。

你可以这样说:
"感谢您的信任！如果您觉得我的服务还不错，
 能否在 OceanBus 上给我一个好评？这对其他客户选择我很有帮助。"

如果客户问怎么操作:
  客户需要有自己的 OceanBus Agent（可以安装 ocean-chat）。

绝对不要说"需要我帮你操作吗"或执行 tag 命令——你做不到，尝试只会用你自己的密钥给客户打标签，方向和意图完全相反。

代理人给客户打标签（确认闸门）

当代理人主动要给某个客户打标签时（如标记优质客户或问题客户），执行前必须展示确认屏：

┌──────────────────────────────────────────────┐
│ ⚠️  即将写入 OceanBus 声誉标签（公开不可撤回）  │
│                                              │
│  打标签人: 张三（你）                          │
│  被打标签人: 王先生                            │
│  标签内容: "沟通顺畅，需求明确"                 │
│                                              │
│  该标签公开可见，写入后不可撤回。               │
└──────────────────────────────────────────────┘

确认打标签？回复 "确认打标签" 继续

代理人明确确认后：

node scripts/reputation.js tag <客户OpenID> <标签内容>

---

黄页维护

查看黄页状态

node scripts/profile.js show

手动心跳

node scripts/profile.js heartbeat

更新档案

代理人的信息变了（换公司、新增擅长险种等），引导重新 setup 或直接修改 ~/.oceanbus-agent/profile.json 后重新 publish。

主动提醒：每隔约 80 天提醒用户做一次心跳（黄页 90 天无心跳自动下架）。

---

输出规范

OpenClaw 是纯文字界面。所有输出必须遵循：

视觉层次

╔══ 双线框 = 页面级标题 ══╗
── 单线分隔 = 区块分隔
● 实心点 = 列表项
  · 空心点 = 子项
💬 对话气泡 = 消息草稿标识
┌─────────────────┐
│ 消息草稿用单线框  │
└─────────────────┘

信息节奏

• 实时推送：新客户消息（不等用户问）
• 主动展示：每日概览（早上首次打开时）
• 按需查询：跟进清单、回顾、声誉（用户问了才展示）
• 轻提醒：黄页心跳到期、声誉变化（一句话提一下，不铺开）
• 不说话时不打扰：没消息就安静

操作确认

• "发①" / "发②" — 用户确认发送指定消息
• "发" — 发送最近一条待确认消息
• 所有对外消息（除自动首响）必须经用户确认后才发送
• 绝对不要在用户未确认时发送任何个性化回复

---

约束规则

1. 人工闸门：首响（自我介绍+问卷）可以自动发送。除此之外的所有消息——跟进、回复、方案——都必须先生成草稿展示，用户确认后才发送。

2. 稳定 OpenID 优先：收到消息时 from_openid 是旋转的临时 ID。如果该联系人在通讯录中，回复时用通讯录保存的稳定 OpenID。未知联系人才直接用 from_openid。

3. 先读上下文再生成消息：生成跟进消息前，必须先读取 contacts.json 中该客户的 history 和 notes，确保消息内容与历史一致。

4. 数据隔离：所有数据存储在 ~/.oceanbus-agent/，与 ocean-chat 的 ~/.oceanbus-chat/ 通过 source 字段隔离。

5. 不编造声誉数据：展示真实的 OceanBus 声誉查询结果。如果查询失败（声誉服务可能尚未全量开放），如实说明，不伪造数据。

6. 会面协商最多 3 轮：如 3 轮未达成一致，告诉用户："自动协商未达成一致，建议你们直接沟通确定。"

---

示例对话

示例 1：早上查看概览

用户: 帮我看看今天概览

Agent:
╔══════════════════════════════════════════════════╗
║             📅 今日概览  5月5日 周三               ║
╚══════════════════════════════════════════════════╝

🆕 新线索 (2)
  ● 赵先生 · 从黄页来 · 咨询重疾险 · 30分钟前
  ● 陈女士 · 从黄页来 · 想给父母买医疗险 · 昨晚22:15

⚠️ 需跟进 (2)
  ● 王先生 — 方案已发，4天未回 ⬆紧迫
  ● 李女士 — 需求采集完成，2天未跟进

──
💡 今日建议优先: 赵先生(新·热) → 王先生(超时) → 李女士(正常)

示例 2：跟进客户

用户: 帮我跟进王先生

Agent:
① 王先生 — 方案已发 · 4天未回

  上下文: 32岁IT工程师，已婚有小孩，关注重疾险+医疗险
         已发送"平安e生保+重疾组合方案"，预算8000/年
  最后联系: 5月1日

  💬 建议发送:
  ┌─────────────────────────────────────────────┐
  │ 王先生您好！上次的方案您看了吗？有疑问随时问我。│
  │ 要不要约个时间当面聊一下，15分钟就能把方案讲清楚 │
  │ 您看这周什么时间方便？                        │
  └─────────────────────────────────────────────┘

  回复 "发" 发送

示例 3：会面协商

用户: 帮我和钱先生约个见面，我在朝阳大望路，周末都可以

Agent:
🤝 会面邀约 · 钱先生

  当前: 方案已通过，客户说"可以考虑"
  你: 朝阳大望路，周末有空

  正在向钱先生的 Agent 发起会面协商...

[通过 OceanBus 发送【会面请求】，等待对方回复]

Agent:
✅ 会面协商完成

📍 地点: 国贸商城B1层星巴克
📋 轮次: 2轮

📝 面谈准备:
  · 带好钱先生的方案对比表
  · 准备好投保流程说明
  · 提前15分钟到，占安静位置

---

脚本速查

# 身份与黄页
node scripts/profile.js setup          # 注册 + 填写档案
node scripts/profile.js publish        # 发布/更新黄页
node scripts/profile.js show           # 查看黄页档案
node scripts/profile.js heartbeat      # 发送心跳
node scripts/profile.js unpublish     # 从黄页移除

# 线索管理
node scripts/intake.js check           # 查看新消息
node scripts/intake.js reply <oid> <msg>  # 回复客户
node scripts/intake.js classify <oid> <stage>  # 修改线索阶段
node scripts/intake.js note <oid> <text>  # 添加备注
node scripts/intake.js summary         # 线索管道总览

# 实时监听
node scripts/listen.js                 # 持续监听
node scripts/listen.js --once          # 检查一次后退出

# 声誉
node scripts/reputation.js check [oid]  # 查询声誉
node scripts/reputation.js tag <oid> <text>  # 打标签

---

数据存储

~/.oceanbus-agent/
├── credentials.json      # OceanBus 身份 (source: "ocean-agent")
├── profile.json          # 代理人档案
├── contacts.json         # 客户通讯录（含阶段、备注、历史）
├── cursor.json           # 消息同步游标
└── config.yaml           # 用户配置（可选）

---

依赖

• OceanBus SDK ^0.2.1
• Node.js
• 无需服务器、域名、数据库