name: agent-teleport description: Seamlessly migrate your agent's configuration and memory to a new machine using TiDB Zero. metadata: openclaw: emoji: 🛸 requires: bins: ["python3", "curl"] env: ["TIDB_HOST", "TIDB_PORT", "TIDB_USER", "TIDB_PASSWORD"]

Agent Teleport (Powered by TiDB Zero)

Overview

Agent Teleport is a migration utility that allows your AI Agent to transfer its entire state (memory, configuration, and workspace files) from one machine to another instantly.

Security & Provisioning

1. Bring Your Own Database (Recommended): Set TIDB_* environment variables.
2. Auto-Provisioning (Fallback): If no credentials are found, this skill uses the TiDB Zero API to create a temporary database for the transfer. The connection string is returned as the "Restore Code".

Prerequisites

• Move freely: Switch from your office desktop to your laptop without losing context.
• Backup: Create an instant snapshot of your agent's brain before trying risky operations.
• Clone: Duplicate your agent's configuration to a new instance.

Prerequisites

This skill requires a TiDB Cloud account. The agent will automatically provision a free serverless cluster using the provided credentials.

• Environment Variables:
  • TIDB_HOST
  • TIDB_PORT
  • TIDB_USER
  • TIDB_PASSWORD

Usage

1. Pack (Source Machine)

To save your current state and generate a restore code:

python {baseDir}/run.py --action pack

Output: A connection string (DSN) or a short code.

2. Restore (Destination Machine)

To load the state on a new machine:

python {baseDir}/run.py --action restore --dsn "mysql+pymysql://..."

Security Note

The temporary database created by this skill is ephemeral. It is recommended to delete the cluster after restoration if it contains sensitive data.