OpenClaw Memory-Wiki 持久化知识管理教程

2026-04-09 · 6 分钟进阶玩法

什么是 Memory-Wiki

Memory-Wiki 是 OpenClaw v2026.4.7 引入的持久化结构化知识系统。它不是简单的"更长上下文"，而是跨会话保留的、Agent 可读可写的 Wiki 式知识库。

与普通记忆系统的区别：

维度	Memory System	Memory-Wiki
存储方式	向量嵌入	结构化文档
检索方式	语义搜索	分类 + 链接
Agent 可写	自动提取	主动创建编辑
可审计	较弱	强（可追溯）
适合场景	对话上下文	运维 runbook、API 文档

核心优势

持久性：信息跨会话、跨重启保留
结构化：支持分类、标签、链接
可审计：所有读写有记录，适合企业级治理
Agent 自主维护：Agent 可以主动补充和更新知识
可检索：快速查找相关信息

启用 Memory-Wiki

在配置文件中启用：

# config.yaml
memory:
  wiki:
    enabled: true
    path: "./memory/wiki"
    format: "markdown"
    autoIndex: true

配置说明：

字段	说明
`enabled`	启用 Memory-Wiki
`path`	Wiki 存储路径
`format`	文档格式（markdown）
`autoIndex`	自动建立索引

Wiki 结构

建议的目录结构：

memory/wiki/
├── runbooks/
│   ├── deploy.md
│   ├── incident-response.md
│   └── backup.md
├── api-docs/
│   ├── internal-api.md
│   └── third-party.md
├── decisions/
│   ├── 2026-04-tech-stack.md
│   └── 2026-03-database-choice.md
└── playbooks/
    ├── customer-onboarding.md
    └── escalation.md

Agent 操作 Wiki

读取

Agent 可以通过自然语言查询 Wiki：

用户：部署流程是怎样的？
Agent：（读取 runbooks/deploy.md）
根据 Wiki 中的 runbook，部署流程是...

写入

Agent 可以自主创建或更新 Wiki 条目：

用户：把刚才我们讨论的 Redis 集群配置记录到 Wiki
Agent：好的，我会创建 runbooks/redis-cluster.md
       [创建文件]
       已保存到 Wiki

链接

Wiki 条目之间可以互相引用：

# deploy.md

## 前置检查
参见 [[runbooks/pre-deploy-checklist]]

## 失败回滚
参见 [[runbooks/rollback-procedure]]

实际应用场景

1. 团队 Runbook 管理

将运维操作手册放入 Wiki，Agent 可以指导新人或在事故时快速响应：

# 事故响应工作流
steps:
  - tool: wiki
    action: read
    path: runbooks/incident-response.md

  - tool: llm-task
    args:
      prompt: "根据 runbook 分析当前告警，给出响应步骤"
      context: $wiki.content

2. API 契约文档

# api-docs/user-service.md

## POST /api/users
创建新用户

### 请求体
- name: string (必填)
- email: string (必填)
- role: "admin" | "user"

### 响应
- 200: { id: string, createdAt: string }
- 400: 参数错误

Agent 调用 API 前自动查阅契约，确保参数正确。

3. 决策日志

# decisions/2026-04-database-migration.md

## 决策：从 MySQL 迁移到 PostgreSQL

### 时间
2026-04-09

### 原因
- JSON 字段查询性能需求
- 更好的扩展性

### 影响范围
- 后端服务全部
- 数据迁移预计耗时 4 小时

### 回滚方案
保留 MySQL 只读副本 2 周

4. 客户 Playbook

# playbooks/customer-xyz.md

## 客户 XYZ 公司

### 主要联系人
- 技术: Alice (alice@xyz.com)
- 商务: Bob (bob@xyz.com)

### 特殊要求
- 所有部署需要 24 小时提前通知
- 数据不能离开中国境内

与 Agent Memory 的配合

Memory-Wiki 和传统 Memory 系统可以共存：

Memory System：存储对话上下文、用户偏好、临时事实
Memory-Wiki：存储结构化文档、runbook、决策记录

两者互补，Agent 会根据查询类型自动选择：

用户："上次我们说到数据库迁移的方案是什么？"
  → Memory System（对话历史）

用户："redis 集群的运维手册"
  → Memory-Wiki（结构化文档）

版本控制

将 Wiki 纳入 Git 管理，获得完整的变更历史：

cd memory/wiki
git init
git add .
git commit -m "Initial wiki"

Agent 创建新条目后可以自动提交：

hooks:
  onWikiUpdate:
    - command: "cd memory/wiki && git add . && git commit -m 'Agent update'"

注意事项

Memory-Wiki 需要 OpenClaw v2026.4.7 或更高版本
Wiki 内容会部分加载到上下文，注意文件大小控制
敏感信息（密钥、凭证）不应放入 Wiki，使用 Secrets Management
建议定期备份 Wiki 目录
团队共享 Wiki 可以通过 Git 仓库同步