什么是 Agent Teleport？

Agent Teleport 是一款高性能迁移工具，专为需要 AI 智能体便携性的开发者设计。作为 Openclaw Skills 生态系统的一部分，它能够在不同硬件环境之间无缝传输智能体的完整上下文——包括长期记忆、本地配置和工作区文件。通过利用 TiDB Zero 的强大功能，无论您是从台式机切换到笔记本电脑，还是部署到云端服务器，它都能确保您智能体的大脑保持一致且可访问。

该技能通过将智能体状态自动封装为便携格式，消除了繁琐的手动设置过程。它是确保 AI 开发工作流连续性的重要工具，在使用 Openclaw Skills 的本地开发和远程执行环境之间架起了一座稳健的桥梁。

下载入口:https://github.com/openclaw/skills/tree/main/skills/lilyjazz/agent-teleport

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Agent Teleport 应用场景

• 在不丢失操作上下文或记忆的情况下，将工作流从办公室工作站转移到个人笔记本电脑。
• 在执行高风险操作或重大配置更改之前，为智能体状态创建即时快照和备份。
• 克隆现有的智能体配置，以便在多个实例中扩展或复制特定行为。
• 使用临时云数据库在全新安装的环境中快速恢复智能体环境。

1. 用户在源机器上触发 pack 操作，汇总所有相关的智能体数据，包括记忆和工作区文件。
2. 该技能通过预先配置的凭据或自动配置临时集群来连接到 TiDB Zero 实例。
3. 汇总的状态将上传到 TiDB 数据库，确保所有上下文安全地存储在云端。
4. 生成一个唯一的连接字符串或恢复代码并展示给用户。
5. 在目标机器上，用户向该技能提供恢复代码，随后技能将拉取数据并精确重构源机器上的智能体环境。

Agent Teleport 配置指南

要开始使用 Openclaw Skills 的这一组件，请确保您的系统中已安装 python3 和 curl。您可以通过设置以下环境变量来使用自己的数据库：

export TIDB_HOST="your_host"
export TIDB_PORT="4000"
export TIDB_USER="your_username"
export TIDB_PASSWORD="your_password"

要在源机器上打包您的状态，请运行：

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

要在目标机器上恢复，请使用打包步骤中提供的 DSN：

python {baseDir}/run.py --action restore --dsn "your_connection_string"

Agent Teleport 数据架构与分类体系

Agent Teleport 将数据组织成结构化分类，以确保跨平台兼容性。下表概述了在 Openclaw Skills 框架内如何管理数据：

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.