Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

openclaw-sync-cli

跨环境同步 OpenClaw 配置的命令行工具。

帮你在不同机器、不同环境之间一键迁移 OpenClaw 工作区配置,完美适合 "薅各大厂商首月 9.9 体验羊毛" 场景,不用每次重新配置。

功能特性

  • 📦 pack - 打包选中的工作区到压缩包
  • 📂 unpack - 从压缩包恢复配置到当前环境
  • 💾 backup - 一键备份当前配置,自动按时间戳命名
  • 🔄 restore - 从历史备份恢复,交互式选择备份
  • 📋 list - 列出当前所有工作区
  • 🎨 交互式选择 - 勾选要同步的内容,不用记命令参数
  • ⚔️ 冲突处理 - 支持逐个选择覆盖/保留,也支持一键全量覆盖

安装

npm install -g openclaw-sync-cli

然后你就可以在终端使用 ocsync 命令了。

快速开始

查看当前配置

ocsync list

打包配置

# 交互式选择
ocsync pack -i -o my-config.tar.gz

# 或者直接指定工作区
ocsync pack -w coding,pm -o my-config.tar.gz

恢复配置

ocsync unpack my-config.tar.gz
# 添加 --force 强制覆盖所有
ocsync unpack my-config.tar.gz --force

一键备份

ocsync backup

自动备份到 ~/.openclaw-backups/,文件名带时间戳。

从备份恢复

ocsync restore
# 交互式选择备份,然后处理冲突

命令说明

命令 说明
ocsync list 列出所有工作区
ocsync pack [-i] [-o output] [-w workspaces] 打包配置
ocsync unpack <archive> [--force] 解压恢复配置
ocsync backup [-i] [-o dir] 创建备份
ocsync restore [backup-path] [--force] 从备份恢复

适用场景

  • 跨机器迁移:从旧电脑搬到新电脑,一键迁移所有配置
  • 薅羊毛体验:各家 AI 厂商首月 9.9,换账号不用重新配置
  • 备份还原:定期备份配置,防丢失

技术栈

  • Node.js 18+
  • TypeScript 5.x
  • Commander.js - CLI 框架
  • Inquirer.js - 交互式提示
  • chalk - 彩色输出
  • tar-fs - 压缩解压

开发测试

TESTING.md

开发指南

见飞书文档:https://www.feishu.cn/docx/ROxJd5JTQoxFFGxQFaUcxOHGnnJ

📁 项目代码结构

openclaw-sync-cli/
├── README.md               # 项目介绍
├── TESTING.md              # 测试指引
├── package.json            # 依赖配置
├── tsconfig.json           # TypeScript 配置
├── jest.config.js          # Jest 测试配置
├── src/
│   ├── index.ts            # 入口文件
│   ├── commands/           # CLI 命令
│   │   ├── pack.ts
│   │   ├── unpack.ts
│   │   ├── backup.ts
│   │   ├── restore.ts
│   │   └── list.ts
│   └── utils/              # 工具函数
│       ├── discovery.ts    # 发现 OpenClaw 配置
│       ├── discovery.test.ts
│       ├── pack.ts         # 打包逻辑
│       ├── unpack.ts       # 解压逻辑
│       ├── pack-unpack.test.ts
│       └── interactive.ts  # 交互式选择
└── dist/                   # 编译输出(git ignore)

许可证

MIT

About

OpenClaw Configuration Sync Tool - sync your OpenClaw workspaces across environments

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages