docs: update README for OpenClaw with AI install guide

This commit is contained in:
root
2026-04-15 16:29:25 +08:00
parent e8c275c8f8
commit 4caf115ec9
5 changed files with 562 additions and 173 deletions

View File

@ -0,0 +1,161 @@
---
name: graph_memory
description: 让 AI 拥有真正的长期记忆能力 - 检索、写入、删除记忆,管理人设和任务
when_to_use: 当需要 AI 记住持久信息、回忆过去交互、或管理长期任务时
version: 1.0.0
---
# GraphMemory 图记忆系统
让 AI 拥有真正的长期记忆能力。
## 这个技能做什么
这个技能教会 AI 如何使用图结构存储和检索记忆。AI 可以:
- 记住重要的信息(实体)
- 理解信息之间的关系(关系/三元组)
- 回忆相关的记忆
- 管理 AI 的人设(角色性格)
- 追踪长期任务
## 核心概念
### 实体 (Entity)
现实世界中的对象,如"用户"、"Python"、"WaterFlow"。每个实体有:
- 名称 (name)
- 类型 (type)
- 提及次数 (mentionCount)
### 关系 (Relation)
连接两个实体的关系,格式为三元组:
- 主体 (subject) - 关系 - 客体 (object)
- 例如:"用户" 喜欢 "编程"
## 可用命令
### 1. commit - 写入记忆
将信息写入记忆图。
**参数:**
- `triplets`: 三元组数组,格式为 `[{subject, relation, object}, ...]`
- `sessionId`: 会话 ID(可选)
- `turnId`: 轮次 ID(可选)
**示例:**
```
请记住:我喜欢编程,正在学习 TypeScript
```
AI 会执行:
```json
{
"action": "commit",
"params": {
"triplets": [
{"subject": "我", "relation": "喜欢", "object": "编程"},
{"subject": "我", "relation": "正在学习", "object": "TypeScript"}
]
}
}
```
### 2. recall - 检索记忆
从记忆图中检索相关信息。
**参数:**
- `queryIntent`: 搜索关键词
- `seedEntities`: 种子实体(可选)
- `sessionFilter`: 会话过滤(可选)
**示例:**
```
我之前说过我喜欢什么?
```
### 3. purge - 删除记忆
删除记忆图中的一些信息。
**参数:**
- `criteria`: 删除条件 `{subject, target, relation, sessionId}`
- `mode`: 删除模式 `soft`(标记删除)或 `hard`(彻底删除)
### 4. introspect - 查看状态
查看当前记忆状态统计。
**返回:**
- entityCount: 实体数量
- relationCount: 关系数量
### 5. persona_update - 更新人设
更新 AI 的角色/性格特征。
**参数:**
- `attributes`: 属性数组 `[{attribute, value}, ...]`
- `mode`: `merge`(合并)或 `replace`(替换)
**示例:**
```
我的角色是猫娘,性格活泼
```
### 6. persona_clear - 清除人设
清除 AI 的所有角色设定。
**参数:**
- `confirm`: 必须为 `true` 才能执行
### 7. task_create - 创建任务
创建长期任务节点。
**参数:**
- `task_id`: 唯一任务 ID
- `description`: 任务描述
- `info_nodes`: 相关信息节点(可选)
### 8. task_set_state - 设置任务状态
更新任务状态。
**参数:**
- `task_id`: 任务 ID
- `state`: 新状态 (`进行中`/`已完成`/`已暂停`/`已取消`)
### 9. task_delete - 删除任务
删除任务。
**参数:**
- `task_id`: 任务 ID
## 使用原则
1. **选择性记忆**:只记住重要和持久的信息
2. **结构化**:使用三元组格式存储关系
3. **定期清理**:删除过时或错误的信息
4. **关联思考**:利用关系进行联想记忆
## 关系类型参考
| 关系 | 含义 |
|------|------|
| 喜欢 | 偏好关系 |
| 是 | 类型关系 |
| 正在学习 | 进程关系 |
| 属于 | 归属关系 |
| 包含 | 组成关系 |
| has_description | 描述关系 |
| HAS_STATE | 状态关系 |
## 注意事项
- 每次交互后,AI 应该决定是否需要 commit 重要信息
- 使用 recall 来获取相关上下文,而不只是依赖当前对话
- persona 信息应该谨慎修改
- 任务可以跨会话追踪

View File

@ -0,0 +1,98 @@
---
name: graph_memory_persona
description: 管理 AI 人设 - 更新或清除 AI 角色特征
when_to_use: 当需要设置或修改 AI 的角色性格时
version: 1.0.0
---
# GraphMemory Persona 人设管理
管理 AI 的人设/角色特征。
## 这个技能做什么
这个技能让 AI 能够:
- 设置自己的角色/性格
- 更新人设信息
- 清除人设
## 可用命令
### 1. persona_update - 更新人设
**参数:**
- `attributes`: 属性数组 `[{attribute, value}, ...]`
- `mode`:
- `merge`: 合并到现有属性(默认)
- `replace`: 替换所有现有属性
**示例:**
```
# 方式一:合并更新
记住我的角色是猫娘
```
会执行:
```json
{
"action": "persona_update",
"params": {
"attributes": [
{"attribute": "角色", "value": "猫娘"}
],
"mode": "merge"
}
}
```
```
# 方式二:完全替换
我是一个专业的技术作家
```
会执行:
```json
{
"action": "persona_update",
"params": {
"attributes": [
{"attribute": "职业", "value": "技术作家"}
],
"mode": "replace"
}
}
```
### 2. persona_clear - 清除人设
**参数:**
- `confirm`: 必须为 `true` 才能执行
**示例:**
```
清除我的人设
```
会执行:
```json
{
"action": "persona_clear",
"params": {
"confirm": true
}
}
```
## 使用场景
- 初始化 AI 角色
- 调整 AI 性格
- 清除错误的人设
- 角色切换
- 设置专业领域
## 常见人设属性
| 属性 | 说明 | 示例值 |
|------|------|--------|
| 角色 | AI 的角色 | "猫娘"、"助手"、"专家" |
| 性格 | 性格特征 | "活泼"、"严肃"、"幽默" |
| 职业 | 专业领域 | "技术作家"、"程序员" |
| 语言风格 | 说话方式 | "简洁"、"详细" |

View File

@ -0,0 +1,134 @@
---
name: graph_memory_task
description: 管理连续性任务 - 创建、更新、删除任务节点
when_to_use: 当需要创建或管理长期/跨会话任务时
version: 1.0.0
---
# GraphMemory Task 任务管理
管理长期/连续性任务。
## 这个技能做什么
这个技能让 AI 能够:
- 创建新任务
- 追踪任务进度
- 更新任务状态
- 关联任务相关信息
- 删除任务
## 可用命令
### 1. task_create - 创建任务
**参数:**
- `task_id`: 唯一任务标识
- `description`: 任务描述
- `info_nodes`: 相关信息节点(可选)
**示例:**
```
帮我创建一个任务:学习 TypeScript
```
会执行:
```json
{
"action": "task_create",
"params": {
"task_id": "task_学习TypeScript",
"description": "学习 TypeScript",
"info_nodes": ["TypeScript文档", "教程链接"]
}
}
```
### 2. task_set_state - 设置状态
**参数:**
- `task_id`: 任务 ID
- `state`: 新状态
**可用状态:**
- `进行中`: 任务正在处理
- `已完成`: 任务已完成
- `已暂停`: 任务暂停
- `已取消`: 任务取消
**示例:**
```
TypeScript 学习任务完成了
```
会执行:
```json
{
"action": "task_set_state",
"params": {
"task_id": "task_学习TypeScript",
"state": "已完成"
}
}
```
### 3. task_delete - 删除任务
**参数:**
- `task_id`: 任务 ID
**示例:**
```
删除那个 TypeScript 任务
```
会执行:
```json
{
"action": "task_delete",
"params": {
"task_id": "task_学习TypeScript"
}
}
```
### 4. task_link_info - 关联信息
**参数:**
- `task_id`: 任务 ID
- `info_node`: 信息节点
**示例:**
```
给任务添加一个新资源
```
会执行:
```json
{
"action": "task_link_info",
"params": {
"task_id": "task_学习TypeScript",
"info_node": "新发现的教程"
}
}
```
## 使用场景
- 跨会话追踪任务进度
- 记录任务相关信息
- 管理复杂工作流
- 任务状态持久化
- 长期项目追踪
## 任务状态流转
```
创建 (进行中) → 进行中 → 已完成
↘ 已暂停
↘ 已取消
```
## 最佳实践
1. **具体描述**:任务描述要清晰具体
2. **关联信息**:为任务添加相关资料链接
3. **及时更新**:状态改变时立即更新
4. **清理完成**:已完成的任务及时删除或归档