如果你在搜索以下问题，这篇文章就是你要找的：
- 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 是什么。
先看一眼调教前后的效果对比：
很多人在搜”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 都会自动加载它。
AI 每次新 session 都是”失忆”状态，需要明确告诉它醒来后按什么顺序读文件来恢复记忆：
逐行解释：
第 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 类型。
光会读记忆不够，还得教它怎么写记忆。未规范的 AI 要么全堆到 MEMORY.md 里（变成流水账），要么根本不写（下次就忘了）。
在 AGENTS.md 里加上写入规范：
记结论不记过程是核心原则。好日志 vs 烂日志对比：
❌ 烂日志（浪费 token，检索精度差）：
✅ 好日志（精简，memorySearch 高命中率）：
在 AGENTS.md 里加上：
💡 这个模板是精简版起点。随着使用越来越深入，你会不断往里加规则。我的 AGENTS.md 现在已经有 200 多行了，但都是一点点积累的。
这是搜索量很高的一个问题。原因是 OpenClaw 的上下文压缩（compaction）触发了。
每个模型都有上下文窗口限制（Claude 是 200K token）。当对话接近这个限制时，OpenClaw 会自动把旧对话压缩成摘要腾出空间——压缩过程中可能丢失细节。
解决方案：开启 ，在压缩触发之前，先让 AI 把重要信息写入文件。
在 里加上：
参数说明：
💡 memoryFlush 静默执行，不打断对话。开了 verbose 模式（）可以看到 的提示。
memorySearch 的底层是向量语义检索，结构化日志的命中率比非结构化日志高得多：
搜索词：”nginx 部署问题”
❌ 非结构化日志（命中率低）：
✅ 结构化日志（命中率高）：
国内用户最快上手的方案——SiliconFlow 提供的 bge-m3 向量模型完全免费：
为什么推荐 bge-m3？ 完全免费、中英文双语支持好、向量维度 1024 精度和性能平衡好。
获取方式：去 siliconflow.cn 注册 → 控制台 → 创建 API key。
在 HEARTBEAT.md 里加上每周自动维护任务：
创建 ：
默认情况下 AI 是”单线程”的，做完一件才做下一件。子 Agent 让主 AI（主脑）可以派出独立的 AI 子进程并行处理任务，每个子 Agent 有自己的 session，执行完自动汇报结果。
第一步：在 AGENTS.md 里声明使用规范
第二步：在 openclaw.json 里配置模型别名
实测：token 消耗能降 60-70%。大部分日常操作（搜索、汇总、文件操作）根本不需要最强模型。Haiku 比 Opus 便宜 10 倍以上，搜个网页、改个文件名做得一样好。
子 Agent 是”零上下文”的，只能看到主脑给它的 task 描述，所以描述质量决定输出质量。
❌ 烂的 task 描述：
✅ 好的 task 描述（包含目标、路径、约束、输出格式）：
经验值：同时最多跑 2 个子 Agent，4 个基本触发 API 429 限流。有依赖关系的任务（B 依赖 A 的输出）必须串行，在 AGENTS.md 里提醒主脑注意任务依赖即可。
选 Heartbeat：顺便检查的轻量任务、需要最近聊天上下文。
选 Cron：需要精确时间、不干扰主对话、想省钱指定便宜模型、一次性提醒。
— 一次性定时（执行完自动删除）：
— 固定间隔循环：
常用换算：5 分钟 = 、30 分钟 = 、1 小时 =
— cron 表达式（最灵活，格式：）：
常用 cron 表达式速查：
⚠️ 最常见踩坑：一定要设 字段！ 不设默认 UTC，”早上 9 点”会变成北京时间下午 5 点。
systemEvent（往主 session 注入消息，适合提醒）：
agentTurn（开独立 session 执行任务，适合操作类）：
💡 只能搭配 ； 只能搭配 。搞混会报错。
场景 1：每天早上自动发科技新闻摘要
场景 2：每小时服务器状态巡检，挂了才通知
场景 3：每周一自动生成项目周报
场景 4：N 分钟后提醒我（一次性）
直接跟 AI 说”帮我设一个 20 分钟后的提醒”，AI 会自动创建任务。手动配置示例：
Skill 就是一个 Markdown 文件，里面用自然语言描述”遇到什么情况，按什么步骤执行”。AI 读了这个文件就”学会”了一个新技能。不需要编程，任何人都能写。
每个 skill 是一个目录，必须包含 ：
SKILL.md 由 YAML frontmatter 和正文两部分组成：
⚠️ description 直接决定触发率。不要写”天气相关”这种模糊描述，要列出所有可能的触发词——越具体越好。
正文建议包含：执行步骤、输出格式模板、错误处理。
第一步：创建目录
第二步：写 SKILL.md
第三步：测试 跟 AI 说”帮我查一下 8.8.8.8 是哪里的”——不触发就在 description 里补充更多触发词。
SKILL.md 里引用脚本（用相对于 workspace 的路径）：
- 先手动跑通再写 Skill：先和 AI 手动执行一遍，确认可行再整理成 Skill。
- 步骤要具体： ❌ → ✅
- 错误处理必须写：不写 AI 遇到异常会瞎猜。
- 多种说法都要测试：description 要覆盖用户各种可能的表达方式，中英文都写。
- 用 ClawHub 省时间： 直接安装社区现成 Skill。
可以同时接入多个渠道。消息路由自动处理——Discord 来的消息回到 Discord，不会串。
第一步：创建 Discord Bot
- 打开 Discord Developer Portal
- “New Application” → 起名 → Create
- 左侧 “Bot” → “Reset Token” → 复制 Token（⚠️ 只显示一次！）
第二步：开启 Privileged Gateway Intents
90% 新手踩坑的地方——MESSAGE CONTENT INTENT 不开，Bot 就收不到消息内容。
在 Bot 页面往下滚到 “Privileged Gateway Intents”，开启：
- ✅ PRESENCE INTENT
- ✅ SERVER MEMBERS INTENT
- ✅ MESSAGE CONTENT INTENT ← 最重要
点 Save Changes。
第三步：邀请 Bot 到你的服务器
- 左侧 “OAuth2” → “OAuth2 URL Generator”
- Scopes 勾选：；Bot Permissions 勾选：、、、
- 复制 URL → 浏览器打开 → 选服务器 → 授权
第四步：获取服务器 ID
Discord 客户端：设置 → 高级 → 开启 “开发者模式” → 右键服务器名称 → “复制服务器 ID”
第五步：配置 openclaw.json
支持：（整个服务器）、（特定用户）、（特定频道）
：AI 收到消息后立刻加的 emoji，表示”收到了，正在处理”，建议用不常见的 emoji 容易辨认。
第六步：重启测试
常见问题排查：
第一步：Telegram 搜索 @BotFather → → 按提示操作 → 复制 Token
第二步：Telegram 搜索 @userinfobot → 发任意消息 → 获取你的用户 ID
第三步：配置 openclaw.json：
在 AGENTS.md 里加上格式适配规则（AI 会根据消息来源自动适配）：
所有配置写在 ，修改后 生效。
（详见第二章，快速配置）
相关命令：、（开新 session）、（查 token 用量）
按优先级排序，前 openclaw skills 教程 5 项不到 1 小时，就能感受到明显提升：
- [ ] AGENTS.md：session 启动流程 + 记忆规范 + 安全边界（30 分钟）
- [ ] memoryFlush：开启压缩前自动保存，解决 AI 失忆（5 分钟）
- [ ] ackReaction：配置收到消息确认 emoji（1 分钟）
- [ ] blockStreaming：开启流式回复（5 分钟）
- [ ] Heartbeat 调优：设置 activeHours 防止半夜打扰（5 分钟）
- [ ] memorySearch（bge-m3）：配置 SiliconFlow 免费 embedding API（10 分钟）
- [ ] 记忆维护：HEARTBEAT.md 里加每周自动维护任务（10 分钟）
- [ ] 模型分级：配置 alias + 分配策略，省 60-70% token（15 分钟）
- [ ] Cron 任务：设置每日早报/服务巡检（15 分钟）
- [ ] Skill 开发：写第一个自定义 skill 练手（30 分钟）
- [ ] 多渠道接入：接入 Discord 或 Telegram（30 分钟）
Q：OpenClaw AGENTS.md 放在哪里？
A：workspace 根目录，和 SOUL.md、USER.md 同级。路径通常是 。
Q：OpenClaw memoryFlush 开了还是失忆怎么办？
A：检查 是否设够大（推荐 4000）。对话特别关键时，手动 指定保留内容。
Q：OpenClaw Cron 任务设了但没触发？
A：99% 是时区问题——没设 字段导致按 UTC 执行。另外检查 是否设为 ，不设任务静默执行，你不会收到通知。
Q：OpenClaw Skill 写好了但 AI 不触发？
A：检查 是否包含了你实际的触发词。中英文触发词都要写，比如”查 IP”和”IP lookup”都加上。
Q：OpenClaw Discord Bot 在线但收不到消息？
A：几乎肯定是 MESSAGE CONTENT INTENT 没开。回到 Discord Developer Portal → Bot → Privileged Gateway Intents → 开启 MESSAGE CONTENT INTENT → Save Changes。
Q：OpenClaw 多渠道同时开，消息会串吗？
A：不会。OpenClaw 记录每条消息的来源渠道，Discord 来的在 Discord 回，Telegram 来的在 Telegram 回。
Q：OpenClaw 子 Agent 怎么省钱？
A：在 AGENTS.md 里明确模型分级策略：搜索汇总用 Haiku，写代码用 Sonnet，复杂推理才用 Opus。大部分任务都是 Haiku 级别，实测 token 消耗降 60-70%。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/251908.html原文链接：https://javaforall.net
