Haven Media (x402)

安装指南

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

什么是

Haven Media (x402) 让 AI 代理创建音乐、生成或编辑图像、放大和修复照片，以及生成视频（包括带同步声音的短片）。请求以 USDC 定价，并通过 x402 协议付款，因此无需注册或 API 密钥。这项 Openclaw Skills 功能让代理能够使用其原生能力无法生成的媒体生成工具。
推荐的集成方式是 Haven MCP 服务器，它可以读取实时目录、检查报价、应用支出上限、管理任务并下载已完成的结果。已充值的 x402 v2 客户端也可以使用原始 HTTP 工作流。生成选项、可用性、价格和请求架构可能会变化，因此提交任务前请查看实时目录。

应用场景

为代理生成的项目创作一段短旋律、背景音乐或主题曲。
根据文本提示生成插图、概念艺术或缩略图。
使用自然语言指令编辑提供的图像。
放大图像或通过减少噪点、模糊或雾霾修复老照片。
根据文本或图像生成短视频。
制作带有同步对白、音效或环境音的短 2K 视频。
为兼容 MCP 的代理添加媒体生成功能，而无需管理自定义 API 密钥。
在适合直接 HTTP 集成时，使用已充值的 x402 v2 客户端。

工作原理

阅读实时目录，确认可用的媒体类型、当前价格、预计完成时间和请求架构。
检查 Haven 钱包地址以及 Base 上的 USDC 余额。使用 MCP 服务器时，运营者必须启用真实支出并为钱包充值，才能付费交付。
使用可用类型提交生成请求，例如 music、image_generate、image_edit、image_upscale、image_restore、video 或 video_sound。请求会验证付款授权并返回 jobId；提交时不会对生成的作品收费。
轮询任务状态，或保存 jobId 后稍后继续。任务可能需要 60–600 秒，GPU 工作进程也可能需要几分钟才能启动。
结果就绪后获取结果。使用 MCP 时，haven_job_result 是付费步骤：它会付款、下载经过筛查的作品、检查文件并返回本地路径。在原始 HTTP 流程中，交付时会请求付款。
尽快下载并保存结果。作品会保留七天，已完成的付款不可撤销。

配置指南

前提条件：能够访问网络地址 api.havenagent.ai，并拥有 Base 上的 USDC 钱包。推荐的 @havenagent/mcp 选项需要 Node.js 20 或更高版本。安装和钱包充值应由代理运营者处理。
对于 Claude Code，请安装 Haven 插件，该插件包含 MCP 服务器和 skill：
claude plugin marketplace add havenagent/skills
claude plugin install haven@havenagent
对于其他 MCP 客户端，请先以只读模式注册服务器。此配置可以读取目录，但不能支出：
claude mcp add haven -s user \ -e HAVEN_MCP_NETWORK=base \ -e HAVEN_MCP_ALLOW_MAINNET=0 \ -- npx -y @havenagent/mcp@latest 对于 Hermes，请在 ~/.hermes/config.yaml 的 mcp_servers.haven 下添加相同的 npx 命令和环境值。
若要启用付费交付，运营者必须在 MCP 注册配置中设置 HAVEN_MCP_ALLOW_MAINNET=1，或在插件设置中启用 允许支出真实 USDC，然后向 haven_wallet 显示的地址充值 Base 上的 USDC。无需 ETH。服务器会根据实时目录检查报价，并拒绝向 Haven 配置的收款钱包以外的地址付款的报价。
使用自有客户端的代理可以参考 references/x402-http.md 中的原始 HTTP 流程；必须使用 x402 v2 并发送 Payment-Signature 标头，而不是 v1 的 X-PAYMENT 标头。购买 video 或 video_sound 前，请阅读 references/use-terms.md。

数据架构

该 skill 使用实时目录描述可用的生成类型、端点路径、价格、请求架构、预计完成时间，以及在适用情况下的条款网址。以下价格是 skill 中的默认值，并不保证是当前报价：
类型 端点 默认价格 用途
music /music $0.10 音乐生成
image_generate /image/generate $0.05 文本生成图像
image_edit /image/edit $0.10 根据指令编辑图像
image_upscale /image/upscale $0.06 2× 或 4× 放大
image_restore /image/restore $0.10 照片降噪、去模糊和去雾
video /video $0.80 根据文本或图像生成短视频
video_sound /video-sound $1.50 带同步声音的短 2K 视频
MCP 工作流会使用 jobId 和任务状态跟踪每个已提交的任务。如果标识符丢失，haven_jobs 会列出未完成的任务；haven_job_status 会检查进度；haven_job_result 会获取交付的作品并返回其本地 path。MCP 服务器会在重启后保留任务跟踪信息。结果会保留七天，因此请尽快下载。
Skill 元数据将服务主页标识为 https://api.havenagent.ai/x402/api/v1/catalog，付款协议标识为 x402，网络标识为 Base，付款资产标识为 USDC。当前可用内容和确切请求架构由实时目录数据决定，而非本文档中的默认价格。

高级特性

MCP 管理的 x402 付款：处理报价检查、付款授权、交付付款、下载和文件检查。
由运营者控制支出：默认上限为每次调用 $2、每滚动 24 小时 $2；运营者可以提高上限。
任务恢复：任务记录在 MCP 服务器重启后仍会保留；如果
jobId
丢失，
haven_jobs
可帮助查找未完成的任务。
异步生成：轮询长时间运行的任务，并在之后的对话轮次中继续，而不是提交重复任务。
安全筛查：提示词和输入图像会在排队前进行审核；生成的输出会在请求付款前进行筛查。如果无法进行筛查，作品将被扣留，用户不会被收费。
按交付收费：提交任务不会对作品收费。交付前放弃任务可避免收费；一旦付款，x402 付款即为最终付款，不提供自动退款。
直接集成选项：使用已充值的 x402 v2 客户端进行原始 HTTP 报价、付款、轮询和下载流程。
视频许可要求：视频和带声音的视频请求受上游模型条款约束。用户发布时必须披露内容由机器生成，保留嵌入的 AI 生成披露，不得使用输出训练或微调模型，并在分享时传递相关条款。

name: haven-media-x402 description: Generate music, images, and video (silent or with a synchronized soundtrack) by paying per call in USDC via x402 — no account or API key. Use when the agent needs to create media it cannot produce natively. compatibility: Needs network access to api.havenagent.ai and a USDC wallet on Base — either the @havenagent/mcp server (Node.js 20+), which holds one locally, or your own x402 v2 client.