backup-to-telnyx-storage

What This Skill Does

The backup-to-telnyx-storage skill provides a robust, lightweight, and S3-compatible mechanism for backing up your OpenClaw workspace. Unlike traditional cloud backups that require heavy Python SDKs (like boto3) or complex environment configurations, this skill utilizes the Telnyx CLI to manage archives directly. It creates compressed tarball snapshots of critical agent files, including core configuration files like SOUL.md and IDENTITY.md, as well as your operational memory and knowledge bases. By automating the persistence of your agent's current state, this tool ensures that you can recover from local system failures or corruption events with minimal downtime. It is designed for simplicity, performance, and cost-effectiveness, leveraging Telnyx's affordable storage pricing.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/dotcom-squad/telnyx-storage-backup. Once installed, ensure you have the Telnyx CLI installed via npm install -g @telnyx/api-cli. Finally, authenticate your session by running telnyx auth setup. No additional environment variables or complicated API key configurations are required for the standard CLI workflow.

Use Cases

This skill is perfect for developers and power users who need to safeguard their agent's personality and memory evolution. It is ideal for periodic state preservation, especially if you are frequently modifying sensitive knowledge files or custom scripts. It also serves as an excellent migration tool, allowing you to quickly move your entire workspace to a new machine by restoring a backup file directly from your Telnyx storage bucket.

Example Prompts

1. "OpenClaw, run the backup script now and confirm the new snapshot has been uploaded to Telnyx."
2. "List all available backups in my Telnyx storage so I can check if my morning state was successfully saved."
3. "Restore the latest backup from my Telnyx storage to recover my workspace to the state it was in thirty minutes ago."

Tips & Limitations

To optimize storage costs and organization, utilize the MAX_BACKUPS environment variable to control your retention policy, preventing unnecessary storage bloat. While the tool is highly reliable, ensure that you have periodic integrity checks on your restored files. Note that while a legacy backup.py file is included for boto3 compatibility, it is recommended to stick to the shell scripts for the best performance and dependency-free operation. Always ensure your network has access to Telnyx services to avoid failed cron job executions.