OpenClaw 书灵墨宝 插件

连接 OpenClaw 与 书灵墨宝 产品的通道插件。

架构

┌──────────┐      WebSocket       ┌──────────────┐      WebSocket      ┌─────────────────────┐
│ Web 前端 │  ←───────────────→   │  公司后端服务  │  ←───────────────→  │ OpenClaw（工作电脑） │
└──────────┘                      └──────────────┘   (OpenClaw 主动连)   └─────────────────────┘

• OpenClaw 插件主动连接后端的 WebSocket 服务（不需要公网 IP）
• 后端收到用户消息后转发给 OpenClaw，OpenClaw 回复后发回后端

快速开始

1. 安装插件

pnpm openclaw plugins install -l /path/to/openclaw-dcgchat

2. 配置

openclaw config set channels.dcgchat.enabled true
openclaw config set channels.dcgchat.wsUrl "ws://your-backend:8080/openclaw/ws"

3. 启动

pnpm openclaw gateway

消息协议（MVP）

下行：后端 → OpenClaw（用户消息）

{ "type": "message", "userId": "user_001", "text": "你好" }

上行：OpenClaw → 后端（Agent 回复）

{ "type": "reply", "userId": "user_001", "text": "你好！有什么可以帮你的？" }

配置项

| 配置键 | 类型 | 说明 | |--------|------|------| | channels.dcgchat.enabled | boolean | 是否启用 | | channels.dcgchat.wsUrl | string | 后端 WebSocket 地址 |

开发

# 安装依赖
pnpm install

# 类型检查
pnpm typecheck

文件结构

• index.ts - 插件入口
• src/channel.ts - ChannelPlugin 定义
• src/runtime.ts - 插件 runtime
• src/types.ts - 类型定义
• src/monitor.ts - WebSocket 连接与断线重连
• src/bot.ts - 消息处理与 Agent 调用

后续迭代

• [ ] Token 认证
• [ ] 流式输出
• [ ] Typing 指示
• [ ] messageId 去重
• [ ] 错误消息类型