安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install powwow-agent
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 powwow-agent。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

PowPow Agent 是一项 Openclaw Skills 集成，用于在 PowPow 地图上注册、验证身份、创建和管理数字人。访客可以在某个地点发现智能体，并通过数字人的聊天功能交换消息。
该技能充当账户访问、数字人创建、状态检查、徽章、订阅、聊天记录和手动回复的管理控制层。如需持续通信，可搭配 PowPow 频道插件使用；该插件会轮询访客消息，并通过 OpenClaw 智能体转发回复。

应用场景

将 OpenClaw 智能体发布为 PowPow 地图上可被发现的数字人。
创建基于地点的助手，例如旅行向导、本地专家或社区代表。
查看访客对话记录，并通过命令行手动发送回复。
通过 PowPow 频道插件让数字人持续在线。
监控账户状态、徽章余额、数字人记录和到期状态。
使用 HEARTBEAT.md 定期检查未回复的访客消息，无需安装频道插件。
使用开放、允许列表、配对或禁用策略控制私信访问。

工作原理

运行注册命令，获取基于浏览器的 PowPow 注册流程；通常只需完成一次注册。
使用命令行凭据或 POWPOW_USERNAME 和 POWPOW_PASSWORD 环境变量向 PowPow 验证身份。
该技能会将身份验证凭据保存在本地 credentials.json 中，并使用会话令牌发送 API 请求。
使用名称、描述、位置和可选头像 URL 创建数字人。平台要求提供头像，因此未提供自定义头像时会使用平台默认标志。
创建流程会消耗两个徽章、生成 webhookToken，并输出频道安装和配置指南。
使用返回的 digitalHumanId 和 webhookToken 安装并配置 PowPow 频道插件，以实现自动化、持续在线的消息处理。
插件大约每三秒轮询一次传入消息，并通过 webhook 回传智能体回复；访客通常会在大约三秒内看到回复。
使用 status、list、chat history 和 chat send 命令检查部署情况或手动回复。
如果使用定时轮询而非频道插件，可选用 HEARTBEAT.md 添加任务，每 15 分钟检查新消息。

配置指南

前置条件：
Node.js 18 或更高版本。
通过浏览器注册流程创建的 PowPow 账户。
无需执行 npm install，因为这些脚本没有外部 Node.js 依赖项。
快速开始：

通过基于浏览器的 PowPow 流程注册

node scripts/powwow.js register

登录并保存本地凭据

node scripts/powwow.js login --username --password

创建地图数字人

node scripts/powwow.js create --name "My Digital Human" --description "A friendly local travel guide" --locationName "Beijing"
如需持续通信，请安装配套的频道插件：
openclaw plugins install @durenzidu/openclaw-channel-powpow
create 命令会输出频道配置所需的值。典型的 OpenClaw 配置如下：
{
"channels": {
"powpow": {
"enabled": true,
"digitalHumanId": "",
"webhookToken": "",
"dmPolicy": "open",
"pollIntervalMs": 3000
}
}
}
支持的环境变量包括 POWPOW_USERNAME、POWPOW_PASSWORD 和 POWPOW_API_BASE。API base 默认为 https://global.powpow.online。令牌大约 24 小时后过期，因此当 HTTP 401 响应表明会话已过期时，请重新登录。

数据架构

该技能将本地数据和平台数据组织为以下记录：
数据或元数据 用途
credentials.json 保存本地 PowPow 身份验证凭据，以及集成所需的已生成 webhook 数据。请将此文件作为机密妥善保护。
POWPOW_USERNAME 可选账户邮箱或用户名，用于替代登录标志参数。
POWPOW_PASSWORD 可选账户密码，用于替代登录标志参数。
POWPOW_API_BASE 可选 API 端点覆盖值；默认为 https://global.powpow.online。
digitalHumanId 已创建地图数字人的平台标识符。频道插件和聊天命令都需要此标识符。
webhookToken 创建过程中生成的令牌，频道插件使用它来发送回复。
数字人资料 包括名称、描述、头像、纬度、经度、位置名称、生命周期状态和到期信息。
徽章余额 跟踪用于创建和续订数字人的点数。创建需消耗两个徽章；续订每 30 天需消耗一个徽章。
聊天记录 与数字人关联的访客消息，可通过 chat --action history 查询。
访客身份 平台提供的 sender_id，用于访客级消息处理和访问策略。
频道策略 dmPolicy 可以是 open、allowlist、pairing 或 disabled。
数字人默认有效期为 30 天，到期后可能会自动离线。基本功能无需付费订阅。可选的 PREMIUM 套餐通过浏览器中的 PayPal 在外部办理；此技能不会处理付款信息。

高级特性

支持配套频道插件，实现持续、自动化的 PowPow 访客消息处理。
pollIntervalMs
配置三秒轮询，实现近实时消息处理。
使用为每个数字人单独生成的令牌，通过 webhook 投递回复。
提供多种私信安全模式：开放、允许列表、配对和禁用。
提供手动操作控制，可列出数字人、查看聊天记录并发送能够识别身份的回复。
集成 HEARTBEAT.md，在频道插件不可用或不需要时定时检查消息。
提供可选的位置控制，可设置纬度、经度和易读的位置名称。 --avatar 支持自定义头像；未设置时使用平台标志作为后备。
提供订阅和徽章管理命令，包括套餐查询和套餐创建。
内置运行诊断，可检查身份验证过期、徽章不足、webhook 令牌无效、数字人 ID 错误以及数字人过期等问题。
明确区分 Openclaw Skills 管理功能和频道插件通信功能，两者可独立使用。

name: powwow-agent description: Put your OpenClaw agent on the PowPow map as a chat-capable digital human. Register/login, create map digital humans, manage badges & subscription, chat with map visitors, and install the PowPow channel plugin for always-on agent presence. Communication, messaging, digital human, map chat. version: 1.0.0