# Env Setup

> AGI 环境一键同步工具。从 GitHub 仓库同步所有配置到本地：Skills 技能库、全局提示词、MCP 服务器配置、Output Styles。支持 Claude Code、Codex CLI、OpenClaw、Pi Coding Agent 等多平台。适用于多设备统一环境、换电脑恢复、团队共享配置等场景。

- Skill: `majiayu000/env-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/env-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/env-setup/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/env-setup

---


# AGI 环境一键同步工具

从 GitHub 仓库一键同步所有配置到本地 AI 开发环境，支持多平台。

## 支持的平台

| 平台 | Skills 目录 | 配置文件 |
|------|-------------|----------|
| Claude Code | `~/.claude/skills/` | `~/.claude.json`, `~/.claude/CLAUDE.md` |
| OpenClaw | `~/clawd/skills/` | `~/.openclaw/openclaw.json`, `~/clawd/AGENTS.md` |
| Codex CLI | `~/.codex/skills/` | `~/.codex/config.json`, `~/.codex/AGENTS.md` |
| Pi Coding Agent | `~/.pi/skills/` | `~/.pi/config.json` |

## 功能概述

### 同步内容

| 组件 | 来源 | 目标 |
|------|------|------|
| Skills | `skills/` | 各平台 skills 目录 |
| Output Styles | `config/output-styles/` | `~/.claude/output-styles/` |
| 全局提示词 | `config/CLAUDE.md` | 各平台全局提示词 |
| MCP Config | `config/mcp_config.json` | 各平台 MCP 配置 |
| Pass 密钥 | `~/.password-store/` | Git 同步 |

## 快速开始

### 一、克隆仓库

```bash
# 克隆到任意位置
git clone https://github.com/aAAaqwq/cc-skills.git ~/cc-skills
```

### 二、运行同步

```bash
# 同步到所有平台
python ~/cc-skills/env-setup/scripts/sync_env.py --target all

# 只同步到 Claude Code
python ~/cc-skills/env-setup/scripts/sync_env.py --target claude

# 只同步到 OpenClaw
python ~/cc-skills/env-setup/scripts/sync_env.py --target openclaw

# 只同步到 Codex
python ~/cc-skills/env-setup/scripts/sync_env.py --target codex
```

### 三、命令行选项

```bash
# 基本用法
python scripts/sync_env.py

# 指定目标平台
python scripts/sync_env.py --target claude|openclaw|codex|pi|all

# 强制覆盖
python scripts/sync_env.py --force

# 只同步特定组件
python scripts/sync_env.py --components skills mcp_config prompts

# 显示详细信息
python scripts/sync_env.py --verbose
```

**同步选项：**
- `skills` - 同步技能库
- `output_styles` - 同步对话风格
- `prompts` - 同步全局提示词
- `mcp_config` - 同步 MCP 配置

## 仓库结构

```
cc-skills/                    (GitHub 仓库)
├── README.md                 # 仓库说明
├── env-setup/                # 环境同步 skill
│   ├── SKILL.md
│   └── scripts/
│       └── sync_env.py       # 主同步脚本
├── config/                   # 配置模板
│   ├── output-styles/        # 对话风格
│   ├── CLAUDE.md             # Claude Code 全局提示词
│   ├── AGENTS.md             # OpenClaw/Codex 全局提示词
│   └── mcp_config.json       # MCP 服务器配置
├── pass-secrets/             # 密钥管理 skill
├── model-fallback/           # 模型降级 skill
├── openclaw-config/          # OpenClaw 配置 skill
└── ... (其他 skills)
```

## 配置文件格式

### mcp_config.json

```json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "${CONTEXT7_API_KEY}"]
    }
  },
  "allowedTools": [
    "mcp__github__*",
    "mcp__context7__*"
  ]
}
```

**注意：** 
- 使用 `${VAR_NAME}` 引用环境变量
- 敏感信息建议使用 Pass 管理：`pass api/github`

### AGENTS.md (OpenClaw/Codex 全局提示词)

```markdown
# AGENTS.md - Your Workspace

## First Run
...

## Memory
...

## Safety
...
```

### CLAUDE.md (Claude Code 全局提示词)

```markdown
# CLAUDE.md

## 身份
...

## 工作风格
...
```

## 平台特定配置

### Claude Code

```bash
# 配置位置
~/.claude.json              # MCP 配置
~/.claude/CLAUDE.md         # 全局提示词
~/.claude/output-styles/    # 对话风格
~/.claude/skills/           # Skills 目录
```

### OpenClaw

```bash
# 配置位置
~/.openclaw/openclaw.json                    # 主配置
~/.openclaw/agents/main/agent/models.json    # 模型配置
~/clawd/AGENTS.md                            # 全局提示词
~/clawd/SOUL.md                              # 身份配置
~/clawd/skills/                              # Skills 目录
```

### Codex CLI

```bash
# 配置位置
~/.codex/config.json        # 主配置
~/.codex/AGENTS.md          # 全局提示词
~/.codex/skills/            # Skills 目录
```

## MCP 配置同步

MCP 配置会同步到所有支持的平台：

| 平台 | MCP 配置文件 |
|------|-------------|
| Claude Code | `~/.claude.json` → `mcpServers` |
| OpenClaw | `~/.openclaw/openclaw.json` → `mcp` |
| Codex CLI | `~/.codex/config.json` → `mcpServers` |

### 同步行为

- **合并模式**（默认）：保留现有配置，添加/更新新配置
- **替换模式**：完全替换 MCP 配置

```bash
# 合并模式
python scripts/sync_env.py --components mcp_config

# 替换模式
python scripts/sync_env.py --components mcp_config --replace
```

## 使用场景

### 场景 1：新设备快速配置

```bash
# 1. 克隆仓库
git clone https://github.com/aAAaqwq/cc-skills.git ~/cc-skills

# 2. 同步到所有平台
python ~/cc-skills/env-setup/scripts/sync_env.py --target all --force

# 3. 导入 GPG 密钥（用于 Pass）
gpg --import gpg-private-key.asc

# 4. 克隆密钥库
git clone https://github.com/aAAaqwq/password-store.git ~/.password-store
```

### 场景 2：多平台开发

```bash
# 在 Claude Code 中开发
# 配置自动同步到 ~/.claude/

# 切换到 OpenClaw
python scripts/sync_env.py --target openclaw

# 切换到 Codex
python scripts/sync_env.py --target codex
```

### 场景 3：团队共享配置

```bash
# 团队成员克隆仓库
git clone https://github.com/team/shared-skills.git ~/shared-skills

# 同步配置
python ~/shared-skills/env-setup/scripts/sync_env.py --target all
```

### 场景 4：配置版本管理

```bash
# 更新配置后提交
git add .
git commit -m "Update MCP config"
git push

# 其他设备同步
git pull
python scripts/sync_env.py --target all
```

## 密钥管理集成

使用 `pass-secrets` skill 管理敏感信息：

```bash
# 存储 API 密钥
pass insert api/github
pass insert api/openai

# 在 MCP 配置中引用
{
  "env": {
    "GITHUB_TOKEN": "$(pass api/github)"
  }
}

# 或使用启动脚本
export GITHUB_TOKEN=$(pass api/github)
```

## 故障排查

### 同步失败

**问题：** "Permission denied"
- **解决：** 检查目标目录权限

**问题：** "Config file not found"
- **解决：** 确认平台已安装并运行过一次

**问题：** MCP 配置没有生效
- **解决：** 重启对应的 IDE/Agent

### 平台检测

```bash
# 检测已安装的平台
python scripts/sync_env.py --detect

# 输出示例：
# Claude Code: ✅ ~/.claude/
# OpenClaw: ✅ ~/.openclaw/
# Codex CLI: ❌ not found
# Pi Agent: ❌ not found
```

## 高级用法

### 自定义目标目录

```bash
python scripts/sync_env.py \
  --claude-dir "/custom/path/.claude" \
  --openclaw-dir "/custom/path/.openclaw"
```

### 排除特定 Skills

```bash
python scripts/sync_env.py --exclude backend-tester moltbook-integration
```

### 只同步特定 Skills

```bash
python scripts/sync_env.py --include pass-secrets model-fallback openclaw-config
```

### 自动化同步

创建 cron 任务：

```bash
# 每天同步一次
0 9 * * * cd ~/cc-skills && git pull && python env-setup/scripts/sync_env.py --target all
```

## 相关 Skills

- [pass-secrets](../pass-secrets/SKILL.md) - 密钥管理
- [openclaw-config](../openclaw-config/SKILL.md) - OpenClaw 配置
- [model-fallback](../model-fallback/SKILL.md) - 模型降级
- [mcp-installer](../mcp-installer/SKILL.md) - MCP 安装

---

*由小a维护 - AGI 通用技能库*