OxyPages Publish

安装指南

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

什么是

OxyPages Publish 可帮助 OpenClaw 代理在几秒内将静态网站上线，无需 Git、构建步骤或专用 CLI。它接受单个 HTML 页面，或包含 index.html 及其配套资源的 ZIP 文件，然后返回一个可访问的 *.myoxypages.com URL。
你可以选择无需账户、30 分钟后过期（除非领取）的链接，也可以使用 OxyPages API 密钥进行身份验证，永久部署网站。此技能让发布变得简单，同时要求获得用户同意、告知相关的过期或部署详情，并遵守 OxyPages 的审核决定。

应用场景

仅在用户明确要求托管、上线或获取可访问链接后发布页面。
无需账户分享短期预览，然后提供领取链接，让用户可以保留该页面。
使用 OxyPages API 密钥部署或更新归用户所有的永久网站。
发布包含 HTML、CSS、JavaScript、图片、字体或其他受支持资源的完整静态网站。
从实时 API 查看上传和套餐限制，而不是依赖可能已过时的数值。

工作原理

确认用户已明确同意公开托管；仅创建页面并不代表同意发布。
检查是否可用 OXYPAGES_API_KEY，并选择未领取链接或账户所有的部署流程。
准备网站，将 index.html 放在顶层，并为关联资源使用相对路径；使用受支持的文件类型。
对于未领取链接，将页面或 ZIP 发送到 POST /drops，并附上 X-Oxy-Agent 归属标头。对于自有网站，先列出现有网站或创建网站，然后部署完整文件集。
检查响应中的可访问 URL、跳过文件的警告、部署详情、错误或过期信息。
告知用户发布了什么并分享 URL。对于未领取链接，还要说明 30 分钟的有效期并提供领取 URL。

配置指南

此技能需要 curl。API 密钥为可选项：没有 OXYPAGES_API_KEY 时，发布会创建一个有效期为 30 分钟的未领取链接；如果使用以 oxy_ 开头的密钥，则可以部署到用户的账户。在 OxyPages 的 Profile → API Keys 下创建密钥。
创建未领取的单页预览：
curl -sS -X POST https://api.oxypages.com/drops
-H "X-Oxy-Agent: openclaw"
-F "file=@index.html" 对于多文件网站，将文件打包成 ZIP，并将 index.html 放在压缩包顶层，然后上传 ZIP：
zip -r site.zip index.html css/ js/ images/
curl -sS -X POST https://api.oxypages.com/drops
-H "X-Oxy-Agent: openclaw"
-F "file=@site.zip" 要进行永久部署，请设置 OXYPAGES_API_KEY，选择或创建一个网站，然后上传 ZIP，或向该网站的 deployments 端点发送 JSON 文件列表。部署会替换网站上的文件，因此每次部署都要包含所有文件。上传前请检查当前限制：
curl -sS https://api.oxypages.com/limits

数据架构

此技能不定义本地数据库，也不会生成项目专属的数据存储。它会将网站文件发送到 OxyPages API，并读取结构化 JSON 响应。
流程 输入和组织方式 响应详情
未领取的投放 单个 .html 文件，或顶层包含 index.html 的 ZIP；最大值取决于当前服务限制 url、token、claim_url、expires_at、可选的 warnings 和状态详情
账户所有的网站 网站 ID 加 ZIP，或 JSON files 数组；每个文件包含 path 和 content，二进制内容使用 encoding: "base64" url、deployment_number、pages、bytes、files 和可选的 warnings
网站元数据 通过账户网站端点获取 网站的 id、name、subdomain、url 和 status
部署历史记录 通过网站的 deployments 端点获取 该网站的版本历史记录
必需的网站结构包括根目录中的 index.html，以及诸如 css/style.css 的相对资源路径。支持的内容包括 HTML、CSS、JavaScript、JSON、文本、图片、字体和 PDF。不受支持的文件可能会被省略，并在 warnings 中标明。请查看 /limits，了解当前上传、资源和套餐上限。

高级特性

同时支持临时的免账户预览和账户所有的永久部署。
账户操作使用 bearer-token 身份验证；密钥被拒绝时会返回身份验证错误，用户应在 OxyPages 创建替代密钥。
支持 ZIP 上传或 JSON 文件列表，包括 base64 编码的二进制资源。
提供网站发现、网站创建、部署和部署历史记录操作。
https://mcp.oxypages.com/mcp
支持 MCP 账户操作：
list_sites
、
create_site
、
deploy_site
list_deployments
；未领取发布仍使用 HTTP drops 端点。
对跳过的文件返回警告，并区分常见故障，例如网站结构无效、大小限制、不支持的文件类型、审核拒绝和速率限制。
发布前必须获得同意，禁止尝试绕过审核，并要求代理分享生成的 URL 以及相关的领取或过期信息。

name: oxypages-publish description: Publish a static website (HTML, CSS, JS, images, or a ZIP) to OxyPages and hand the user a live HTTPS link. Works with no account for a 30-minute unclaimed link, or with an OxyPages API key for a permanent site the user owns. version: 1.0.0
homepage: https://oxypages.com