OpenClaw 知识结构大纲

🦞 OpenClaw 知识结构大纲

一、入门基础

1.1 什么是 OpenClaw？
- 定义：自托管 AI 网关
- 作用：连接聊天软件和 AI 助手
- 支持渠道：微信、Telegram、Discord、WhatsApp、iMessage 等

1.2 安装与启动
- 安装方式
- 启动 Gateway
- 初始配置（onboard/wizard）
- 控制台 UI（Dashboard）

二、核心概念

2.1 Workspace（工作区）
- 目录位置：~/.openclaw/workspace
- 核心文件结构
- 与 ~/.openclaw/ 的区别

2.2 记忆系统（Memory）
- 双层记忆架构
- 短期：memory/日期.md
- 长期：MEMORY.md
- 记忆写入时机
- 自动记忆flush机制

2.3 Session（会话）
- 会话类型
- 上下文管理
- 会话压缩（Compaction）
- 会话修剪（Pruning）

2.4 Agent（智能体）
- Agent 运行时
- Agent 循环
- 多 Agent 路由

三、配置文件

3.1 核心文件
- SOUL.md — AI 性格
- USER.md — 用户信息
- AGENTS.md — 行为规则
- IDENTITY.md — AI 身份
- TOOLS.md — 工具说明
- HEARTBEAT.md — 心跳任务

3.2 配置管理
- openclaw.json 结构
- 环境变量
- 凭证管理（credentials/）

四、自动化

4.1 Cron Jobs（定时任务）
- 一次性任务
- 循环任务（cron 表达式）
- 任务类型：main / isolated / current / custom session
- 交付模式：announce / webhook / none

4.2 Heartbeat（心跳）
- 心跳机制
- 与 Cron 的区别
- 适用场景

4.3 Hooks（钩子）
- 启动钩子
- 消息钩子

4.4 Polls（轮询）
- 定期检查

五、技能系统（Skills）

5.1 技能概念
- 什么是 Skill
- 技能来源：ClawHub

5.2 技能管理
- 安装技能
- 更新技能
- 列出技能
- 移除技能

5.3 内置技能
- 天气
- 邮件
- 日历
- 文件处理
- 等等

六、渠道配置（Channels）

6.1 支持的渠道
渠道 说明

微信 weixin / wechat-access
Telegram Bot API
WhatsApp -
Discord -
iMessage -
Slack -
飞书 -
Signal -
... ...

6.2 渠道路由
- 消息路由规则
- 群组消息
- 广播组

6.3 配对（Pairing）
- 设备配对
- 扫码连接

七、进阶功能

7.1 模型管理
- 模型提供商
- 模型切换
- 失败转移（Failover）

7.2 上下文管理
- 上下文引擎
- 系统提示词

7.3 向量记忆
- 语义搜索
- 混合搜索（BM25 + 向量）

7.4 OAuth 认证

7.5 Webhooks
- 接收 Webhook
- 发送 Webhook

八、运维

8.1 命令行（CLI）
- 常用命令列表
- 完整参考

8.2 诊断与调试
- openclaw doctor
- 日志查看
- 问题排查

8.3 安全
- 沙箱配置
- 密钥管理
- 安全加固

8.4 备份与恢复
- 备份策略
- 迁移

8.5 更新升级

九、API 与开发

9.1 MCP（Model Context Protocol）
- MCP 服务器
- 工具定义

9.2 插件系统
- 插件类型
- 插件市场

9.3 自定义开发

十、参考资源

- 📖 官方文档：docs.openclaw.ai
- 🛒 技能商店：clawhub.com
- 💬 社区 Discord
- 🐙 GitHub
#openclaw教程