# 输出文件指南：存放、部署与常见问题

> 本文档包含配置文件的详细存放指导、目录结构建议和 FAQ。仅在用户询问"文件放在哪里"、"如何使用配置"、"多个项目怎么办"等部署相关问题时才需要加载。

---

## 目录

1. [文件下载与存放说明](#文件下载与存放说明)
2. [配置文件用途与 OpenClaw 目录对应](#配置文件用途与-openclaw-目录对应)
3. [三种使用方法](#三种使用方法)
4. [目录结构建议](#目录结构建议)
5. [加载优先级](#加载优先级)
6. [如何找到 OpenClaw 配置目录](#如何找到-openclaw-配置目录)
7. [常见问题 FAQ](#常见问题-faq)

---

## 文件下载与存放说明

```
📂 本次生成的所有文件都在技能运行目录下，
   可以直接点击下载或复制到你的工作目录。
```

## 配置文件用途与 OpenClaw 目录对应

| 文件 | 放入你的 OpenClaw 配置目录 |
|------|--------------------------|
| `SOUL.md` | OpenClaw配置目录/SOUL.md |
| `USER.md` | OpenClaw配置目录/USER.md |
| `AGENTS.md` | OpenClaw配置目录/AGENTS.md |
| `TOOLS.md` | OpenClaw配置目录/TOOLS.md |
| `HEARTBEAT.md` | OpenClaw配置目录/HEARTBEAT.md |
| `IDENTITY.md` | OpenClaw配置目录/IDENTITY.md |

## 三种使用方法

**方法1️⃣：复制覆盖（推荐）**
把配置文件复制到你的 OpenClaw 配置目录，原有文件会被本次生成的内容覆盖。

**方法2️⃣：告诉 OpenClaw**
把配置文件发给 OpenClaw，说：「请用这些配置文件更新我的数字替身」

**方法3️⃣：下载到本地**
直接下载所有文件到本地，作为备份或版本管理。

⚠️ 如果不知道 OpenClaw 配置目录在哪里，可以问 OpenClaw：「我的配置文件存在哪里？」

---

## 目录结构建议

```
/你的工作目录/
├── 全局配置/                    # 全局共享（可选）
│   ├── SOUL.md
│   └── USER.md
│
├── [项目名称]/                 # 按项目存放
│   ├── SOUL.md               # 可继承全局 + 项目特定
│   ├── USER.md
│   ├── AGENTS.md             # 项目自动化规则
│   ├── TOOLS.md              # 项目工具连接
│   ├── HEARTBEAT.md          # 项目定时任务
│   └── IDENTITY.md           # 项目身份边界
│
└── skills/                    # Skills 存放
    └── sop-extractor/
```

## 加载优先级

```
项目目录配置 > OpenClaw全局配置 > 内置默认值
```

## 如何找到 OpenClaw 配置目录

如果不确定配置文件应该放在哪里，可以问 OpenClaw：
- 「我的配置文件存在哪里？」
- 「告诉我 OpenClaw 的配置目录路径」
- 「OpenClaw 配置文件夹在哪里？」

---

## 常见问题 FAQ

### Q：多个项目可以用同一套配置吗？
A：可以。把全局配置（SOUL.md, USER.md）放在 OpenClaw 全局配置目录，项目特定配置放在各自目录。

### Q：换电脑后配置会丢吗？
A：如果用云同步的目录（如 iCloud、OneDrive、NAS），配置文件会同步。建议把 OpenClaw 配置目录放在云同步盘里。

### Q：每次调研会覆盖之前的配置吗？
A：不会。每次调研会生成新的项目配置，旧配置保留。除非你明确选择覆盖。

### Q：ClawHub/SkillHub 搜索失败怎么办？
A：会自动生成 `skill-creation-prompt.md`，包含完整的自定义 Skill 创建提示词，可以手动创建或让 AI 助手基于提示词生成。

### Q：不知道 OpenClaw 配置目录在哪里？
A：直接问 OpenClaw「我的配置文件存在哪里？」，它会告诉你具体路径。