← 返回 Skills 市场
135
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install openclaw-sync-bridge
功能描述
Automatically sync local and cloud OpenClaw configurations via private GitHub Gist with token-based setup and full overwrite synchronization.
安全使用建议
What to consider before installing:
- Don't pipe remote scripts to your shell without review. The README/ SKILL.md recommend curl | bash from clawhub.ai — prefer to inspect the script first or use the included local files (install.sh, sync_bridge.py) bundled in the skill.
- The skill needs a GitHub token with gist permission. Limit the token scope to only 'gist' and consider using a token dedicated to syncing (not your primary account token).
- The code appears to only communicate with api.github.com for Gist operations; sync_config.json (which stores the token) is listed in the ignore rules and should not be uploaded. Still, inspect the code (sync_bridge.py) yourself before trusting it — some parts of the file were truncated in the review and a full read mitigates risk.
- The installer will add an alias to your shell rc files and may create $HOME/.local/bin; expect these user-level modifications and back up your dotfiles first.
- If you want to be cautious: install locally by copying the included files to a folder, run the local install.sh after reading it, or run python3 sync_bridge.py directly from the package directory. Consider testing in an isolated or disposable environment first.
- If you plan to sync across devices, verify the IGNORE_PATTERNS actually cover all sensitive files you don't want uploaded. There is a small implementation nuance where file ignore logic uses substring checks which could have unintended effects — review the code and confirm sensitive files are never sent.
If you want, I can: (a) point out the exact lines in sync_bridge.py that implement ignores, create/update Gists, and read/write the token, or (b) produce a safe, minimal checklist and commands to install without contacting clawhub.ai.
功能分析
Type: OpenClaw Skill
Name: openclaw-sync-bridge
Version: 2.0.0
The skill is a synchronization utility that uploads OpenClaw workspace files to GitHub Gists. While it includes safety features such as local backups and an exclusion list for sensitive files (e.g., .env, *.token), it employs several high-risk behaviors: the 'install.sh' script modifies shell configuration files (.bashrc, .zshrc) to create persistent aliases, and the documentation encourages the 'curl | bash' installation pattern. The core functionality involves broad filesystem access and data exfiltration to an external endpoint (api.github.com), which, while aligned with the stated purpose, constitutes a significant attack surface if the GitHub token or the Gist itself is compromised.
能力评估
Purpose & Capability
Name/description (sync OpenClaw workspace via GitHub Gist) align with included code and docs: the Python code implements push/pull/diff/status/backup against GitHub Gist and SKILL.md documents these operations.
Instruction Scope
Runtime instructions (setup/push/pull/diff/status/backup) stay within the described sync scope. The skill asks for a GitHub token and workspace path which is expected. It claims not to upload sensitive files and the code contains ignore rules for such files, though there are minor implementation quirks (see environment_proportionality / implementation notes).
Install Mechanism
SKILL.md/README instructs users to curl and pipe a script from https://clawhub.ai/JayShna/openclaw-sync-bridge/install.sh | bash (and a PowerShell equivalent). That is a higher-risk delivery channel because the domain is not a standard release host (GitHub releases) and piping remote scripts to shell executes remote code before you inspect it. The package does include install.sh and sync_bridge.py locally, so manual/local install is possible and safer.
Credentials
The skill only needs a GitHub token with gist permission to operate; that is proportional to its purpose. The docs and code reference optional environment variables (OPENCLAW_WORKSPACE, OPENCLAW_STATE_DIR) for convenience; registry metadata listed no required env vars which is acceptable. The token is stored in a local sync_config.json and IGNORE_PATTERNS include sync_config.json so the token should not be uploaded — this is consistent with the stated design.
Persistence & Privilege
The installer modifies user shell rc files (~/.bashrc, ~/.zshrc) to add an alias and may create $HOME/.local/bin/sync-bridge; these are user-level changes (not system-wide). always:false and normal autonomous invocation settings are used. This is expected for a convenience installer but users should be aware it edits dotfiles.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-sync-bridge - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-sync-bridge触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.0
OpenClaw Sync Bridge 2.0.0 — Major Update
- Added intelligent workspace detection with auto-scan, env variable, and interactive selection.
- Introduced confirmation/preview steps before push and pull operations.
- Implemented automatic backup with version history (last 10 backups).
- Added diff command to preview changes before syncing.
- Enhanced GitHub Token validation with expiry prompts and improved safety.
- Updated documentation and install process for a smoother setup.
v1.0.0
OpenClaw Sync Bridge Skill 1.0.0
- Initial release: sync OpenClaw configs via a private GitHub Gist.
- One-click setup using a GitHub Token.
- Supports Mac, Windows, and Linux.
- Full overwrite sync (both push and pull).
- Automatically excludes sensitive files (e.g., config.json, .env).
- Includes status check and automated cloud sync instructions.
元数据
常见问题
OpenClaw Sync Bridge 是什么?
Automatically sync local and cloud OpenClaw configurations via private GitHub Gist with token-based setup and full overwrite synchronization. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 135 次。
如何安装 OpenClaw Sync Bridge?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-sync-bridge」即可一键安装,无需额外配置。
OpenClaw Sync Bridge 是免费的吗?
是的,OpenClaw Sync Bridge 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
OpenClaw Sync Bridge 支持哪些平台?
OpenClaw Sync Bridge 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 OpenClaw Sync Bridge?
由 JayShna(@jayshna)开发并维护,当前版本 v2.0.0。
推荐 Skills