← Back to Skills Marketplace
734
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install agent-teleport
Description
Seamlessly migrate your agent's configuration and memory to a new machine using TiDB Zero.
README (SKILL.md)
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
- Bring Your Own Database (Recommended): Set
TIDB_*environment variables. - 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_HOSTTIDB_PORTTIDB_USERTIDB_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.
Usage Guidance
This skill WILL upload the contents of whatever directory you run it from into a TiDB instance (either one you provide via TIDB_* env vars or a temporary instance it attempts to create). Before installing or running: 1) Review run.py yourself and ensure you understand which files will be included; consider running it from a clean, empty directory or a prepared export directory. 2) Prefer supplying your own TiDB credentials (TIDB_HOST, TIDB_PORT, TIDB_USER, TIDB_PASSWORD) rather than relying on auto-provision; confirm the target DB is under your control. 3) Don't run from your home directory or any directory that may contain secrets (SSH keys, cloud credentials, .env files) — the IGNORE_PATTERNS are not exhaustive. 4) Back up the destination system before running restore: the restore extracts into the current dir and can overwrite files. 5) If you must use auto-provisioning, verify the API endpoint (zero.tidbapi.com) and its privacy/authorization model — auto-provision may result in your data being stored on a third party. 6) Consider encrypting the archive or using a trusted transport before uploading if your data is sensitive. If you are not comfortable with any of the above, do not run the skill.
Capability Analysis
Type: OpenClaw Skill
Name: agent-teleport
Version: 1.0.0
The skill is classified as suspicious due to its inherent high-risk capabilities, including broad file system access (reading and writing the entire workspace), outbound network calls via `curl` to an external API (`https://zero.tidbapi.com/v1alpha1/instances`) for database provisioning, and handling of sensitive database credentials (DSN) as output. While these actions are directly aligned with the stated purpose of 'teleporting' an agent's state, they represent significant attack surface. However, the code in `run.py` includes important security mitigations such as `IGNORE_PATTERNS` to prevent common secret files from being packed and a robust Zip Slip vulnerability check during archive extraction, indicating an awareness of security risks rather than malicious intent. There is no evidence of intentional data exfiltration to unauthorized endpoints, persistence mechanisms, or prompt injection attempts against the agent.
Capability Assessment
Purpose & Capability
Name/description align with requesting TiDB access and using Python/curl. Requesting TIDB_* env vars and using python3/curl is coherent for storing/restoring state in TiDB. Minor surprise: the skill will pack the entire current working directory (not a scoped agent-only store), which may include unrelated sensitive files.
Instruction Scope
Runtime instructions and included run.py will walk the current working directory, create an in-memory tar.gz of everything not matching a short ignore list, and upload it to a remote TiDB instance. If env vars are absent, the code auto-provisions by POSTing to https://zero.tidbapi.com/v1alpha1/instances via curl. The SKILL.md mentions auto-provisioning but does not fully call out that your entire CWD can be transmitted to a third party or that restore will overwrite files in the destination directory.
Install Mechanism
Instruction-only install (no remote downloads). The package includes run.py and a requirements.txt (pymysql). No external archives or obscure download URLs. The code does call subprocess to run curl but does not pull arbitrary code from unknown hosts.
Credentials
Requested env vars (TIDB_HOST, TIDB_PORT, TIDB_USER, TIDB_PASSWORD) are appropriate for a DB-backed migration tool. However, auto-provisioning when those are not supplied means the skill will contact an external API and may store your workspace on a remote service without you providing credentials — a behavior you should explicitly consent to. The skill does not request unrelated credentials.
Persistence & Privilege
always is false and the skill does not request persistent system-level privileges or modify other skills. It writes/extracts files into the current working directory only (can overwrite files) but does not change system configuration or other skill settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-teleport - After installation, invoke the skill by name or use
/agent-teleport - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
v1.0.0: Official release
v0.0.2
Fix docs
v0.0.1
Initial release
Metadata
Frequently Asked Questions
What is agent-teleport?
Seamlessly migrate your agent's configuration and memory to a new machine using TiDB Zero. It is an AI Agent Skill for Claude Code / OpenClaw, with 734 downloads so far.
How do I install agent-teleport?
Run "/install agent-teleport" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is agent-teleport free?
Yes, agent-teleport is completely free (open-source). You can download, install and use it at no cost.
Which platforms does agent-teleport support?
agent-teleport is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created agent-teleport?
It is built and maintained by Lux (@lilyjazz); the current version is v1.0.0.
More Skills