@soimy/openclaw-channel-powpow — PowPow 地图实时通信渠道插件

Name: @soimy/openclaw-channel-powpow — PowPow 地图实时通信渠道插件
Author: durenzidu

durenzidu

代码插件安全

@soimy/openclaw-channel-powpow — PowPow 地图实时通信渠道插件

v1.0.0

该插件为 OpenClaw 提供了与 PowPow 地图平台的实时双向通信能力，支持 WebSocket 基础的消息传递、流式输出、多媒体消息、自动重连、消息队列、多实例支持以及访问控制（白名单/黑名单）等功能，适用于需要与 PowPow 数字人进行实时交互的开发场景。

0· 0·0 当前

by @durenzidu·ClawHub

开发工具实时通信数据与API 安全自动化网络工具

下载插件包项目主页

License

ClawHub

最后更新

2026/4/8

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

该插件的代码、README 和运行指令与基于 WebSocket 的 OpenClaw Channel 一致，用于连接 PowPow 服务，不请求无关凭证，也不安装异常的第三方二进制文件。

安全有层次，运行前请审查代码。

License

ClawHub

请查看许可证条款了解详情。

查看条款 ↗

版本

latestv1.0.02026/4/8

● 无害

安装命令点击复制

官方npx clawhub@latest install @soimy/openclaw-channel-powpow

镜像加速npx clawhub@latest install @soimy/openclaw-channel-powpow --registry https://cn.clawhub-mirror.com

插件文档

PowPow 地图实时通信渠道插件，用于 OpenClaw 与 PowPow 数字人的双向实时消息传递。

功能特性

✅ 实时通信 - 基于 WebSocket 的双向实时消息传输
✅ 流式输出 - 支持 AI 流式回复，实时传递
✅ 多媒体支持 - 文本、图片、语音、视频消息
✅ 自动重连 - 连接断开后自动重连（指数退避）
✅ 消息队列 - 离线时消息自动排队
✅ 多实例支持 - 支持多个数字人同时在线
✅ 访问控制 - 支持白名单/黑名单策略
✅ Markdown 支持 - 支持 Markdown 格式回复

安装

openclaw plugins install @soimy/openclaw-channel-powpow

或者从源码安装：

git clone https://github.com/soimy/openclaw-channel-powpow.git
cd openclaw-channel-powpow
npm install
npm run build
openclaw plugins install -l .

快速开始

1. 使用 CLI 配置

openclaw configure --section channels

2. 手动配置

在 ~/.openclaw/openclaw.json 中添加配置：

{
  "channels": {
    "powpow": {
      "enabled": true,
      "accounts": [
        {
          "id": "account_001",
          "digitalHumanId": "your-digital-human-id",
          "name": "OpenClaw 助手",
          "wsUrl": "wss://global.powpow.online:8080",
          "dmPolicy": "open",
          "messageType": "markdown"
        }
      ],
      "advanced": {
        "autoReconnect": true,
        "reconnectInterval": 3000,
        "maxMessageLength": 2000,
        "enableStreaming": true,
        "debug": false
      }
    }
  }
}

3. 重启 OpenClaw

openclaw gateway restart

配置说明

...（**省略大量配置说明、使用示例、消息类型支持、访问策略、故障排查、开发、架构说明、与 Skill 的区别、许可证、贡献、联系方式等内容，仅保留上述必要翻译部分）...

OpenClaw PowPow Channel Plugin

PowPow 地图实时通信渠道插件，用于 OpenClaw 与 PowPow 数字人的双向实时消息传递。

功能特性

✅ 实时通信 - 基于 WebSocket 的双向实时消息传输
✅ 流式输出 - 支持 AI 流式回复，实时传递
✅ 多媒体支持 - 文本、图片、语音、视频消息
✅ 自动重连 - 连接断开后自动重连（指数退避）
✅ 消息队列 - 离线时消息自动排队
✅ 多实例支持 - 支持多个数字人同时在线
✅ 访问控制 - 支持白名单/黑名单策略
✅ Markdown 支持 - 支持 Markdown 格式回复

安装

openclaw plugins install @soimy/openclaw-channel-powpow

或者从源码安装：

git clone https://github.com/soimy/openclaw-channel-powpow.git
cd openclaw-channel-powpow
npm install
npm run build
openclaw plugins install -l .

快速开始

1. 使用 CLI 配置

openclaw configure --section channels

2. 手动配置

在 ~/.openclaw/openclaw.json 中添加配置：

{
  "channels": {
    "powpow": {
      "enabled": true,
      "accounts": [
        {
          "id": "account_001",
          "digitalHumanId": "your-digital-human-id",
          "name": "OpenClaw 助手",
          "wsUrl": "wss://global.powpow.online:8080",
          "dmPolicy": "open",
          "messageType": "markdown"
        }
      ],
      "advanced": {
        "autoReconnect": true,
        "reconnectInterval": 3000,
        "maxMessageLength": 2000,
        "enableStreaming": true,
        "debug": false
      }
    }
  }
}

3. 重启 OpenClaw

openclaw gateway restart

配置说明

账号配置 (accounts)

字段	类型	必填	说明
`id`	string	是	账号唯一标识
`digitalHumanId`	string	是	PowPow 数字人 ID
`name`	string	是	账号名称
`wsUrl`	string	否	WebSocket 地址，默认 `wss://global.powpow.online:8080`
`dmPolicy`	string	否	私聊策略：`open`/`allowlist`/`blocklist`，默认 `open`
`allowFrom`	string[]	否	白名单/黑名单用户 ID 列表
`messageType`	string	否	消息类型：`text`/`markdown`，默认 `markdown`

高级配置 (advanced)

字段	类型	默认值	说明
`autoReconnect`	boolean	`true`	自动重连
`reconnectInterval`	number	`3000`	重连间隔（毫秒）
`maxReconnectAttempts`	number	`10`	最大重连次数
`maxMessageLength`	number	`2000`	最大消息长度
`enableStreaming`	boolean	`true`	启用流式输出
`enableCards`	boolean	`false`	启用 AI 卡片（实验性）
`debug`	boolean	`false`	调试模式（详细日志）

使用示例

单账号配置

{
  "channels": {
    "powpow": {
      "enabled": true,
      "accounts": [
        {
          "id": "dh_main",
          "digitalHumanId": "your-digital-human-id",
          "name": "主数字人",
          "dmPolicy": "open"
        }
      ]
    }
  }
}

多账号配置

{
  "channels": {
    "powpow": {
      "enabled": true,
      "accounts": [
        {
          "id": "dh_001",
          "digitalHumanId": "dh_id_001",
          "name": "客服助手",
          "dmPolicy": "open"
        },
        {
          "id": "dh_002",
          "digitalHumanId": "dh_id_002",
          "name": "导游助手",
          "dmPolicy": "allowlist",
          "allowFrom": ["user_vip_001", "user_vip_002"]
        }
      ]
    }
  }
}

白名单配置

{
  "channels": {
    "powpow": {
      "enabled": true,
      "accounts": [
        {
          "id": "dh_vip",
          "digitalHumanId": "your-digital-human-id",
          "name": "VIP 专属助手",
          "dmPolicy": "allowlist",
          "allowFrom": ["user_001", "user_002", "user_003"]
        }
      ]
    }
  }
}

消息类型支持

类型	支持	说明
文本	✅	支持 Markdown 格式
图片	✅	JPEG, PNG, GIF
语音	✅	MP3 格式
视频	✅	MP4 格式
AI 卡片	🚧	实验性支持

访问策略

open（开放）

允许所有用户发送消息

allowlist（白名单）

只允许指定用户发送消息

blocklist（黑名单）

拒绝指定用户发送消息

故障排查

连接失败

问题: 无法连接到 WebSocket

解决方案:

检查 wsUrl 配置是否正确
确认网络连接正常
检查防火墙设置
查看日志：openclaw logs | grep powpow

消息发送失败

问题: 消息发送失败

解决方案:

确认连接状态：openclaw status
检查数字人 ID 是否正确
查看错误日志

收不到消息

问题: 用户发送消息但没有响应

解决方案:

确认 Channel 已启用
检查访问策略配置
查看 OpenClaw AI 是否正常工作
检查 WebSocket 连接状态

开发

本地开发

# 克隆仓库
git clone https://github.com/soimy/openclaw-channel-powpow.git
cd openclaw-channel-powpow

# 安装依赖
npm install

# 构建
npm run build

# 类型检查
npm run type-check

# 监听模式
npm run dev

测试

# 运行测试
npm test

架构说明

┌─────────────────────────────────────────┐
│          OpenClaw Gateway               │
│    (会话管理、AI 路由、消息调度)          │
└──────────────┬──────────────────────────┘
               │
               ▼
┌─────────────────────────────────────────┐
│         PowPow Channel Plugin           │
├─────────────────────────────────────────┤
│  ┌─────────────────────────────────┐    │
│  │  Gateway (WebSocket 连接管理)    │    │
│  │  - 连接建立/断开                 │    │
│  │  - 自动重连                      │    │
│  │  - 心跳机制                      │    │
│  └─────────────────────────────────┘    │
│  ┌─────────────────────────────────┐    │
│  │  Messaging (消息处理)           │    │
│  │  - 入站消息标准化                │    │
│  │  - 出站消息发送                  │    │
│  │  - 访问控制                      │    │
│  └─────────────────────────────────┘    │
│  ┌─────────────────────────────────┐    │
│  │  Config (配置管理)              │    │
│  │  - 配置加载/验证                 │    │
│  │  - 账号管理                      │    │
│  └─────────────────────────────────┘    │
└──────────────┬──────────────────────────┘
               │
               ▼
┌─────────────────────────────────────────┐
│         PowPow 地图平台                  │
│    (WebSocket + REST API)               │
└─────────────────────────────────────────┘

与 Skill 的区别

功能	Channel 插件	Skill
实时通信	✅ 负责	❌ 不负责
消息路由	✅ 负责	❌ 不负责
AI 回复	✅ 负责	❌ 不负责
数字人创建	❌ 不负责	✅ 负责
位置控制	❌ 不负责	✅ 负责
地图交互	❌ 不负责	✅ 负责

简单说：

Channel = 通信员（负责传话）
Skill = 管理员（负责管理数字人）

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

联系方式

GitHub: @soimy
项目地址：https://github.com/soimy/openclaw-channel-powpow

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

版本

安装命令 点击复制

插件文档

功能特性

安装

快速开始

1. 使用 CLI 配置

2. 手动配置

3. 重启 OpenClaw

配置说明

OpenClaw PowPow Channel Plugin

功能特性

安装

快速开始

1. 使用 CLI 配置

2. 手动配置

3. 重启 OpenClaw

配置说明

账号配置 (accounts)

高级配置 (advanced)

使用示例

单账号配置

多账号配置

白名单配置

消息类型支持

访问策略

open（开放）

allowlist（白名单）

blocklist（黑名单）

故障排查

连接失败

消息发送失败

收不到消息

开发

本地开发

测试

架构说明

与 Skill 的区别

许可证

贡献

联系方式

安装命令点击复制