OpenClaw 进阶配置：openclaw.json — 常用项速查

大部分 OpenClaw 行为在 ~/.openclaw/openclaw.json 中配置；修改后执行 openclaw gateway restart 生效。本文按功能块列出常用片段，便于复制与对照。

blockStreaming（长回复分块流式输出）

{
  "agents": {
    "defaults": {
      "blockStreamingDefault": "on",
      "blockStreamingBreak": "text_end",
      "blockStreamingChunk": { "minChars": 200, "maxChars": 1500 }
    }
  }
}

参数	含义	推荐值
blockStreamingDefault	全局开关	“on”
blockStreamingBreak	什么时候发一个块	“text_end”
blockStreamingChunk.minChars	一个块最少字符数	200
blockStreamingChunk.maxChars	一个块最多字符数	1500

ackReaction（频道已读回执）

{
  "channels": {
    "discord": { "ackReaction": "🫐" },
    "telegram": { "ackReaction": "👀" }
  }
}

compaction（上下文压缩与 memoryFlush）

参考进阶配置《记忆系统》篇。

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

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

heartbeat（心跳与非活跃时段）

{
  "agents": {
    "defaults": {
      "heartbeat": {
        "every": "30m",
        "target": "last",
        "activeHours": { "start": "08:00", "end": "23:00" }
      }
    }
  }
}

其他常用项汇总

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