OpenClaw Agent Backup & Restore API

Purpose & Significance

OpenClaw Agent Dashboard is a specialized backup and restore solution for OpenClaw agent workspace files, built on Ampt Storage infrastructure. It bridges the gap between development environments and persistent cloud storage by providing a simple REST API with presigned URLs—eliminating the need to manage authentication tokens directly in client applications. For teams running OpenClaw agents, this tool ensures workspace data can be safely backed up, versioned, and restored without complex storage integration overhead.

Key Features

• Presigned URL-based uploads/downloads — Clients receive temporary, secure URLs from the API and upload/download directly to Ampt Storage, reducing server load and improving transfer performance
• Labeled backup organization — Organize backups by custom labels (e.g., "default", "production") with automatic ISO timestamps for version tracking
• Metadata tracking — Record file count and total size with each backup for auditing and quota management
• List and restore workflows — Query all backups by label and retrieve presigned download URLs for specific versions
• Delete capability — Remove old backups to manage storage costs
• Bearer token authentication — All endpoints (except health check) require API key validation via standard Authorization header
• Web UI included — Vite-powered frontend with Tailwind CSS for manual backup/restore operations
• TypeScript-first — Fully type-safe implementation with modern tooling (Biome for linting, Vite for bundling)

Getting Started

Installation & Setup

Clone the repository and install dependencies:

npm install

Configure your API key via Ampt parameters:

ampt params set API_KEY your-secure-key-here

Start the development server:

npx ampt

Basic Usage

1. Get a presigned upload URL: Send a POST request to /api/backup with query parameters for label, file count, and total size. The API returns a presigned URL for direct S3-style upload.

2. Upload your backup: Use the returned URL with a PUT request to upload your compressed workspace files (e.g., workspace.tar.gz).

3. List backups: Query /api/backups?label=default to see all versions under a label.

4. Restore: Request a presigned download URL from /api/restore/:label/:timestamp, then download directly.

API Endpoints at a Glance

• GET /api/health — No-auth health check for monitoring
• POST /api/backup?label=&fileCount=&totalSize= — Generate presigned upload URL
• GET /api/backups?label= — List all backups under a label
• GET /api/restore/:label/:timestamp — Generate presigned download URL
• DELETE /api/backup/:label/:timestamp — Remove a specific backup version

Who Should Use This

OpenClaw agent operators — Teams running OpenClaw agents who need reliable workspace persistence without managing AWS credentials directly in agent code.

DevOps and platform engineers — Infrastructure teams building internal tooling for agent lifecycle management and disaster recovery.

CI/CD pipeline builders — Anyone automating backup workflows via REST APIs in deployment scripts or orchestration systems.

Self-hosted AI practitioners — Developers using OpenClaw in on-prem or hybrid environments who need versioned backups with audit trails.

Architecture & Tech Stack

Built with TypeScript for type safety across frontend and backend. The backend uses Ampt SDK for zero-configuration cloud storage and presigned URL generation. The frontend is a modern Vite + React application styled with Tailwind CSS. Code quality is maintained via Biome (unified linter and formatter). Deployment is seamless via the Ampt platform, which handles environment variable management through the params CLI.

Resources

• GitHub Repository — Source code, issue tracking, and contribution guidelines
• README.md in repo — Full endpoint documentation and cURL examples
• CLAUDE.md — Development notes and architecture guidance (if included)
• ampt-storage — Ampt Storage platform documentation
• Antfarm: Multi-Agent Workflow Orchestration for OpenClaw — OpenClaw agent framework documentation

Source: OpenClaw Agent Dashboard GitHub repository, accessed February 2026. Maintained by benminer.