clawmemoryai

# ClawMemory Hub Skill v2.3.0

ClawMemory Hub — https://clawmemory.ai — AI 记忆版本控制平台。把对话原文快照保存到云端，支持搜索、分享和 Fork。

## Setup

配置文件位于 `~/.clawmemoryai/config.json`：
```json
{
  "baseUrl": "https://clawmemory.ai",
  "apiKey": "cmh_...",
  "defaultUser": "username"
}
```

首次运行：`bash ~/.openclaw/workspace/skills/clawmemoryai/scripts/setup.sh`

获取 API Key：https://clawmemory.ai/settings/api-keys
（在 API Keys 页面给 Key 起一个备注名，比如「我的 OpenClaw」，点「生成 API Key」）

---

## 🚀 对话启动流程（每次新对话开始时执行）

```bash
CM=~/.openclaw/workspace/skills/clawmemoryai/scripts/cm.sh

# 1. 加载默认记忆库的 summary，注入到系统提示词
MEMORY_CONTEXT=$(bash $CM load)

# 如果有内容，注入到当前对话的上下文：
# "以下是用户的历史记忆上下文：\n$MEMORY_CONTEXT"
```

用户说「切换记忆库」时：
```bash
bash $CM switch "项目名"
bash $CM switch "alice/project-x"
```

Fork 激活流程：用户在 Hub 页面 Fork 某个记忆库后，点「立即激活为默认记忆库」，下次对话自动加载。

---

## Core Operations (cm.sh)

```bash
CM=~/.openclaw/workspace/skills/clawmemoryai/scripts/cm.sh

# 列出记忆库
bash $CM repos list

# 创建记忆库（默认私密）
bash $CM repos create <name> [description] [public|private]

# 提交记忆（turns 格式，原文保存）
bash $CM commit <owner>/<repo> "标题" "内容"

# 从文件提交
bash $CM commit <owner>/<repo> "标题" @/path/to/file.md

# 列出 commits
bash $CM commits <owner>/<repo> [limit]

# 搜索记忆
bash $CM search <owner>/<repo> "关键词"

# 获取 commit 内容
bash $CM content <owner>/<repo> <commitId>

# 当前用户信息
bash $CM whoami

# 管理协作者
bash $CM collab add <owner>/<repo> <username> read|use|write
bash $CM collab list <owner>/<repo>

# 默认记忆库
bash $CM default get
bash $CM default set <repoId>
```

---

## 🎯 意图检测与自动记录（核心行为规范）

**当用户说以下内容时，立即触发对应行为：**

### 1. 创建项目并开始记录

触发词：`创建项目`、`新建记忆库`、`开始记录`、`create project`、`start recording`

**处理流程：**
```
1. 调用 cm.sh repo...