# 🚀 OpenClaw 自动配置助手 (Auto-Config-Skiller) 使用指南

本助手旨在解决 OpenClaw 新手“环境配置慢、技能安装杂、人设缺失”的痛点，提供一键式、傻瓜化的配置体验。

---

## 🛠 一键配置标准工作流 (Standard Workflow)

只需运行一个命令，即可完成从环境体检到灵魂注入的全过程：
```bash
./setup.sh
```

### 第一步：全方位环境诊断 (Diagnosis)
脚本启动后，会立即对您的系统进行“核磁共振”式的体检：
- **核心组件**：检测 Python 3.9+、Git、Node.js 是否就绪。
- **环境探测**：自动识别当前的 OpenClaw 版本。
- **资源就绪**：检查磁盘写入权限及 `.env` 配置文件状态。
- **网络测试**：实时测试 GitHub 及官方注册表的连通性，自动切换国内备用镜像。

### 第二步：飞书通讯枢纽部署 (Feishu Plugin)
通过官方工具链 `@larksuite/openclaw-lark-tools` 快速建立通讯桥梁：
- **自动安装**：一键部署官方飞书插件。
- **引导配置**：脚本会引导您完成飞书机器人的创建与参数填入。

### 第三步：核心技能库全量分发 (Skill Orchestration)
本工具采用了 **“Tencent SkillHub 优先 + ClawHub 补全 + Git 深度同步”** 的三重保障机制：
- **免登录安装**：优先使用腾讯源安装 `skill-vetter`、`channels-setup` 等高分技能，绕过官方源的付费或登录校验。
- **高分应用全家桶**：自动为您装好 `self-improving-agent`、`github`、`agent-browser` 等 Agent 必备工具。
- **版本锁定**：自动匹配各个技能的最稳定分支（main/master），确保环境一致性。

### 第四步：交互式配置生成 (Auto .env)
再也不用手动去复制粘贴 `.env.example`：
- **对话式填写**：脚本会通过问答方式，引导您输入飞书密钥、AI API Key 等关键参数。
- **即时生效**：自动生成 `.env` 文件，实现“配完即用”。

### 第五步：AI 灵魂注入 (Persona Injection)
基于开源高分项目 `msitarzewski/agency-agents`，为您的 Agent 选择一个职业身份：
- **预设库**：内置 AI 工程师、架构师、代码审查专家等 5 大经典人设。
- **一键下载**：自动下载 Prompt 到本地 `persona.md`，您可以直接将其内容作为 System Prompt 注入 Agent 的大脑。

---

## 🌟 进阶运维场景

### 1. 定期技能体检
如果您在运行过程中发现某个技能库代码过旧，再次运行 `./setup.sh`，脚本会自动执行 `git pull` 或 `clawhub update` 增量更新。

### 2. 切换人设
想让您的 Agent 从“AI 工程师”变成“软件架构师”？只需再次运行脚本，在最后环节重新选择人设即可覆盖下载。

## 💡 常见问题 (FAQ)
- **Q: 提示 skillhub 未安装怎么办？**
  - A: 脚本会主动询问是否自动安装。选择 `Y` 即可一键部署腾讯官方镜像工具。
- **Q: .env 文件写错了想改？**
  - A: 再次运行脚本，在配置环节选择 `y` 即可重新进行交互式填写。
- **Q: 安装失败了？**
  - A: 请检查网络连接。若官方源不稳定，工具会自动切换镜像源，重试通常能解决问题。