OpenClaw 入门与理解
发表评论
3 views

OpenClaw 框架

8 个核心文件：

AGENTS.md：Agent职责声明，决定工具权限 
SOUL.md：个性化提示词，注入system prompt 
TOOLS.md：工具白名单/黑名单，安全边界 
IDENTITY.md：身份标识（name/avatar），通道展示 
USER.md：用户偏好，上下文先验 
HEARTBEAT.md：定时任务配置（可选） 
BOOTSTRAP.md：首次onboarding引导（一次性消费） 
MEMORY.md：用户记忆文档（RAG源）

上述文件顺序也对应着 OpenClaw 的执行顺序；AGENTS定义能力边界，SOUL注入灵魂，TOOLS划定禁区，这8个文件构成Agent的完整人格

4 个特性说明：

  • 瞬态实例：Agent 并非长驻进程，而是随会话加载（per-session）；每个对话都是一次完整的加载-执行-销毁循环，确保配置实时生效
  • 内存管理：（1）当对话太长时，自动将旧消息总结并写入 JSON 文件，来实现持久化压缩（2）对冗余的工具执行结果进行临时裁剪，防止上下文窗口溢出（3）确保重要的指令被明确写入 MEMORY.md，避免信息压缩导致的指令丢失
  • 多 Agent 协作：（1）sessions_send 同步通信模式，用于不同 SubAgent 之间的信息交流（2）sessions_spawn 任务委派模式，建立独立环境来执行任务，并在完成后进行汇报（3）心跳机制，系统会在固定时间段内发送指令，强制唤醒模型去执行周期性任务（4）任务排程，配合心跳机制来避免 Agent 因任务堵塞而导致的工作停止
  • 安全控制：建议采取严格的数据隔离与权限管控，不要提供重要的账号密码信息，不要将重要的资料和 Agent 放一起，定期检查 AI 的工具调用和决策过程

OpenClaw 启动过程：

OpenClaw 细节

（1）AGENTS. Md 龙虾的灵魂，主要包括以下内容

  • 组织结构：包含源代码、插件、名称规范、测试与文档等说明
  • 架构边界：明确插件、渠道、模型、网关协议和测试的边界
  • 文档链接：说明文档托管平台与阅读技巧，说明文档的基本要求
  • 开发环境：运行环境与依赖处理，构建与测试命令，类型与格式检查
  • 流程管理：编码风格与命名规范，发布工作流，测试指南，Git 说明
  • 安全配置：环境变量与凭证存储，多智能体协作注意事项与安全约束

（2）MEMORY.md 记忆的诞生，从会话、日记到核心记忆

  • 会话信息： .openclaw/agents/ceo/sessions/xxxx.jsonl；每个会话都会单独维护一个 .jsonl 文件，并对应一个唯一的 session-uuid
  • 按天记录的记忆：.openclaw/workspace-ceo/memory/YYYY-MM-DD.md；当会话信息过长时，自动触发 Agent 将信息写入记忆，并进行会话的信息压缩
  • 精练后的核心记忆：.openclaw/workspace-ceo/MEMORY.md

（3）Skills 精细化管控

  • 每个 Agent 只需要关注 skill 列表（名称、描述、路径），并按需加载需要的 skills，同时过滤条件（requires.bins/env/config）不满足的 skills
  • 区分通用 skills 和特定 Agent 的专属 skills，避免过多 skills 造成上下文负担
  • 推荐定期使用高阶模型对 skills 进行扫描 ：清理低质量、冲突、不必要的 skill

Skills 推荐

个人推荐

其他推荐（未体验）

参考：

玩转 OpenClaw，你需要了解的：核心架构、运作原理、Agent 部署步骤
李宏毅 - 以 OpenClaw 為例介紹 AI Agent 的運作原理

往年同期文章