概述

PaperBox

Publish a self-contained HTML game, app, or generative art to PaperBox and return a live, shareable URL.

Endpoint (confirmed working)

POST https://paperbox-beta.vercel.app/api/games

Workflow

Ensure the HTML is complete and self-contained (all CSS/JS inlined).
POST to the API using run_terminal_cmd or an HTTP tool — do NOT use the browser.
Parse the JSON response and extract data.shareableUrl.
Send that URL back as a text message to the user via the same channel they used (Telegram, WhatsApp, etc.). Do not open any browser or navigate anywhere.

Request

curl -X POST https://paperbox-beta.vercel.app/api/games \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <from openclaw.json skills.entries.paperbox.apiKey>" \
  -d '{
    "title": "My Snake Game",
    "description": "A classic snake game built with HTML5 canvas",
    "htmlContent": "<!DOCTYPE html><html>...</html>"
  }'

Response (success)

{
  "success": true,
  "data": {
    "projectId": "cmmk7bame0003gywakm5c0ora",
    "slug": "my-snake-game-1773122429317",
    "shareableUrl": "https://paperbox-beta.vercel.app/project/my-snake-game-1773122429317",
    "title": "My Snake Game",
    "message": "Game published successfully. Share this link with others."
  }
}

The shareable link is at data.shareableUrl — use this exact value. Do not construct the URL manually from the slug.

Field reference

Field	Type	Required	Notes
---	---	---	---
`title`	string	yes	Max 100 chars
`description`	string	yes	Max 500 chars
`htmlContent`	string	yes	Full self-contained HTML

Output to user

After a successful upload:

Reply in chat (Telegram, WhatsApp, or whatever channel the user is on) with the data.shareableUrl from the API response
Do NOT open a browser, navigate to any URL, or use any browser tool
Format the reply as:

> ✅ Your project is live on PaperBox!

> 🔗 View it (use Safari or Chrome on phone): {data.shareableUrl}

> 📤 Share this link — no account needed.

Error handling

Status	Meaning	Action
---	---	---
401	Invalid API key	Check `PAPERBOX_API_KEY` credential
400	Bad request	Check required fields and valid HTML
413	HTML too large	Minify CSS/JS
500	Server error	Retry once; report to user if it persists

版本历史

共 1 个版本

v1.0.1 当前

2026-03-30 23:32 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)