SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场env-setup

env-setup

部署与运维

查看项目

更新于 10-15 10:22

技能介绍

用途

env-setup 是一个 Claude Code 与 OpenClaw 环境一键同步工具，用于将配置从 GitHub 仓库同步到本地环境。适用于多设备统一环境、换电脑恢复、团队共享配置以及配置版本管理等场景。

主要能力

该 skill 提供一键同步功能，通过 sync_env.py 脚本将配置从 GitHub 仓库同步到本地。同步内容包括：

  • Output Styles：从 config/output-styles/ 同步到 ~/.claude/output-styles/，用于 Claude Code 对话风格。
  • CLAUDE.md：从 config/CLAUDE.md 同步到 ~/.claude/CLAUDE.md，作为全局提示词。
  • MCP Config：从 config/mcp_config.json 合并到 ~/.claude.json，用于 MCP 服务器。
  • Agent Configs：从 agents/ 同步到 ~/.openclaw/agents/，用于 OpenClaw Agent 配置。
  • MCP Servers：从 mcp/ 集成到 ~/.claude.json，作为 MCP 服务器独立配置。
  • Plugins：从 plugins/ 同步到 ~/.openclaw/plugins/，用于 OpenClaw 插件配置。

仓库结构包含 env-setup.skill（含 SKILL.md、scripts/ 与 config/）、agents/、mcp/ 和 plugins/ 等目录。

使用方式

一、初始化 GitHub 仓库（在主设备上）：

mkdir claude-env-sync
cd claude-env-sync
cp -r ~/.claude/skills/env-setup ./
cp -r ~/.claude/output-styles/* env-setup/config/output-styles/
cp ~/.claude/CLAUDE.md env-setup/config/
cp -r ~/.openclaw/agents/* env-setup/agents/
mkdir -p env-setup/mcp
mkdir -p env-setup/plugins
git init
git add .
git commit -m "Initial Claude env config"
git remote add origin https://github.com/yourusername/claude-env-sync.git
git push -u origin main

二、在新设备上同步：

cd ~/.claude/skills
git clone https://github.com/yourusername/claude-env-sync.git
python ~/.claude/skills/claude-env-sync/env-setup/scripts/sync_env.py

同步后需重启 Claude Code / OpenClaw Gateway。

三、命令行选项：

python scripts/sync_env.py
python scripts/sync_env.py --force
python scripts/sync_env.py --components agents mcp plugins
python scripts/sync_env.py --claude-dir "/path/to/.claude" --openclaw-dir "/path/to/.openclaw"

同步选项包括 output_styles、claude_md、mcp_config、agents、mcp、plugins。

适用场景

  • 多设备环境统一：主设备更新配置后推送，其他设备拉取并运行 sync_env.py。
  • 团队共享配置：创建团队 GitHub 仓库，成员克隆到 ~/.claude/skills/ 并定期同步。
  • 快速换电脑：新电脑克隆仓库后运行 sync_env.py --force。
  • 版本管理配置：通过 git log 与 git checkout 回滚到之前的配置。

限制与注意事项

  • 配置同步策略：MCP 配置采用合并模式，不覆盖现有其他 MCP 服务器；Agent 与插件配置直接复制到目标目录，会覆盖同名项；不使用 --force 时跳过已存在文件（MCP 配置始终合并），使用 --force 时覆盖已存在文件。
  • 同步完成后需重启应用才能生效：Claude Code 的 Output styles 会重新加载，OpenClaw Gateway 的 Agents/MCP/Plugins 会重新加载。
  • 安全提醒：不要在仓库中提交真实的 API keys 或 tokens，敏感信息应使用环境变量或本地配置文件（在 .gitignore 中排除），使用占位符标注密钥位置。
  • 跨平台兼容：脚本自动处理 Windows/macOS/Linux 路径差异，配置文件使用 UTF-8 编码。
  • 故障排查：如遇 "config/agents not found" 需确认仓库结构正确；如遇 ".claude.json not found" 需确认 Claude Code/OpenClaw 已安装并运行过一次；如 Agent 配置未生效需检查格式并重启 OpenClaw Gateway。
  • 若意外提交密钥，可使用 git filter-branch 或 git filter-repo 从历史中删除。