# OpenClaw Master-Doc 主存储

> **创建时间**:2026-07-02
> **创建人**:皮皮虾(OpenClaw 助手)
> **老大指示**:未来新增的所有 md 都放这里 + 同步到 Gitea

## 这是什么

所有由 OpenClaw(皮皮虾)生成/编辑的 **md 文档** 的统一存储位置。

**核心规则**:
- ✅ **所有** 新生成的 md 必须写到本目录
- ✅ 写完后必须推送到 Gitea:`https://gitea.94kan.cn/houhuan/openclaw-md-store`
- ❌ 不要把 md 散落在 `scripts/` `memory/` `drafts/` 等其它目录

## 命名规范

| 类型 | 命名格式 | 示例 |
|---|---|---|
| Gitea 抽取原文 | `YYYY-MM-DD-gitea-抽取.md` | `2026-07-02-gitea-抽取.md` |
| 改写归档 | `YYYY-MM-DD-改写归档.md` | `2026-07-01-改写归档.md` |
| 三平台素材 | `三平台素材-{ID}-{主题}-{日期}.md` | `三平台素材-ID749-希腊身份-2026-07-02.md` |
| 调研报告 | `{类型}-{关键词}-{日期}.md` | `抖音爆款调研-香港身份-2026-06-08.md` |
| 原创脚本 | `原创口播脚本-{关键词}-{日期}.md` | `原创口播脚本-香港身份-2026-07-02.md` |

## 当前内容(2026-07-02 创建时)

| 文件 | 说明 |
|---|---|
| `README.md` | 本文件 |
| `2026-07-01-gitea-抽取.md` | 7-01 抽取原文(3 条 S+A 精品) |
| `2026-07-01-改写归档.md` | 7-01 改写后的归档 |
| `2026-07-02-gitea-抽取.md` | 7-02 抽取原文 |
| `三平台素材-ID749-希腊身份-2026-07-02.md` | 今日新生成:基于 ID=749 的公众号+视频号+抖音三平台素材 |
| `原创口播脚本-香港身份-2026-07-02.md` | 6-08 调研配套的原创脚本 |
| `抖音爆款调研-香港身份-2026-06-08.md` | 抖音爆款调研报告 |

## 同步到 Gitea 的方法

### 方法 1:git push(推荐)

```bash
cd ~/.openclaw/workspace/master-doc
git add -A
git commit -m "新增:文件名"
git push origin main
```

### 方法 2:Gitea API 单文件上传

```python
import requests, base64
content = base64.b64encode(open('file.md','rb').read()).decode()
requests.put(
    'https://gitea.94kan.cn/api/v1/repos/houhuan/openclaw-md-store/contents/file.md',
    headers={'Authorization': 'token <TOKEN>'},
    json={'content': content, 'message': '新增', 'branch': 'main'}
)
```

## Gitea 仓库信息

- **URL**: https://gitea.94kan.cn/houhuan/openclaw-md-store
- **Owner**: houhuan
- **凭据**: `/home/huan/.openclaw/secrets/gitea.env`

## 后续 SOP(执行规则)

每次我(皮皮虾)生成新的 md 文件,必须:

1. ✅ 直接写到 `~/.openclaw/workspace/master-doc/` 下(不要写到 `memory/` `scripts/` 等其它位置)
2. ✅ 文件名按上面的"命名规范"
3. ✅ 写完后用 `git push` 同步到 Gitea
4. ✅ 给老大 Gitea URL

**例外**(可以保留在原位置):
- `MEMORY.md` / `SOUL.md` / `TOOLS.md` / `IDENTITY.md` / `USER.md` — 系统核心规则
- `memory/YYYY-MM-DD.md` — 工作日志
- `memory/lessons.md` / `memory/decisions.md` — 长期记忆
- `knowledge/` — 知识库

## 历史归档

逐步迁移老文件:
- 老的 `scripts/gitea-pickup/output/*.md` → `master-doc/`
- 老的 `scripts/gitea-pickup/rewrites_*.md` → `master-doc/`
- 老的 `drafts/*.md` → `master-doc/`
- 老的 `memory/douyin-*.md` → `master-doc/`

---

*本规则由皮皮虾于 2026-07-02 创建,持续生效*