在前面的文章中，我们已经讲清楚了：

• OpenClaw 的基本使用
• 安装过程中常见问题
• 以及目录结构

如果你只是“用一用”，这些已经够了。但如果你想进一步提升效果，就必须进入一个关键部分：

配置文件（config）。

很多人用 OpenClaw 会遇到一些问题：

• 为什么执行步骤太多？
• 为什么改代码不稳定？
• 为什么结果不符合预期？

这些问题，本质上很多都可以通过配置来优化。这一篇，我们就讲清楚：config.json 里到底能配什么，以及怎么用。

一、先理解：config 是控制 OpenClaw 行为的地方

可以把 config.json 理解成：OpenClaw 的“行为开关”。

你在这里可以控制：

• 用什么模型
• 任务执行方式
• 最大执行次数
• 是否允许修改文件
• 调用工具的策略

如果不配置，OpenClaw 会使用默认策略。但默认策略通常是：

👉 通用，但不一定适合你的场景

二、一个典型的 config.json（示例）

先看一个简化版示例：

{  "model": "gpt-4o",  "maxSteps": 20,  "temperature": 0.2,  "allowFileWrite": true,  "allowCommandExec": true}

下面我们一个一个讲这些配置项的含义。

三、模型相关配置

1 model（模型选择）

{  "model": "gpt-4o"}

用于指定使用哪个模型。常见：gpt-4o、claude-3-5-sonnet。

👉 这个配置决定了：能力上限 + 成功率

2 temperature（随机性）

{  "temperature": 0.2}

控制输出的“稳定性”。值越低越稳定，值越高越发散。建议写代码时设为 0.1 ~ 0.3。

四、执行控制相关

3 maxSteps（最大执行步数）

{  "maxSteps": 20}

表示一个任务最多执行多少步。设置太小任务可能中断，太大则成本高。建议复杂任务设为 20~50。

4 timeout（超时时间）

{  "timeout": 300}

单位通常是秒。防止任务无限执行。

五、权限控制（非常重要）

5 allowFileWrite（是否允许写文件）

{  "allowFileWrite": true}

true 表示可以修改代码。如果你只是想“看看分析结果”，建议先关掉。

6 allowCommandExec（是否允许执行命令）

{  "allowCommandExec": true}

允许执行 npm install 或 shell 操作。有一定风险，建议在可控环境使用。

六、任务行为控制：让执行更稳健

除了模型和步数，OpenClaw 还提供了一些控制“如何处理错误”和“展示多少细节”的开关。

7 retry（失败重试）

{  "retry": 2}

在执行复杂任务时，网络波动或模型的偶发性幻觉是难以避免的。设置此项后，当任务因非逻辑原因失败时，OpenClaw 会自动重试。

8 verbose（详细日志模式）

{  "verbose": true}

如果你是第一次调优配置文件，强烈建议开启此项。开启后，你将在终端看到：

• OpenClaw 是如何将你的目标拆解成子任务的；
• 它在调用每一个工具时的具体输入参数；
• 模型在思考时的“内心独白”。

七、工具相关配置（进阶玩家）

OpenClaw 的强大之处在于它能调用各种“外部插件”。你可以通过工具配置来精细化授权。

{  "tools": {    "file": true,    "shell": true  }}

例如，你只想让它在本地帮你重构逻辑，但不希望它联网乱跑，就可以把浏览器（browser）权限关掉。这本质上是在为 Agent 划定“安全边界”。

八、三个开箱即用的配置方案

方案一：安全分析模式（仅查看不修改）

适合：阅读大型项目源码、梳理业务逻辑。

{  "model": "gpt-4o",  "maxSteps": 15,  "allowFileWrite": false,  "allowCommandExec": false}

方案二：重构模式（深度介入代码）

适合：大面积修改文件、性能优化、逻辑重构。

{  "model": "gpt-4o",  "maxSteps": 30,  "temperature": 0.2,  "allowFileWrite": true}

方案三：调试模式（全权处理）

多步骤自动执行

{  "model": "gpt-4o",  "maxSteps": 40,  "allowFileWrite": true,  "allowCommandExec": true}

九、一个关键建议（非常重要）

很多人一上来就：

👉 改一堆配置

结果：

👉 效果更差

建议你：

先用默认配置 → 遇到问题 → 再针对性调整

不要一开始就“过度调优”。

十、小结

这一篇你只需要记住：

config 决定了 OpenClaw 怎么做事。

最重要的几个参数是：

• model（用哪个模型）
• maxSteps（执行多少步）
• allowFileWrite（是否改代码）
• allowCommandExec（是否执行命令）

一句话总结：

“不会调 config，你只能算在‘用工具’；会调 config，才算真正‘掌控工具’。”