如果你在搜索以下问题,这篇文章就是你要找的:
- OpenClaw AGENTS.md 怎么写?有没有现成模板?
- OpenClaw 聊着聊着 AI 就“失忆”了,memoryFlush 怎么配置?
- OpenClaw 怎么让 AI 自己维护记忆、防止记忆腐烂?
- OpenClaw 子 Agent 怎么用?怎么让 AI 并行处理任务?
- OpenClaw 怎么设置每天自动发新闻摘要、定时周报?
- OpenClaw Discord 接入手把手教程,MESSAGE CONTENT INTENT 应该怎么开?
- OpenClaw Telegram Bot 怎么配置?
- OpenClaw 怎么开发自定义 Skill?
- 用免费 embedding API(SiliconFlow bge-m3)配置 OpenClaw memorySearch?
本篇覆盖 7 个主题,每个都是手把手级别,配置可直接复制粘贴:
- AGENTS.md 配置 — 给 AI 写一部行为宪法
- 记忆系统实战 — 用 memoryFlush 解决 AI 失忆,让记忆自动维护
- 子 Agent 并行任务 — 一个人变一支团队
- Cron 定时任务配置 — 精确到分钟的 AI 自动化
- Skill 开发入门 — 教 AI 学新技能
- 多渠道接入(Discord / Telegram) — 随时随地找到你的 AI
- openclaw.json 配置速查表 — 把每个参数调到最优
本篇默认你已经:装好了 OpenClaw 并能正常聊天、写过 SOUL.md / USER.md / IDENTITY.md、知道 MEMORY.md 和 memorySearch 是什么。
先看一眼调教前后的效果对比:
AGENTS.md 是什么?和 SOUL.md 有什么区别?
很多人在搜"OpenClaw AGENTS.md 怎么写",先说清楚它跟其他配置文件的关系:
- SOUL.md = 性格(“你是一个随和、实在的助手”)
- USER.md = 用户信息(“你在帮谁”)
- AGENTS.md = 工作手册(“每天上班先看邮件,写完代码要测试,删文件前要问我”)
上篇写了 SOUL.md、USER.md、IDENTITY.md,但 AI 仍然不知道怎么工作:不知道每次新对话该先读什么文件,不知道记忆该写到哪里,不知道哪些操作自己做、哪些要先问你。
这就是 AGENTS.md 的作用——它是 AI 的工作手册。
AGENTS.md 放在 workspace 根目录(跟 SOUL.md 同级),OpenClaw 每次新 session 都会自动加载它。
OpenClaw Session 启动流程:AI 醒来第一件事该做什么?
AI 每次新 session 都是"失忆"状态,需要明确告诉它醒来后按什么顺序读文件来恢复记忆:
Before doing anything else:
- Read — this is who you are
- Read — this is who you’re helping
- Read (today + yesterday) for recent context
- If in MAIN SESSION (direct chat with your human): Also read
Don’t ask permission. Just do it.
逐行解释:
第 1-2 步:读 SOUL.md 和 USER.md。这两个文件很小(不到 1KB),读了之后 AI 就知道自己是谁、在帮谁。
第 3 步:读今天和昨天的日志。日志里记录了最近发生的事,读完之后 AI 就能接上之前的工作。读昨天的原因:凌晨 1 点今天的日志可能还是空的。
第 4 步:只在主 session 读 MEMORY.md。OpenClaw 里有四种 session 类型:
MEMORY.md 里可能包含你的个人信息,限制只在主 session 读,防止在群聊里泄露。
💡 你不需要手动判断当前是什么 session。OpenClaw 的 system prompt 里会告诉 AI 当前的 session 类型。
OpenClaw AGENTS.md 记忆写入规范:教 AI 怎么记笔记
光会读记忆不够,还得教它怎么写记忆。未规范的 AI 要么全堆到 MEMORY.md 里(变成流水账),要么根本不写(下次就忘了)。
在 AGENTS.md 里加上写入规范:
You wake up fresh each session. These files are your continuity.
记忆分层
写入规则
- 日志写入 ,格式见下方
- 项目状态:项目有进展时同步更新
- 教训:踩坑后写入
- MEMORY.md:只在索引变化时更新,保持精简
日志格式
[PROJECT:名称] 标题
- 结论: 一句话总结
- 文件变更: 涉及的文件
- 教训: 踩坑点(如有)
- 标签: #tag1 #tag2
铁律
- 记结论不记过程
- 标签便于 memorySearch 检索
- “Mental notes” don’t survive session restarts. Files do.
记结论不记过程是核心原则。好日志 vs 烂日志对比:
❌ 烂日志(浪费 token,检索精度差):
部署
今天部署了项目。先试了直接跑,报错了。然后查了半天,发现是端口被占了……(三页流水账)
✅ 好日志(精简,memorySearch 高命中率):
[PROJECT:MyApp] 部署完成
- 结论: 用 nginx 反代部署成功,监听 80 端口
- 文件变更:
- 教训: 直接暴露端口不可行,必须走 nginx 反代
- 标签: #myapp #deploy #nginx
OpenClaw 安全边界配置:AI 能自己做什么,什么要先问你
在 AGENTS.md 里加上:
- Don’t exfiltrate private data. Ever.
- Don’t run destructive commands without asking.
- > (recoverable beats gone forever)
- When in doubt, ask.
Safe to do freely:
- Read files, explore, organize, learn
- Search the web, check calendars
- Work within this workspace
Ask first:
- Sending emails, tweets, public posts
- Anything that leaves the machine
- Anything you’re uncertain about
完整 AGENTS.md 模板(可直接复制粘贴)
This folder is home. Treat it that way.
Before doing anything else:
- Read — this is who you are
- Read — this is who you’re helping
- Read (today + yesterday) for recent context
- If in MAIN SESSION: Also read
Don’t ask permission. Just do it.
You wake up fresh each session. These files are your continuity:
写入规则
- 日志写入 ,记结论不记过程
- 项目有进展时同步更新
- 踩坑后写入
- MEMORY.md 只在索引变化时更新
- 想记住就写文件,不要靠"记在脑子里"
日志格式
[PROJECT:名称] 标题
- 结论: 一句话总结
- 文件变更: 涉及的文件
- 教训: 踩坑点(如有)
- 标签: #tag1 #tag2
- Don’t exfiltrate private data. Ever.
- Don’t run destructive commands without asking.
- >
- When in doubt, ask.
Safe to do freely: Read files, search, organize, work within workspace
Ask first: Sending emails/tweets, anything that leaves the machine
Skills provide your tools. When you need one, check its SKILL.md.
💡 这个模板是精简版起点。随着使用越来越深入,你会不断往里加规则。我的 AGENTS.md 现在已经有 200 多行了,但都是一点点积累的。
为什么 OpenClaw 聊着聊着 AI 会"失忆"?
这是搜索量很高的一个问题。原因是 OpenClaw 的上下文压缩(compaction)触发了。
每个模型都有上下文窗口限制(Claude 是 200K token)。当对话接近这个限制时,OpenClaw 会自动把旧对话压缩成摘要腾出空间——压缩过程中可能丢失细节。
OpenClaw memoryFlush 配置方法:压缩前自动保存关键信息
解决方案:开启 memoryFlush,在压缩触发之前,先让 AI 把重要信息写入文件。
在 openclaw.json 里加上:
GPT plus 代充 只需 145
参数说明:
💡 memoryFlush 静默执行,不打断对话。开了 verbose 模式(/verbose)可以看到 🧹 Auto-compaction complete 的提示。
OpenClaw memorySearch 精度优化:结构化日志大幅提升检索命中率
memorySearch 的底层是向量语义检索,结构化日志的命中率比非结构化日志高得多:
搜索词:“nginx 部署问题”
❌ 非结构化日志(命中率低):
今天折腾了一天,先搞了数据库迁移,然后部署了新版本,nginx 配置改了一下…
✅ 结构化日志(命中率高):
[PROJECT:MyApp] nginx 反代配置
- 结论: 用 nginx 反代部署成功
- 教训: upstream 要用 127.0.0.1 不要用 localhost(IPv6 问题)
- 标签: #nginx #deploy #myapp
用免费 SiliconFlow bge-m3 配置 OpenClaw memorySearch
国内用户最快上手的方案——SiliconFlow 提供的 bge-m3 向量模型完全免费:
为什么推荐 bge-m3? 完全免费、中英文双语支持好、向量维度 1024 精度和性能平衡好。
获取方式:去 siliconflow.cn 注册 → 控制台 → 创建 API key。
OpenClaw 自动记忆维护:防止过期日志干扰 memorySearch 结果
在 HEARTBEAT.md 里加上每周自动维护任务:
- 读最近 7 天的 日志
- 提炼有价值的信息到对应文件(projects.md / lessons.md)
- 压缩已完成一次性任务的日志为一行结论
- 删除过期信息
- 更新 的 为今天
创建 memory/heartbeat-state.json:
GPT plus 代充 只需 145
OpenClaw 子 Agent 是什么?解决什么问题?
默认情况下 AI 是"单线程"的,做完一件才做下一件。子 Agent 让主 AI(主脑)可以派出独立的 AI 子进程并行处理任务,每个子 Agent 有自己的 session,执行完自动汇报结果。
OpenClaw 子 Agent 配置方法(openclaw.json + AGENTS.md)
第一步:在 AGENTS.md 里声明使用规范
如果任务比较复杂或耗时较长,可以派子 agent 去执行。
模型选择策略
第二步:在 openclaw.json 里配置模型别名
OpenClaw 子 Agent 模型分级能省多少钱?
实测:token 消耗能降 60-70%。大部分日常操作(搜索、汇总、文件操作)根本不需要最强模型。Haiku 比 Opus 便宜 10 倍以上,搜个网页、改个文件名做得一样好。
OpenClaw 子 Agent task 描述写法
子 Agent 是"零上下文"的,只能看到主脑给它的 task 描述,所以描述质量决定输出质量。
❌ 烂的 task 描述:帮我审查一下代码
✅ 好的 task 描述(包含目标、路径、约束、输出格式):
目标
审查 /root/project/src/ 目录下的所有 .js 文件,重点检查 API 安全问题。
关注点
- SQL 注入风险
- 未验证的用户输入
- 硬编码的密钥或 token
- 缺少权限检查的 API 端点
约束
- 只读不写,不要修改任何文件
- 忽略 node_modules/ 和 test/ 目录
输出格式
按严重程度分级(🔴致命 / 🟡重要 / 🟢建议),每个问题给出:文件路径、行号、问题描述、修复建议。
结果
写入 /root/project/SECURITY-REVIEW.md
OpenClaw 子 Agent 并发限制
经验值:同时最多跑 2 个子 Agent,4 个基本触发 API 429 限流。有依赖关系的任务(B 依赖 A 的输出)必须串行,在 AGENTS.md 里提醒主脑注意任务依赖即可。
OpenClaw Heartbeat 和 Cron 的区别(什么时候用哪个)
选 Heartbeat:顺便检查的轻量任务、需要最近聊天上下文。
选 Cron:需要精确时间、不干扰主对话、想省钱指定便宜模型、一次性提醒。
OpenClaw Cron 三种调度类型详解
- 一次性定时(执行完自动删除):
GPT plus 代充 只需 145
- 固定间隔循环:
常用换算:5 分钟 = 、30 分钟 = 、1 小时 =
- 表达式(最灵活,格式:分 时 日 月 星期):
GPT plus 代充 只需 145
常用 cron 表达式速查:
最常见踩坑:一定要设 tz 字段! 不设默认 UTC,"早上 9 点"会变成北京时间下午 5 点。
OpenClaw Cron 两种执行模式
(往主 session 注入消息,适合提醒):
GPT plus 代充 只需 145
(开独立 session 执行任务,适合操作类):
sessionTarget: “main” 只能搭配 systemEvent;sessionTarget: “isolated” 只能搭配 agentTurn。搞混会报错。
OpenClaw Cron 实用场景配置(完整 JSON,可直接复制)
场景 1:每天早上自动发科技新闻摘要
GPT plus 代充 只需 145
场景 2:每小时服务器状态巡检,挂了才通知
场景 3:每周一自动生成项目周报
GPT plus 代充 只需 145
OpenClaw Cron 任务管理命令
GPT plus 代充 只需 145
OpenClaw Skill 是什么?和插件有什么区别?
Skill 就是一个 Markdown 文件,里面用自然语言描述"遇到什么情况,按什么步骤执行"。AI 读了这个文件就"学会"了一个新技能。不需要编程,任何人都能写。
OpenClaw Skill 文件结构和加载优先级
每个 skill 是一个目录,必须包含 :
GPT plus 代充 只需 145
OpenClaw SKILL.md 写法:description 字段决定触发率
SKILL.md 由 YAML frontmatter 和正文两部分组成:
注:description 直接决定触发率。不要写"天气相关"这种模糊描述,要列出所有可能的触发词——越具体越好。
正文建议包含:执行步骤、输出格式模板、错误处理。
第一步:创建目录
GPT plus 代充 只需 145
第二步:写
第三步:测试 跟 AI 说"帮我查一下 8.8.8.8 是哪里的"——不触发就在 description 里补充更多触发词。
OpenClaw 带脚本的 Skill(调用 yt-dlp 等命令行工具)
GPT plus 代充 只需 145
SKILL.md 里引用脚本(用相对于 workspace 的路径):
OpenClaw Skill 开发**实践
- 先手动跑通再写 Skill:先和 AI 手动执行一遍,确认可行再整理成 Skill。
- 步骤要具体: ❌ → ,解析 JSON 的 results 字段 ✅
- 错误处理必须写:不写 AI 遇到异常会瞎猜。
- 多种说法都要测试:description 要覆盖用户各种可能的表达方式,中英文都写。
- 用 ClawHub 省时间: 直接安装社区现成 Skill。
OpenClaw 支持哪些聊天渠道?
Discord 功能最全,支持服务器+私聊、emoji reaction、markdown 表格
Telegram 轻量快速,支持内联按钮、语音消息、文件传输
WhatsApp 用户基数大,但格式支持有限
Signal 端到端加密,隐私最强
Slack 适合团队场景
WebChat 内置网页聊天,零配置
Matrix 去中心化,自托管
可以同时接入多个渠道。消息路由自动处理——Discord 来的消息回到 Discord,不会串。
OpenClaw Telegram Bot 接入配置教程
第一步:Telegram 搜索 → → 按提示操作 → 复制
第二步:Telegram 搜索 @userinfobot → 发任意消息 → 获取你的用户 ID
第三步:配置 openclaw.json:
GPT plus 代充 只需 145
OpenClaw Discord + Telegram 同时在线配置
在 AGENTS.md 里加上格式适配规则(AI 会根据消息来源自动适配):
GPT plus 代充 只需 145
所有配置写在 ,修改后 生效
blockStreaming — 解决 AI 长回复要等很久的问题
ackReaction — 发消息后立刻知道 AI 收到了
GPT plus 代充 只需 145
compaction — 解决 AI 长对话失忆问题
相关命令: 重点保留技术决策、(开新 session)、(查 token 用量)
openclaw.json 其他常用配置汇总
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/234751.html