Persona Sync

# Persona Sync

Sync your AI companion's persona across multiple OpenClaw instances — never lose memories, never start from scratch.

---

What It Solves

You spent weeks tuning your AI to know who you are — your name, preferences, work context, how you communicate. Then you switched devices and it forgot everything.

Persona Sync turns that persona into a portable package stored in your own private GitHub repo, accessible from any device.

---

Core Features

---

Who It's For

---

Quick Start

Step 1: Initialize

# In your persona-store directory:
python scripts/sync.py init https://github.com/YOUR_USER/YOUR-PERSONA-REPO

The script creates necessary files automatically. Edit `~/.openclaw/persona-store/.gitauth`:

username=YOUR_GITHUB_USERNAME,token=YOUR_GITHUB_PAT

Step 2: Sync

python scripts/sync.py pull       # Pull latest persona
python scripts/sync.py status     # Check status
python scripts/sync.py push "..." # Push new memory

---

Credential Security

Tokens are **never** written to `.git/config` or git logs. The script uses `git credential helper` to store credentials in `~/.git-credentials` (mode 0600), accessed automatically by Git.

**Recommendation:** GitHub PAT with minimal scope (`repo` only) and 2FA enabled.

---

Files

| File | Description |

|------|-------------|

| `scripts/sync.py` | Python — cross-platform, recommended |

| `scripts/sync.sh` | Bash — Linux only |

| `SKILL.md` (this file) | Usage guide |

| `SPEC.md` | Technical spec |

| `~/.openclaw/persona-store/.gitauth` | GitHub auth (user creates manually) |

---

Security Note

**Q: ClawHub shows "Suspicious" — does this skill have a virus?**

A: No. This is a false positive.

**Why the flag appears:**

ClawHub's automated scan flags anything that reads/writes files and runs commands — because malware does the same things. This skill is not malware; it just syncs files.

**What actually happens:**

**Does this skill do bad things automatically?**

Nothing. Installing this skill adds a guide. It does not run automatically, does not connect to the internet automatically, and does not sync anything unless you deliberately run a sync command yourself.

**What is a PAT and am I at risk?**

PAT (Personal Access Token) = a password substitute for your GitHub account. Generate one at GitHub Settings → Developer Settings → Personal Access Tokens. Set scope to "repo only" — if someone steals it, they can only access your private repos, nothing else. Enable 2FA on your GitHub account as well.

**I'm not technical — is this safe for me?**

As long as you don't share your PAT with anyone, you are safe. This skill just helps you manage files. You never type any passwords into third-party websites.

---

**One persona, everywhere you go. No matter which device you're on, the AI that knows you is there.**

---

---

# Persona Sync

让 AI 伙伴的人格在多个 OpenClaw 实例之间同步，不丢记忆，不丢个性。

---

它解决什么问题

你花了很长时间调教出一个懂你的 AI——知道你的名字、偏好、工作背景、你们的沟通方式。然后你换了台设备，它不认识你了。一切从头开始。

Persona Sync 把人格变成可迁移的文件包，存在你自己的 GitHub 私有仓库里，每个设备都能拉取同一份数据。

---

核心功能

---

适合谁

---

快速开始

第一步：初始化

# 在 ~/.openclaw/persona-store 目录下：
python scripts/sync.py init https://github.com/YOUR_USER/YOUR-PERSONA-REPO

脚本会自动创建必要文件。编辑 `~/.openclaw/persona-store/.gitauth`：

username=YOUR_GITHUB_USERNAME,token=YOUR_GITHUB_PAT

第二步：同步

python scripts/sync.py pull       # 拉取最新人格
python scripts/sync.py status     # 查看状态
python scripts/sync.py push "..." # 同步新记忆

---

认证安全

Token **不会**写入 `.git/config` 或 git log。脚本通过 `git credential helper` 将凭证存储在 `~/.git-credentials`（0600 权限），Git 操作时自动调用。

**建议：** GitHub PAT 设置最小权限（`repo` scope），并开启 2FA。

---

文件说明

| 文件 | 作用 |

|------|------|

| `scripts/sync.py` | Python 版（跨平台，推荐） |

| `scripts/sync.sh` | Bash 版（Linux 可选） |

| `SKILL.md`（本文件） | 使用指南 |

| `SPEC.md` | 技术规格 |

| `~/.openclaw/persona-store/.gitauth` | GitHub 认证（用户手动创建） |

---

安全说明

**Q: ClawHub 显示 "Suspicious"——这个 skill 有病毒吗？**

A: 没有。这是误报。

**为什么会出现警告：**

ClawHub 的自动化扫描对"读文件 + 执行命令"非常敏感——因为恶意软件也是这样运作的。但这个 skill 不是病毒，它只是同步文件。

**实际上发生了什么：**

**这个 skill 会自动做坏事吗？**

不会。安装这个 skill 只是多了一份使用说明。它不会自动运行、不会自动联网、不会自动同步——除非你手动执行同步命令。

**什么是 PAT？我会有风险吗？**

PAT（Personal Access Token）= 你的 GitHub 账号密码的替代品。在 GitHub 设置页面生成，权限设为"仅能访问私有仓库"。即使有人拿到你的 PAT，也只能访问你的私有仓库，无法访问你的 GitHub 账号本身。建议同时开启 2FA 双因素认证。

**我不懂技术，装这个有风险吗？**

只要你不把 PAT 告诉别人，就没有任何风险。这个 skill 只是帮你管理文件，不需要你输入任何密码给第三方。

---

**一个人格，多个陪伴。不管你走到哪，那个懂你的 AI 都在。**