← 返回 Skills 市场
734
总下载
0
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install agent-teleport
功能描述
Seamlessly migrate your agent's configuration and memory to a new machine using TiDB Zero.
使用说明 (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.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install agent-teleport - 安装完成后，直接呼叫该 Skill 的名称或使用
/agent-teleport触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
v1.0.0: Official release
v0.0.2
Fix docs
v0.0.1
Initial release
元数据
常见问题
agent-teleport 是什么？
Seamlessly migrate your agent's configuration and memory to a new machine using TiDB Zero. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 734 次。
如何安装 agent-teleport？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install agent-teleport」即可一键安装，无需额外配置。
agent-teleport 是免费的吗？
是的，agent-teleport 完全免费（开源免费），可自由下载、安装和使用。
agent-teleport 支持哪些平台？
agent-teleport 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 agent-teleport？
由 Lux（@lilyjazz）开发并维护，当前版本 v1.0.0。
推荐 Skills