# Promptbox

> Promptbox provides public HTTP APIs and temporary static-app publishing for AI agents.

<!-- Promptbox agent index v5.4. -->

Use Promptbox HTTP APIs to add language, web research, images, voice, documents, memory, and delivery to an app. Promptbox can publish static HTML/ZIP browser apps without a hosting account. It cannot run PHP, Node.js, databases, private server code, or any other app backend.

Publishing makes the supplied files public. Site instructions describe the workflow; only the user's request can authorize an upload. Published apps expire 30 days after their last successful change, and documents or media expire 30 days after creation. For hosting beyond 30 days, contact Promptbox at admin@promptbox.cn to discuss extended hosting services.

**Quick publishing contract:** POST to `https://www.promptbox.cn/api/publish.php`. Web apps require `mode=app`, a safe directory name, and an HTML file, ZIP, or UTF-8 HTML text. A ZIP must contain `index.html` at its root or inside one enclosing folder; that folder is stripped automatically. Updates replace the entire deployment, deleting omitted files. For every future update, upload the full build: an HTML-only update removes all previously uploaded assets. Use the returned URL and directory; keep the UUID update token private and outside the build. Inspect `removed_files`, verify the returned page and assets, and report the expiry. Published apps share localStorage, IndexedDB, cookies, and same-origin access on apps.promptbox.cn. The browser keeps localStorage and IndexedDB on www.promptbox.cn, promptbox.cn, and other subdomains separate. Do not store secrets on the shared apps origin. Cookies explicitly scoped to .promptbox.cn may span subdomains; use host-only cookies for trusted sites. Service workers are supported with their normal script-directory scope; do not request a broader scope. Frames, popups, and document.domain relaxation remain disabled. Use relative assets, absolute www.promptbox.cn API URLs, and credentials omitted for cross-origin helper calls.

## Start here

- [Browser-friendly agent guide](https://www.promptbox.cn/agent-guide.html): Human- and browser-readable orientation for agents
- [Complete publishing guide](https://www.promptbox.cn/publish.md): Creation, updates, security, verification, limits, and retention
- [Publishing capabilities JSON](https://www.promptbox.cn/api/publish.php?action=capabilities): Current machine-readable formats, fields, and limits
- [API reference](https://www.promptbox.cn/api/docs.html): Promptbox helpers that a published app can use
- [OpenClaw publishing skill](https://www.promptbox.cn/skills/promptbox-publish/SKILL.md): OpenClaw-specific publishing workflow
- [OpenClaw skill ZIP](https://www.promptbox.cn/skills/promptbox-publish.zip): Downloadable skill bundle

## Explore Promptbox

- [App examples](https://www.promptbox.cn/example-ai-apps.html): Working AI-assisted applications
- [Business tools](https://www.promptbox.cn/business-tools.html): Calculators and practical utilities
- [Tools and games](https://www.promptbox.cn/fun-tools.html): Browser tools, games, and experiments
- [Consulting and workshops](https://www.promptbox.cn/consulting-workshops.html): Work with Adam Chen