在前面的文章中，我们已经讲清楚了：
- 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"
}
用于指定使用哪个模型。
常见：
👉 这个配置决定了：
能力上限 + 成功率
2 temperature（随机性）
{
"temperature": 0.2
}
控制输出的”稳定性”。
建议：
- 写代码 / 修改代码：0.1 ~ 0.3
- 生成内容：0.5 左右
四、执行控制相关
3 maxSteps（最大执行步数）
{
"maxSteps": 20
}
表示一个任务最多执行多少步。
如果设置太小：
👉 任务可能中途停止
如果太大：
👉 成本高、可能跑偏
建议：
4 timeout（超时时间）
有些版本支持：
{
"timeout": 300
}
单位通常是秒。
防止任务无限执行。
五、权限控制（非常重要）
这是很多人忽略的一块。
5 allowFileWrite（是否允许写文件）
{
"allowFileWrite": true
}
- true：可以修改代码
- false：只能分析，不修改
👉 如果你只是想”看看分析结果”，建议先关掉。
6 allowCommandExec（是否允许执行命令）
{
"allowCommandExec": true
}
在前面的文章中，我们已经讲清楚了：
- 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"
}
用于指定使用哪个模型。
常见：
👉 这个配置决定了：
能力上限 + 成功率
2 temperature（随机性）
{
"temperature": 0.2
}
控制输出的”稳定性”。
建议：
- 写代码 / 修改代码：0.1 ~ 0.3
- 生成内容：0.5 左右
四、执行控制相关
3 maxSteps（最大执行步数）
{
"maxSteps": 20
}
表示一个任务最多执行多少步。
如果设置太小：
👉 任务可能中途停止
如果太大：
👉 成本高、可能跑偏
建议：
4 timeout（超时时间）
有些版本支持：
{
"timeout": 300
}
单位通常是秒。
防止任务无限执行。
五、权限控制（非常重要）
这是很多人忽略的一块。
5 allowFileWrite（是否允许写文件）
{
"allowFileWrite": true
}
- true：可以修改代码
- false：只能分析，不修改
👉 如果你只是想”看看分析结果”，建议先关掉。
6 allowCommandExec（是否允许执行命令）
{
"allowCommandExec": true
}
允许执行：
- npm install
- 测试命令
- shell 操作
👉 有一定风险，建议在可控环境使用。
六、任务行为控制
7 retry（重试次数）
{
"retry": 2
}
当执行失败时，是否自动重试。
适用于：
8 verbose（详细日志）
{
"verbose": true
}
开启后可以看到：
👉 调试时非常有用。
七、工具相关配置（进阶）
一些版本会支持 tool 控制，例如：
{
"tools": {
"file": true,
"shell": true
}
}
用于控制：
👉 本质是对 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，才算真正”掌控工具”。
