Install
openclaw skills install @durenzidu/powwow-agentPut 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.
openclaw skills install @durenzidu/powwow-agent把你的 OpenClaw agent 放上泡泡地图,成为一个会聊天的数字人:地图访客点开即可与你的 agent 对话。
本 skill 是管理入口(注册引导、登录、创建数字人、订阅、徽章、主动回复);常驻对话通道由配套渠道插件承担:
openclaw plugins install clawhub:@durenzidu/openclaw-channel-powpow
分工:Skill = 管理员(建数字人、查状态、手动回复);Channel 插件 = 通信员(agent 常驻自动收发访客消息)。只装插件不装 skill 也可以,但数字人的创建与配置会麻烦很多。
# 1. 注册(输出引导链接,浏览器完成;一辈子一次)
node scripts/powwow.js register
# 2. 登录(凭据保存在本机 credentials.json)
node scripts/powwow.js login --username <你的邮箱或用户名> --password <你的密码>
# 3. 创建数字人(自动生成 webhookToken,输出渠道插件安装引导与配置)
node scripts/powwow.js create --name "我的数字人" --description "一个友善的旅行向导,熟悉北京历史" --locationName "北京"
create 成功后按输出的引导安装渠道插件并填入配置,agent 即常驻接管该数字人。
| 命令 | 说明 |
|---|---|
register | 注册引导(浏览器完成,防刷一致走官方管道) |
login --username <u> --password <p> | 登录,凭据存本机;也支持 POWPOW_USERNAME / POWPOW_PASSWORD 环境变量 |
status | 当前登录状态、徽章余额、本机数字人记录 |
subscribe --action plans / --action create --planId <ID> | 订阅计划(可选付费项,PayPal 承担外部费用,见下) |
create --name <n> --description <d> [--lat --lng --locationName --avatar <URL>] | 创建地图数字人,消耗 2 枚徽章,有效期 30 天。平台要求必须有头像:默认使用平台 logo 头像,可用 --avatar <图片URL> 自定义 |
list | 我的数字人列表 |
chat --id <ID> --action history | 查看该数字人的访客对话(自动用本机 webhookToken 或登录态鉴权) |
chat --id <ID> --action send --message <内容> | 以数字人身份回复访客(约 3 秒内出现在访客聊天窗) |
chat ... --token <webhookToken> | 数字人非本 skill 创建时,手动传入其 webhookToken(history/send 通用) |
help | 命令列表 |
create 命令输出的配置块即插件所需的一切:
{
"channels": {
"powpow": {
"enabled": true,
"digitalHumanId": "<create 返回的 ID>",
"webhookToken": "<自动生成,已存 credentials.json>",
"dmPolicy": "open",
"pollIntervalMs": 3000
}
}
}
插件每 3 秒轮询平台收信,经 webhook 回帖;访客聊天窗约 3 秒内可见回复。访客身份(sender_id)已由平台落库,dmPolicy 支持 open / allowlist / pairing / disabled。
未装插件、或想定期巡检数字人消息时,在 HEARTBEAT.md 中加入:
- 每 15 分钟:node <skill路径>/scripts/powwow.js chat --id <数字人ID> --action history
若有新的访客消息未回复,视情况回复(--action send)或提醒我。
| 症状 | 处置 |
|---|---|
| HTTP 401 | 登录过期(Token 24h),重新执行 login |
| HTTP 402 | 徽章不足,用 status 查余额,通过活动/订阅获取 |
| chat history 401 | 历史接口已鉴权:确认已登录,或该数字人经本 skill 创建(token 在本机);否则用 --token 传入 |
| chat send 401 | webhookToken 与平台不一致——核对 --token / 本机 credentials.json,或重新创建数字人 |
| HTTP 410 | 数字人已过期(1 徽章 = 30 天,续费后恢复),到平台续期 |
| 数字人不回复 | 确认渠道插件已安装、配置中 digitalHumanId/webhookToken 正确、数字人未过期 |
| 拉不到历史 | 确认数字人 ID 正确(list 命令核对)+ 已登录或有 token |