文章目录


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

  • 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 配置 — 给 AI 写一部行为宪法

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 都是"失忆"状态,需要明确告诉它醒来后按什么顺序读文件来恢复记忆:

Every Session

Before doing anything else:

  1. Read SOUL.md — this is who you are
  2. Read USER.md — this is who you’re helping
  3. Read memory/YYYY-MM-DD.md (today + yesterday) for recent context
  4. If in MAIN SESSION (direct chat with your human): Also read MEMORY.md

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 里加上写入规范:

Memory

You wake up fresh each session. These files are your continuity.

记忆分层

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

写入规则

  • 日志写入 memory/YYYY-MM-DD.md,格式见下方
  • 项目状态:项目有进展时同步更新 memory/projects.md
  • 教训:踩坑后写入 memory/lessons.md
  • MEMORY.md:只在索引变化时更新,保持精简

日志格式

[PROJECT:名称] 标题

  • 结论: 一句话总结
  • 文件变更: 涉及的文件
  • 教训: 踩坑点(如有)
  • 标签: #tag1 #tag2

铁律

  • 记结论不记过程
  • 标签便于 memorySearch 检索
  • “Mental notes” don’t survive session restarts. Files do.

记结论不记过程是核心原则。好日志 vs 烂日志对比:

❌ 烂日志(浪费 token,检索精度差):

部署

今天部署了项目。先试了直接跑,报错了。然后查了半天,发现是端口被占了……(三页流水账)

✅ 好日志(精简,memorySearch 高命中率):

[PROJECT:MyApp] 部署完成

  • 结论: 用 nginx 反代部署成功,监听 80 端口
  • 文件变更: /etc/nginx/sites-available/myapp
  • 教训: 直接暴露端口不可行,必须走 nginx 反代
  • 标签: #myapp #deploy #nginx

OpenClaw 安全边界配置:AI 能自己做什么,什么要先问你

在 AGENTS.md 里加上:

Safety

  • Don’t exfiltrate private data. Ever.
  • Don’t run destructive commands without asking.
  • trash > rm (recoverable beats gone forever)
  • When in doubt, ask.

External vs Internal

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

Group Chats

You have access to your human’s stuff. That doesn’t mean you share it.
In groups, you’re a participant — not their voice, not their proxy.

完整 AGENTS.md 模板(可直接复制粘贴)

AGENTS.md - Your Workspace

This folder is home. Treat it that way.

Every Session

Before doing anything else:

  1. Read SOUL.md — this is who you are
  2. Read USER.md — this is who you’re helping
  3. Read memory/YYYY-MM-DD.md (today + yesterday) for recent context
  4. If in MAIN SESSION: Also read MEMORY.md

Don’t ask permission. Just do it.

Memory

You wake up fresh each session. These files are your continuity:

层级 文件 用途
索引层 MEMORY.md 核心信息和记忆索引,保持精简
项目层 memory/projects.md 各项目当前状态与待办
教训层 memory/lessons.md 踩过的坑,按严重程度分级
日志层 memory/YYYY-MM-DD.md 每日记录

写入规则

  • 日志写入 memory/YYYY-MM-DD.md,记结论不记过程
  • 项目有进展时同步更新 memory/projects.md
  • 踩坑后写入 memory/lessons.md
  • MEMORY.md 只在索引变化时更新
  • 想记住就写文件,不要靠"记在脑子里"

日志格式

[PROJECT:名称] 标题

  • 结论: 一句话总结
  • 文件变更: 涉及的文件
  • 教训: 踩坑点(如有)
  • 标签: #tag1 #tag2

Safety

  • Don’t exfiltrate private data. Ever.
  • Don’t run destructive commands without asking.
  • trash > rm
  • 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

Group Chats

You have access to your human’s stuff. That doesn’t mean you share it.
In groups, you’re a participant — not their voice, not their proxy.

Tools

Skills provide your tools. When you need one, check its SKILL.md.

💡 这个模板是精简版起点。随着使用越来越深入,你会不断往里加规则。我的 AGENTS.md 现在已经有 200 多行了,但都是一点点积累的。

二、OpenClaw 记忆系统实战 — 用 memoryFlush 解决 AI 失忆问题

为什么 OpenClaw 聊着聊着 AI 会"失忆"?

这是搜索量很高的一个问题。原因是 OpenClaw 的**上下文压缩(compaction)**触发了。

每个模型都有上下文窗口限制(Claude 是 200K token)。当对话接近这个限制时,OpenClaw 会自动把旧对话压缩成摘要腾出空间——压缩过程中可能丢失细节。

OpenClaw memoryFlush 配置方法:压缩前自动保存关键信息

解决方案:开启 memoryFlush,在压缩触发之前,先让 AI 把重要信息写入文件。

在 openclaw.json 里加上:

{
  "agents": {
    "defaults": {
      "compaction": {
        "reserveTokensFloor": 20000,
        "memoryFlush": {
          "enabled": true,
          "softThresholdTokens": 4000
        }
      }
    }
  }
}

参数说明:

参数 含义 推荐值
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 向量模型完全免费:

{
  "memorySearch": {
    "enabled": true,
    "provider": "openai",
    "remote": {
      "baseUrl": "https://api.siliconflow.cn/v1",
      "apiKey": "你的 SiliconFlow API key"
    },
    "model": "BAAI/bge-m3"
  }
}

为什么推荐 bge-m3? 完全免费、中英文双语支持好、向量维度 1024 精度和性能平衡好。

获取方式:去 siliconflow.cn 注册 → 控制台 → 创建 API key。

OpenClaw 自动记忆维护:防止过期日志干扰 memorySearch 结果

在 HEARTBEAT.md 里加上每周自动维护任务:

记忆维护(每周一次)

读取 memory/heartbeat-state.json,检查 lastMemoryMaintenance 字段。
如果距今 >= 7 天:

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

创建 memory/heartbeat-state.json:

{
  "lastMemoryMaintenance": "2026-01-01"
}

三、OpenClaw 子 Agent 使用教程 — 让 AI 并行处理复杂任务

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

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

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

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

子 Agent

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

模型选择策略

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

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

{
  "models": {
    "your-provider/claude-opus-4": { "alias": "opus" },
    "your-provider/claude-sonnet-4": { "alias": "sonnet" },
    "your-provider/claude-haiku-4": { "alias": "haiku" }
  }
}

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 Cron 定时任务配置教程 — 每天自动发新闻/周报/服务巡检

OpenClaw Heartbeat 和 Cron 的区别(什么时候用哪个)

维度 Heartbeat Cron
精度 大约每 30 分钟(会有偏差) 精确到分钟(cron 表达式)
执行环境 在主 session 里执行 可以开独立 session
模型 用主脑的模型 可以指定不同模型
适合 批量轻量检查 精确定时、独立任务

选 Heartbeat:顺便检查的轻量任务、需要最近聊天上下文。

选 Cron:需要精确时间、不干扰主对话、想省钱指定便宜模型、一次性提醒。

OpenClaw Cron 三种调度类型详解

  • at 一次性定时(执行完自动删除):
"schedule": { "kind": "at", "at": "2026-02-23T16:00:00+08:00" }
  • every 固定间隔循环:
"schedule": { "kind": "every", "everyMs": 3600000 }

常用换算:5 分钟 = 300000、30 分钟 = 1800000、1 小时 = 3600000

  • cron 表达式(最灵活,格式:分 时 日 月 星期):
"schedule": { "kind": "cron", "expr": "0 9 * * 1", "tz": "Asia/Shanghai" }

常用 cron 表达式速查:

0 9 * * *     每天早上 9 点
0 9 * * 1     每周一早上 9 点
0 9,18 * * *  每天 9 点和 18 点
*/30 * * * *  每 30 分钟
0 0 1 * *     每月 1 号零点

最常见踩坑:一定要设 tz 字段! 不设默认 UTC,"早上 9 点"会变成北京时间下午 5 点。

OpenClaw Cron 两种执行模式

systemEvent(往主 session 注入消息,适合提醒):

{
  "payload": { "kind": "systemEvent", "text": "提醒:10 分钟后有会议" },
  "sessionTarget": "main"
}

agentTurn(开独立 session 执行任务,适合操作类):

{
  "payload": { "kind": "agentTurn", "message": "...", "model": "haiku" },
  "sessionTarget": "isolated",
  "delivery": { "mode": "announce" }
}

sessionTarget: “main” 只能搭配 systemEvent;sessionTarget: “isolated” 只能搭配 agentTurn。搞混会报错。

OpenClaw Cron 实用场景配置(完整 JSON,可直接复制)

场景 1:每天早上自动发科技新闻摘要

{
  "name": "每日早报",
  "schedule": { "kind": "cron", "expr": "0 9 * * *", "tz": "Asia/Shanghai" },
  "payload": { 
    "kind": "agentTurn", 
    "message": "搜索今天的科技和 AI 领域新闻热点,整理成 5 条简报。每条包含:标题、一句话摘要、来源链接。",
    "model": "haiku"
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "announce" }
}

场景 2:每小时服务器状态巡检,挂了才通知

{
  "name": "服务巡检",
  "schedule": { "kind": "every", "everyMs": 3600000 },
  "payload": { 
    "kind": "agentTurn", 
    "message": "用 curl 检查以下服务是否在线:\n1. http://localhost:8080\n2. http://localhost:3000\n\n如果全部正常,不要通知我。只有挂了才通知,说明哪个挂了、返回了什么错误码。",
    "model": "haiku"
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "announce" }
}

场景 3:每周一自动生成项目周报

{
  "name": "项目周报",
  "schedule": { "kind": "cron", "expr": "0 10 * * 1", "tz": "Asia/Shanghai" },
  "payload": { 
    "kind": "agentTurn", 
    "message": "读取 memory/ 目录下最近 7 天的日志文件,整理成一份周报。包含:本周完成的事项、进行中的项目、遇到的问题、下周计划。格式简洁,用 bullet points。",
    "model": "sonnet"
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "announce" }
}

场景 4:N 分钟后提醒我(一次性)
直接跟 AI 说"帮我设一个 20 分钟后的提醒",AI 会自动创建任务。手动配置示例:

{
  "name": "喝水提醒",
  "schedule": { "kind": "at", "at": "2026-02-23T04:20:00Z" },
  "payload": { "kind": "systemEvent", "text": "⏰ 提醒:该喝水了!" },
  "sessionTarget": "main"
}

OpenClaw Cron 任务管理命令

openclaw cron list                     # 查看所有任务
openclaw cron runs --id <任务ID>       # 查看执行历史
openclaw cron edit <任务ID> --disable  # 禁用(推荐,而不是删除)

五、OpenClaw Skill 开发入门 — 手把手写自定义 AI 技能

OpenClaw Skill 是什么?和插件有什么区别?

Skill 就是一个 Markdown 文件,里面用自然语言描述"遇到什么情况,按什么步骤执行"。AI 读了这个文件就"学会"了一个新技能。不需要编程,任何人都能写。

OpenClaw Skill 文件结构和加载优先级

<workspace>/skills/     ← 你自己写的(最高优先级)
~/.openclaw/skills/     ← 全局安装的
内置 skill              ← OpenClaw 自带的(最低)

每个 skill 是一个目录,必须包含 SKILL.md

skills/
  my-skill/
    SKILL.md
    scripts/    ← 可选,需要跑脚本时用

OpenClaw SKILL.md 写法:description 字段决定触发率

SKILL.md 由 YAML frontmatter 和正文两部分组成:

---
name: weather
description: >
  获取天气信息。触发条件:用户问天气、气温、是否下雨、
  穿什么衣服、需不需要带伞、今天出行等问题时触发。
---

:description 直接决定触发率。不要写"天气相关"这种模糊描述,要列出所有可能的触发词——越具体越好。
正文建议包含:执行步骤、输出格式模板、错误处理。

手把手:从零写一个 OpenClaw IP 查询 Skill

第一步:创建目录
mkdir -p ~/.openclaw/workspace/skills/ip-lookup
第二步:写 SKILL.md
---
name: ip-lookup
description: >
  IP 地址查询。触发条件:用户要求查询 IP 地址、IP 归属地、
  IP 定位、"这个 IP 是哪里的"、"帮我查一下 XX.XX.XX.XX"等。
---

# IP 地址查询

## 步骤

1. 从用户消息中提取 IP 地址
2. 调用 web_fetch 访问:`http://ip-api.com/json/{IP地址}?lang=zh-CN`
3. 解析返回的 JSON 数据
4. 按以下格式回复用户:

## 输出格式

🌐 IP 查询结果:{IP}
📍 位置:{country} {regionName} {city}
🏢 ISP:{isp}
⏰ 时区:{timezone}

## 错误处理

- API 返回 `"status": "fail"` → 告诉用户"可能是内网 IP 或无效地址"
- 网络超时 → 告诉用户"请求超时,请稍后重试"
第三步:测试 跟 AI 说"帮我查一下 8.8.8.8 是哪里的"——不触发就在 description 里补充更多触发词。

OpenClaw 带脚本的 Skill(调用 yt-dlp 等命令行工具)

skills/video-downloader/
  SKILL.md
  scripts/
    download.sh

SKILL.md 里引用脚本(用相对于 workspace 的路径):

## 步骤
1. 从用户消息中提取视频 URL
2. 执行:`bash skills/video-downloader/scripts/download.sh "视频URL"`
3. 告诉用户文件保存位置

OpenClaw Skill 开发最佳实践

  1. 先手动跑通再写 Skill:先和 AI 手动执行一遍,确认可行再整理成 Skill。
  2. 步骤要具体:调用 API 获取数据 ❌ → 调用 web_fetch 访问 https://...,解析 JSON 的 results 字段 ✅
  3. 错误处理必须写:不写 AI 遇到异常会瞎猜。
  4. 多种说法都要测试:description 要覆盖用户各种可能的表达方式,中英文都写。
  5. 用 ClawHub 省时间:clawhub install <skill-slug> 直接安装社区现成 Skill。

六、OpenClaw 多渠道接入教程 — Discord 和 Telegram 同时在线

OpenClaw 支持哪些聊天渠道?

Discord 功能最全,支持服务器+私聊、emoji reaction、markdown 表格
Telegram 轻量快速,支持内联按钮、语音消息、文件传输
WhatsApp 用户基数大,但格式支持有限
Signal 端到端加密,隐私最强
Slack 适合团队场景
WebChat 内置网页聊天,零配置
Matrix 去中心化,自托管

可以同时接入多个渠道。消息路由自动处理——Discord 来的消息回到 Discord,不会串。

OpenClaw Telegram Bot 接入配置教程

第一步:Telegram 搜索 @BotFather/newbot → 按提示操作 → 复制 Token
第二步:Telegram 搜索 @userinfobot → 发任意消息 → 获取你的用户 ID
第三步:配置 openclaw.json:

{
  "channels": {
    "telegram": {
      "token": "你的 Telegram Bot Token",
      "allowFrom": ["你的用户ID"]
    }
  }
}

OpenClaw Discord + Telegram 同时在线配置

{
  "channels": {
    "discord": {
      "token": "Discord Token",
      "allowFrom": ["server:123456789"],
      "ackReaction": "🫐"
    },
    "telegram": {
      "token": "Telegram Token",
      "allowFrom": ["你的用户ID"]
    }
  }
}

在 AGENTS.md 里加上格式适配规则(AI 会根据消息来源自动适配):

## 平台格式

- **Discord/Telegram**: 可以用 markdown,代码块用 ```包裹
- **WhatsApp**: 不支持表格,用 bullet list 代替
- **Discord**: 多链接用 <> 包裹防止预览刷屏

七、openclaw.json 配置速查表 — 每个参数调到最优

所有配置写在 ~/.openclaw/openclaw.json,修改后 openclaw gateway restart 生效

blockStreaming — 解决 AI 长回复要等很久的问题
{
  "agents": {
    "defaults": {
      "blockStreamingDefault": "on",
      "blockStreamingBreak": "text_end",
      "blockStreamingChunk": { "minChars": 200, "maxChars": 1500 }
    }
  }
}
ackReaction — 发消息后立刻知道 AI 收到了
{
  "channels": {
    "discord": { "ackReaction": "🫐" },
    "telegram": { "ackReaction": "👀" }
  }
}
compaction — 解决 AI 长对话失忆问题
{
  "agents": {
    "defaults": {
      "compaction": {
        "reserveTokensFloor": 20000,
        "memoryFlush": { "enabled": true, "softThresholdTokens": 4000 }
      }
    }
  }
}

相关命令:/compact 重点保留技术决策、/new(开新 session)、/status(查 token 用量)

openclaw.json 其他常用配置汇总

OpenClaw 配置说明

配置路径 作用 推荐值
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
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐