- 基础入门
- 记忆文件管理
- 工作区文件详解
- 多代理路由
- 数据库设计方案
- 高级配置技巧
1.1 什么是 OpenClaw？
OpenClaw 是一个自托管的 AI 代理网关，可以连接 WhatsApp、Telegram、Discord、飞书等多个聊天平台到 AI 代理。
核心特点：
- 自托管，数据完全在你控制下
- 多通道支持，一个网关服务多个平台
- 代理原生，支持工具使用、会话、记忆
- 开源，MIT 许可证
1.2 快速开始
1.3 核心概念
概念 说明
Gateway 网关进程，是会话、路由和通道连接的单一事实来源
Agent 代理，有自己的工作区、状态目录和会话存储
Workspace 工作区，代理的”家”，存放记忆文件和配置
Session 会话，聊天历史和路由状态
Channel 通道，WhatsApp、Telegram、飞书等
2.1 记忆文件架构
OpenClaw 使用两层记忆系统：
2.2 记忆文件使用规则
MEMORY.md（长期记忆）
- 存储决策、偏好、持久事实
- 仅在主私密会话加载，不在群组中加载
- 定期审查和更新
memory/YYYY-MM-DD.md（每日日志）
- 存储日常笔记和运行上下文
- 会话开始时读取今天和昨天的文件
- 追加式写入，不要删除
2.3 如何正确写入记忆
当需要记住某事时：
- 如果是持久事实 → 写入
- 如果是日常事件 → 写入
- 不要只在”脑子里记”，一定要写入文件
示例：写入记忆
2.4 记忆工具使用
OpenClaw 提供两个记忆工具：
工具 说明 语义搜索，查找相关笔记 定向读取特定文件/行范围
使用示例：
2.5 自动记忆刷新
当会话接近自动压缩时，OpenClaw 会触发静默的代理回合，提醒模型在上下文压缩前写入持久记忆。
配置选项：
3.1 工作区文件地图
3.2 各文件详细说明
AGENTS.md - 代理操作指令
这是代理的”操作手册”，每次会话开始时加载。
内容建议：
- 代理应该如何使用记忆
- 规则、优先级和”如何行为”的细节
- 工具使用指南
示例：
SOUL.md - 人格和灵魂
定义代理的人格、语气和边界，每次会话加载。
示例：
USER.md - 用户信息
关于用户的信息，每次会话加载。
示例：
IDENTITY.md - 代理身份
代理的名字、生物、氛围和表情符号。
示例：
TOOLS.md - 本地工具说明
关于本地工具和约定的说明，不控制工具可用性，只是指导。
示例：
HEARTBEAT.md - 心跳检查清单
可选的微小清单，用于心跳运行，保持简短以避免 token 消耗。
示例：
3.3 工作区 Git 备份（推荐）
将工作区放在私有的 Git 仓库中，以便备份和恢复。
步骤：
建议的 .gitignore：
4.1 什么是多代理？
一个”代理”是一个完全范围的大脑，有自己的：
- 工作区（文件、AGENTS.md/SOUL.md/USER.md、本地笔记、人格规则）
- 状态目录（）用于 auth 配置文件、模型注册表和每个代理的配置
- 会话存储（聊天历史 + 路由状态）在
4.2 路径快速地图
路径 说明 配置文件 状态目录 工作区 代理目录 会话
4.3 添加新代理
使用代理向导添加新的隔离代理：
4.4 配置示例
5.1 为什么需要数据库？
虽然 OpenClaw 使用 Markdown 文件作为记忆，但对于某些应用场景，你可能需要一个结构化的数据库：
- 存储大量结构化数据
- 快速查询和过滤
- 数据关联和关系
- 多用户数据隔离
5.2 推荐数据库方案
方案一：SQLite（轻量级推荐）
优点：
- 零配置，文件型数据库
- 无需服务器进程
- 完全在本地，数据安全
- 支持 SQL 查询
- 备份简单（复制文件即可）
适用场景：
- 个人使用
- 中小规模数据
- 结构化数据存储
表设计示例：
Python 操作示例：
方案二：DuckDB（分析型推荐）
优点：
- 比 SQLite 更快的分析查询
- 支持向量搜索（用于记忆检索）
- 兼容 SQLite 语法
- 支持列式存储
适用场景：
- 大量数据分析
- 向量搜索和相似度查询
- 日志和时间序列数据
方案三：PostgreSQL（生产级推荐）
优点：
- 企业级功能
- 强大的 JSON 支持
- 向量扩展（pgvector）
- 并发性能好
适用场景：
- 多用户生产环境
- 需要高可用性
- 复杂查询需求
5.3 数据库 + Markdown 混合方案
推荐架构：
分工：
存储方式 用途 示例
Markdown 非结构化、叙事性记忆 用户偏好、重要决策、日常笔记
数据库 结构化、可查询数据 用户信息、任务管理、对话历史、记忆索引
混合优势：
- Markdown 易读易编辑，适合人类维护
- 数据库支持快速查询和复杂关系
- 可以写脚本双向同步
6.1 配置文件结构
配置文件位置：
核心配置项：
6.2 通道配置详解
飞书配置示例：
私聊策略（dmPolicy）：
策略 说明 用户需要配对审批 所有人都可以私聊 仅白名单用户可以私聊
6.3 常用 CLI 命令
6.4 心跳和自动化
HEARTBEAT.md 示例：
Cron 定时任务配置：
6.5 安全**实践
- 使用私有的 Git 仓库备份工作区
- 不要提交 API 密钥和密码到 Git
- 使用白名单限制通道访问
- 定期审查权限配置
- 启用沙箱模式限制文件访问
沙箱配置示例：
这个教程涵盖了：
- ✅ 基础入门 - OpenClaw 核心概念和快速开始
- ✅ 记忆管理 - 两层记忆系统的正确使用方法
- ✅ 工作区文件 - 各文件的作用和编辑指南
- ✅ 多代理路由 - 配置多个隔离代理
- ✅ 数据库设计 - SQLite 数据库方案和表设计
- ✅ 高级配置 - 配置文件、CLI 命令、安全**实践
希望这个教程能帮助你更好地使用 OpenClaw！有问题随时问。
教程版本：v1.0
最后更新：2026-03-11
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/229892.html