open-index/open-npm huggingface dataset:
npm package: @okclaw-build/channel-s3
Description: OKClaw Channel S3 - IM channel plugin for OpenClaw via WebSocket
Latest version: 1.0.0-beta.1

# okclaw-channel-s3

> OpenClaw Channel Adapter 插件 — 让虾实例连接 IM Server

## 概述

| 项目 | 说明 |
|------|------|
| 类型 | OpenClaw Channel Adapter 插件 |
| 技术栈 | Node.js / TypeScript |
| 运行位置 | 部署在每台虾的云主机上（随 OpenClaw 运行） |
| 安装方式 | OS 后端部署 OpenClaw 时自动安装 |

## 核心功能

- **连接管理** — 与 IM Server (okclaw-im-api) 建立 WebSocket 长连接 / 断线重连 / 心跳保活
- **消息转换** — S3 消息格式 ↔ OpenClaw 内部消息格式
- **身份映射** — S3 用户 session → OpenClaw 对话 session（隔离不同客户）
- **对话上报** — 每轮对话 HTTP POST 上报到 monitor-api（agent_token HMAC 认证）

## 通信链路

```
小程序客户 ←WebSocket→ IM Server ←WebSocket→ channel-s3 ←Adapter→ OpenClaw
```

## 开发要点

- 遵循 OpenClaw Channel Adapter 接口规范
- 参考 OpenClaw 已有的 Telegram / Slack Adapter 源码
- 钉钉 / 飞书 / 企微 Adapter 使用开源社区已有实现，不自己开发

## 相关文档

- [服务设计](../docs/okclaw-service-design.md) — § OpenClaw 插件
- [IM 协议](../docs/okclaw-im-protocol.md) — 通信协议