2026年OpenClaw 进阶配置完全教程(2026):AGENTS.md、Agent 配置、记忆系统、Cron 定时任务、Skill开发、多渠道接入

OpenClaw 进阶配置完全教程(2026):AGENTS.md、Agent 配置、记忆系统、Cron 定时任务、Skill开发、多渠道接入svg xmlns http www w3 org 2000 svg style display none svg

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



    


如果你在搜索以下问题,这篇文章就是你要找的:

  • 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 是什么。

先看一眼调教前后的效果对比:

维度 基础水平 本篇调教后 行为规范 SOUL.md 写了几行 完整行为宪法,知道什么该做什么不该做 记忆 有分层结构 自动维护、自动压缩、语义检索秒回 任务能力 主脑单线程干活 一个人变一支团队,并行派活 自动化 心跳能巡检 精确定时任务,早报晚报自动发 扩展性 装了几个 skill 自己能写 skill,想要什么能力就加什么 渠道 接了一个平台 多平台同时在线,消息路由自如 配置 能跑就行 每个参数都调到最优

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:

  1. Read — this is who you are
  2. Read — this is who you’re helping
  3. Read (today + yesterday) for recent context
  4. 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 类型:

Session 类型 说明 主 session 你直接跟 AI 聊天的对话(Discord 私聊、WebChat) 群聊 session Discord 服务器里的群聊 子 agent session AI 派出去执行任务的子进程 cron 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.

记忆分层

层级 文件 用途 索引层 关于用户、能力概览、记忆索引。保持精简(<40行) 项目层 各项目当前状态与待办 基础设施层 服务器、API、部署等配置速查 教训层 踩过的坑,按严重程度分级 日志层 每日原始记录

写入规则

  • 日志写入 ,格式见下方
  • 项目状态:项目有进展时同步更新
  • 教训:踩坑后写入
  • 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:

  1. Read — this is who you are
  2. Read — this is who you’re helping
  3. Read (today + yesterday) for recent context
  4. 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

参数说明:

参数 含义 推荐值 reserveTokensFloor 压缩后至少保留多少 token 的最近对话 20000 memoryFlush.enabled 是否开启压缩前自动保存 true memoryFlush.softThresholdTokens 距离压缩多少 token 时触发保存 4000

💡 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 里加上每周自动维护任务:

  1. 读最近 7 天的 日志
  2. 提炼有价值的信息到对应文件(projects.md / lessons.md)
  3. 压缩已完成一次性任务的日志为一行结论
  4. 删除过期信息
  5. 更新 的 为今天

创建 memory/heartbeat-state.json:

GPT plus 代充 只需 145

OpenClaw 子 Agent 是什么?解决什么问题?

默认情况下 AI 是"单线程"的,做完一件才做下一件。子 Agent 让主 AI(主脑)可以派出独立的 AI 子进程并行处理任务,每个子 Agent 有自己的 session,执行完自动汇报结果。

OpenClaw 子 Agent 配置方法(openclaw.json + AGENTS.md)

第一步:在 AGENTS.md 里声明使用规范

如果任务比较复杂或耗时较长,可以派子 agent 去执行。

模型选择策略

等级 模型别名 适用场景 🔴 高 opus 复杂架构设计、多文件重构、深度推理 🟡 中 sonnet 写代码、写脚本、信息整理(默认) 🟢 低 haiku 简单文件操作、格式转换、搜索汇总

第二步:在 openclaw.json 里配置模型别名

 
  

OpenClaw 子 Agent 模型分级能省多少钱?

实测:token 消耗能降 60-70%。大部分日常操作(搜索、汇总、文件操作)根本不需要最强模型。Haiku 比 Opus 便宜 10 倍以上,搜个网页、改个文件名做得一样好。

OpenClaw 子 Agent task 描述写法

子 Agent 是"零上下文"的,只能看到主脑给它的 task 描述,所以描述质量决定输出质量。

❌ 烂的 task 描述:帮我审查一下代码

✅ 好的 task 描述(包含目标、路径、约束、输出格式):

目标

审查 /root/project/src/ 目录下的所有 .js 文件,重点检查 API 安全问题。

关注点

  1. SQL 注入风险
  2. 未验证的用户输入
  3. 硬编码的密钥或 token
  4. 缺少权限检查的 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 精度 大约每 30 分钟(会有偏差) 精确到分钟(cron 表达式) 执行环境 在主 session 里执行 可以开独立 session 模型 用主脑的模型 可以指定不同模型 适合 批量轻量检查 精确定时、独立任务

选 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 开发**实践

  1. 先手动跑通再写 Skill:先和 AI 手动执行一遍,确认可行再整理成 Skill。
  2. 步骤要具体: ❌ → ,解析 JSON 的 results 字段 ✅
  3. 错误处理必须写:不写 AI 遇到异常会瞎猜。
  4. 多种说法都要测试:description 要覆盖用户各种可能的表达方式,中英文都写。
  5. 用 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 其他常用配置汇总

配置路径 作用 推荐值 tools.exec.enabled 是否允许执行 shell 命令 true tools.web.search.enabled 是否允许网页搜索 true tools.web.search.apiKey Brave Search API key(免费) 去 brave.com/search/api 申请 tools.media.image.enabled 是否允许 AI 识别图片 true(需模型支持 vision) agents.defaults.workspace workspace 路径 “~/.openclaw/workspace” channels.discord.maxLinesPerMessage Discord 单条最大行数 17

小讯
上一篇 2026-03-14 23:11
下一篇 2026-03-14 23:09

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/234751.html