跨设备同步:基于 GitHub 的记忆同步 - Openclaw Skills

作者:互联网

2026-04-13

AI快讯

什么是 跨设备同步技能?

跨设备同步技能是一款功能强大的实用程序,专为需要在多个环境中保持 AI 智能体上下文持久性的开发人员和高级用户设计。通过利用 GitHub 作为安全且具备版本控制的中央枢纽,该技能可确保您的 Openclaw 技能及其关联记忆保持同步,无论您是从台式机切换到笔记本电脑还是云环境。

该技能通过创建专门的同步脚本和处理双向更新,自动化了手动数据传输的复杂性。它是构建便携式 AI 工作空间的核心组件,确保智能体的“大脑”在您工作的任何地方都如影随形。

下载入口:https://github.com/openclaw/skills/tree/main/skills/coreyleung-art/cross-device-sync

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install cross-device-sync

2. 手动安装

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

全局模式 ~/.openclaw/skills/ 工作区 /skills/

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

3. 提示词安装

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

请帮我使用 Clawhub 安装 cross-device-sync。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

跨设备同步技能 应用场景

  • 在办公室和家庭工作站之间切换时保持一致的 AI 上下文。
  • 将关键的智能体记忆文件备份到私有且具备版本控制的云仓库。
  • 在多个本地安装之间共享智能体知识库。
  • 在设置新机器或环境后快速恢复智能体状态。
跨设备同步技能 工作原理
  1. 该技能使用提供的个人访问令牌 (PAT) 验证 GitHub 仓库访问权限。
  2. 它初始化本地克隆或更新现有仓库,以作为本地记忆同步点。
  3. 它将 OpenClaw 数据目录映射到同步的仓库文件夹。
  4. 执行时,它执行双向同步:从 GitHub 拉取最新更改,合并本地更新,并将最终状态推回远程服务器。
  5. 它生成详细的日志和状态报告,以确保所有终端的数据完整性。

跨设备同步技能 配置指南

使用以下命令安装技能:

npx clawhub install cross-device-sync

安装后,通过提供您的 GitHub 凭据初始化同步环境:

await setup_cross_device_sync({
  repoUrl: "https://github.com/username/repository.git",
  token: "your_github_personal_access_token"
});

跨设备同步技能 数据架构与分类体系

该技能使用以下结构管理指定 GitHub 仓库中的数据:

组件 描述
记忆文件 代表智能体已学习知识的核心 JSON 和 Markdown 文件。
同步脚本 处理 git 生命周期(拉取/提交/推送)的本地生成脚本。
sync_config.json 包含仓库 URL 和目录映射元数据的配置文件。
.sync_logs 跟踪上次同步事件的时间戳和成功/失败情况的元数据。

Cross-Device Sync Skill

通过GitHub仓库实现OpenClaw跨设备记忆同步的技能。

描述

这个技能允许用户轻松地在多个设备之间同步OpenClaw的记忆文件。通过GitHub作为中央存储库,用户可以在不同的设备上访问相同的数据。

功能

  • 自动创建跨设备同步所需的脚本
  • 配置GitHub仓库访问
  • 设置双向同步机制
  • 提供冲突处理机制
  • 自动化定时同步选项

安装

npx clawhub install cross-device-sync

使用方法

1. 初始化设置

// 设置跨设备同步
await setup_cross_device_sync({
  repoUrl: "https://github.com/username/repository.git",
  token: "your_github_personal_access_token"
});

2. 立即同步

// 立即执行同步
await sync_now();

3. 检查状态

// 检查同步状态
await check_sync_status();

详细说明

setup_cross_device_sync

此函数会引导用户完成整个设置过程:

  1. 验证GitHub仓库访问权限
  2. 克隆或更新本地仓库
  3. 创建双向同步脚本
  4. 配置OpenClaw使用同步目录
  5. 创建配置文档

sync_now

此函数执行即时双向同步:

  1. 从GitHub拉取最新更改
  2. 将本地更改合并到工作区
  3. 将本地更改推送到GitHub

check_sync_status

此函数检查同步系统的状态:

  1. 验证GitHub仓库连接
  2. 检查同步脚本是否存在
  3. 检查仓库状态
  4. 报告配置信息

安全注意事项

  • 请确保GitHub仓库是私有的以保护敏感数据
  • 妥善保管Personal Access Token
  • 定期轮换访问令牌
  • 检查同步日志以确保没有异常活动

故障排除

如果遇到同步问题:

  1. 检查网络连接
  2. 验证GitHub认证信息
  3. 查看同步日志
  4. 确认仓库权限

维护

  • 定期检查同步日志
  • 清理旧的备份文件
  • 验证数据一致性
  • 更新访问令牌

相关推荐