🦞 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教程
夜雨聆风