← Back to Skills Marketplace
ryanbihai

Ocean Desk

by ryanbihai · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
22
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ocean-desk
Description
OceanBus-powered B-end human agent desk for customer service teams. Use when handling customer inquiries, managing support tickets, assigning work to human a...
README (SKILL.md)

Ocean Desk — B 端坐席工单系统

Ocean Desk 是 ocean-chat 的上层扩展(类似 ocean-agent),为 B 端服务团队提供人工坐席工单管理。依赖 ocean-chat 的线程协议和 OceanBus SDK 的消息通道。

核心能力:工单队列、坐席分配、草稿/发送工作流、快捷回复模板、SLA 追踪。

两个依赖

  1. ocean-chat — 所有联系人管理和 P2P 消息通过 ocean-chat,本 Skill 不重复实现
  2. oceanbus SDK — Agent 身份注册、消息收发、线程协议

架构

AI Skill (health-checkup / doctor-referral)
    │ ocean-thread/v1 create (含结构化 payload)
    ▼
ocean-desk
    ├── tickets.js   — 工单 CRUD + 队列
    ├── agents.js    — 坐席名单 + round-robin 分配
    ├── templates.js — 快捷回复
    └── desk.js      — CLI 入口 + 实时监听
    │
    ▼
ocean-chat (threads.js + SDK)

触发条件

用户说 执行
"查看待处理工单" node scripts/desk.js queue
"看看这个工单的详情" node scripts/desk.js show \x3Cticket_id>
"把这个工单分给王客服" node scripts/desk.js assign \x3Cticket> \x3Cagent>
"帮客户起草回复" node scripts/desk.js draft \x3Cticket> \x3Cmsg>template use
"发送回复" node scripts/desk.js send \x3Cticket>
"关闭这个工单" node scripts/desk.js resolve \x3Cticket>
"今天的工单情况" node scripts/desk.js stats

工单工作流

AI Skill 创建线程 ──→ listener 自动创建工单 ──→ round-robin 分配坐席
                                                       │
                                                       ▼
                                              坐席查看 show
                                                       │
                                                       ▼
                                              起草回复 draft/template use
                                                       │
                                                       ▼
                                          【人工确认】发送 send ──→ ocean-thread/v1 reply
                                                       │
                                                       ▼
                                              关闭工单 resolve

命令速查

# 初始化
node scripts/desk.js setup                       # 注册 desk 身份

# 坐席管理
node scripts/desk.js agent add \x3C名字> \x3COpenID>    # 添加坐席
node scripts/desk.js agent list                   # 坐席名单
node scripts/desk.js agent toggle \x3Cid>            # 启用/停用
node scripts/desk.js agent remove \x3Cid>            # 移除坐席

# 工单
node scripts/desk.js queue [--agent \x3Cid>]         # 待处理工单
node scripts/desk.js show \x3Cticket_id>             # 工单详情(含 AI 上下文)
node scripts/desk.js assign \x3Cticket> \x3Cagent>      # 分配/转派
node scripts/desk.js draft \x3Cticket> \x3Cmsg>         # 起草回复
node scripts/desk.js send \x3Cticket>               # 发送回复
node scripts/desk.js resolve \x3Cticket>             # 关闭工单
node scripts/desk.js reopen \x3Cticket>             # 重开工单

# 模板
node scripts/desk.js template list                # 模板列表
node scripts/desk.js template use \x3Cid> \x3Cticket>   # 套用模板

# 运营
node scripts/desk.js stats                        # 今日工单统计
node scripts/desk.js listen                       # 实时监听新工单

工单上下文

AI Skill 创建线程时,通过 payload 字段透传上下文:

{
  "source_skill": "health-checkup-recommender",
  "customer_profile": { "name": "张先生", "age": 45, "city": "北京" },
  "ai_summary": "已完成项目推荐,客户要求协助预约",
  "recommended_actions": ["预约体检", "确认心血管增强项"],
  "conversation_log": [
    { "role": "ai", "text": "推荐套餐...", "time": "10:28" },
    { "role": "customer", "text": "帮我预约", "time": "10:29" }
  ],
  "priority": "normal"
}

show 命令会展示所有上下文。坐席不需要翻聊天记录就能了解客户情况。

约束规则

  1. 人类把关:所有回复必须先 draftsend,不允许直接发送
  2. 先看后回:回复前必须先 show 查看工单上下文和 AI 摘要
  3. SLA 提醒queue 显示每个工单的 SLA 截止时间,超时工单优先处理
  4. 不重复回复send 发送前检查是否已有草稿,避免重复
  5. 记录完整:每次 send 自动记录到 ticket.replies,关闭前确认所有回复已发送
Usage Guidance
This skill does not show evidence of hidden malicious behavior in the provided artifacts. Before installing for real customer support, configure a trusted OceanBus endpoint, protect the ~/.oceanbus-desk directory, install and review ocean-chat, and make sure staff verify drafts before running send.
Capability Analysis
Type: OpenClaw Skill Name: ocean-desk Version: 1.0.0 The ocean-desk skill is a legitimate customer service ticket management system designed for human-in-the-loop workflows. It manages tickets, agent assignments, and response templates, storing state locally in ~/.oceanbus-desk/ and communicating via the oceanbus SDK. The code logic in scripts/desk.js and scripts/tickets.js is consistent with its stated purpose, and the SKILL.md instructions provide clear, safety-oriented guidelines for the AI agent, such as requiring human confirmation before sending replies.
Capability Tags
cryptorequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The ticket queue, agent assignment, templates, SLA tracking, and reply workflow fit the stated customer-service desk purpose. Users should still notice that the skill can mutate tickets and send customer-facing messages.
Instruction Scope
The documented workflow requires show/draft before send and describes human confirmation, which is appropriate. The send command should be treated as a final customer communication action.
Install Mechanism
There is no automatic install spec, but README instructs manual npm install and package.json uses the oceanbus dependency. The skill also relies on the sibling ocean-chat skill, which is disclosed but not strongly enforced by metadata.
Credentials
The local data directory and OceanBus integration are proportionate to the service-desk purpose, but the default public test endpoint and stored customer context should be reviewed before real customer use.
Persistence & Privilege
The skill persists credentials, agent roster, tickets, templates, drafts, and customer context under ~/.oceanbus-desk. This is expected for a desk application but contains sensitive operational data.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ocean-desk
  3. After installation, invoke the skill by name or use /ocean-desk
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
首次发布。B端坐席工单系统:工单队列 + round-robin分配 + SLA追踪 + 快捷回复模板 + AI上下文透传。基于ocean-chat的ocean-thread/v1线程协议,为体检推荐、专家推荐等AI skill提供人工坐席转接能力。
Metadata
Slug ocean-desk
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Ocean Desk?

OceanBus-powered B-end human agent desk for customer service teams. Use when handling customer inquiries, managing support tickets, assigning work to human a... It is an AI Agent Skill for Claude Code / OpenClaw, with 22 downloads so far.

How do I install Ocean Desk?

Run "/install ocean-desk" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ocean Desk free?

Yes, Ocean Desk is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Ocean Desk support?

Ocean Desk is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ocean Desk?

It is built and maintained by ryanbihai (@ryanbihai); the current version is v1.0.0.

💬 Comments