PowPow Publisher

安装指南

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

什么是

PowPow Publisher 是一款指令式 OpenClaw 技能，可用于创建并发布游记到 PowPow (global.powpow.online)，以及创建可聊天、标记在其公共地图上的数字人。它会引导用户收集素材、选择写作风格、确定地点、匹配数字人、撰写预览，并明确确认是否发布。
此技能强调用户掌控和内容准确性：它绝不会猜测照片的拍摄地点或时间，草稿内容会保留在本地，并且只有在用户确认后才会发布。带有地点的帖子会以气泡形式显示在公共地图上。除了发布之外，此 Openclaw Skills 工作流还支持登录与会话管理、帖子验证，以及清理已登录用户自己的测试帖子。

应用场景

将旅行照片、笔记或想法转化为第一人称 PowPow 游记。
发布带有地点、图片或数字人胶囊的完整旅行文章。
查找可在帖子中标记的相关数字人。
将地名解析为地图坐标，并选择正确的地点候选项。
创建具备人设、头像和有意义地图位置的可聊天数字人。
在决定是否发布之前，先在本地预览并修改帖子。
验证已发布的帖子，并在需要时删除已登录用户自己的测试帖子。

工作原理

使用 doctor.js 检查环境和现有 PowPow 会话；如有需要，登录已注册并激活的 PowPow 账号。
收集用户的素材和偏好。对于照片，可将可见的氛围和细节作为写作灵感，但应询问用户地点和大致时间，而不是自行推断。
起草或接受帖子文本，使其符合用户选择的风格或范例语气。如有要求，搜索合适的数字人，并按名称解析任何地点，以便用户选择正确的候选项。
可选择添加本地图片、直接图片 URL，或在配置了 Unsplash 密钥时添加搜索结果。使用 compose.js 组装帖子；该脚本会验证交互式胶囊，并创建本地草稿、清单和预览。
向用户展示完整文本、组件、账号、地点和预览路径。根据要求在本地修改；发布必须得到用户的明确确认。
使用 publish.js 发布已确认的草稿。本地图片会在此阶段上传，脚本会处理可续传的上传进度和服务器限流响应。
使用 verify.js 验证生成的帖子，报告已检查的内容，并提供帖子链接和地点。创建数字人时，收集所需详情，说明两枚徽章的费用和 30 天有效期，取得确认后再创建。

配置指南

Node.js 18 或更高版本，以支持脚本内置的 fetch。
PowPow 账号。在 https://global.powpow.online/register 注册，并完成任何必要的账号激活步骤。
在技能根目录中运行命令。将捆绑的技能目录保持为只读；在工作目录中存放生成的草稿和预览。
node -v
cd
node scripts/doctor.js
如果不存在有效会话，请登录一次。在类 Unix 系统上，应通过标准输入提供密码，而不是将其作为命令行参数：
printf '%s' '
' | node scripts/login.js
在 Windows 上，运行 node scripts/login.js ，并在隐藏提示处输入密码。默认情况下，会话存储在技能包之外的 ~/.powpow/session.json。
可选配置
设置 POWPOW_STATE_DIR，可将会话和配置状态移至其他目录。该状态目录中的可选 config.json 可以覆盖捆绑的默认值。UNSPLASH_ACCESS_KEY 可启用基于关键词的自动图片搜索；未设置时，可使用本地图片或直接图片 URL，也可以不添加图片直接发布。切勿将机密信息放入只读技能目录。

数据架构

状态和生成的文件
数据或文件 用途
默认位置为 ~/.powpow/session.json 缓存的登录会话令牌；可使用 POWPOW_STATE_DIR 更改位置。不会持久保存密码。
状态目录中的 config.json 可选配置覆盖项，例如平台 URL、Unsplash 密钥和会话最长有效期。
.html 组装后的帖子内容，其中包含经过验证、用于交互组件的富 HTML。
.html.manifest.json 记录发布时要上传的本地图片引用；上传成功后会更新进度。
.html.preview.html 本地浏览器预览，其中包含横幅，显示帖子是否会出现在公共地图上以及显示位置。
用户选择的图片文件 通过绝对路径引用；只有在发布帖子时才会上传本地图片。
内容和元数据
帖子内容可以包含文本、图片块、数字人胶囊和地点胶囊。compose.js 脚本会组装与编辑器兼容的 HTML；支持的占位符包括 {{dh}}、{{loc}} 和 {{img}}（以及文档中说明的中文别名）。
地点元数据包含地名和经纬度。地名候选项会在本地转换为编辑器所需的坐标系。不含地点的帖子仍可发布，但不会显示在公共地图上。
图片输入可以是本地文件、直接图片 URL，或在已配置搜索功能时使用 search:。支持上传 JPEG、PNG、WebP、GIF、BMP 和 HEIC，每张图片最大 10 MB；不支持 SVG。
创建数字人需要提供名称、人设描述、头像输入和必填地点。发布的数字人需要两枚徽章，并在 30 天后到期。
平台的帖子上限为 50,000 个字符，其中包括图片标记。信息流会显示前九张图片以及剩余图片的数量；查看器可以显示所有图片。

高级特性

经过验证的富 HTML 组装：
compose.js
可创建与编辑器兼容、可点击的胶囊，并会拒绝未知、位置错误或不匹配的占位符，而不会悄悄生成有问题的文本。
本地优先的草稿修改：
组装和预览不会联系服务器或上传图片；用户可以在确认发布前反复修改。
可续传的图片上传：
成功上传的文件会记录在清单中，因此发布失败后可以继续上传，无需重新上传已完成的文件。
数字人发现：
按名称搜索，或按排名主题匹配；会过滤掉已停用、使用测试名称、乱码或使用占位头像的条目。
地点解析与灵活回退：
搜索并消除地名歧义；如果找不到合适的匹配项，可使用更具体或更宽泛的查询重试，或不添加地点直接发布。不会要求用户提供坐标。
发布后验证：
发布后检查帖子是否可访问、作者、组件、图片数量和字数。
会话和服务器保护措施：
缓存会话支持重复使用；服务器会执行身份验证、内容审核和限流，而发布脚本会遵循
Retry-After
响应。
限定范围的测试清理：
可使用
delete-post.js
删除已登录用户自己的测试帖子。

name: powpow-publisher description: Publish posts/travelogues to PowPow (global.powpow.online), and create digital humans pinned to the public map. Triggers when the user wants to publish travel content (photos / travelogue / trip stories) to PowPow, e.g. "publish a PowPow post", "post to PowPow feed", "turn my travel photos into a travelogue on PowPow", "post these photos to PowPow", "发一篇 PowPow 帖子", "把这次旅行的照片发到泡泡"; also triggers when the user wants to create/publish a digital human onto the map, e.g. "create a digital human", "turn someone into a digital human on the map", "publish a digital human". Requires a PowPow account (register first if none). Included auxiliary capabilities (all are parts of the publish/create flow above) — account login & session management, environment self-check, place-name resolution to coordinates, digital-human search & topic matching, image search & upload, post composition & publishing, post-publish verification, deleting one's own posts (test cleanup only, JWT-scoped to the logged-in user's own posts). Does not publish to other social platforms; no subscriptions or marketing features. version: 1.0.5