1. 先搞清楚 OpenClaw 2.7.9 的 settings.json 到底管什么OpenClaw 2.7.9 是那种「装完之后不配一下就用不起来」的本地智能体项目圈内人管它叫小龙虾。它能读懂自然语言然后在你电脑上执行操作比如整理文件夹、抓网页数据、批量处理表格。但很多人卡在第一步装是装上了主界面右上角 Gateway 一直显示离线或者能启动但模型调用报错。问题九成出在settings.json这个文件上。settings.json是 OpenClaw 的核心配置文件它决定了三件事网关服务监听哪个端口、模型请求走哪条通道、以及用哪个 Key 去鉴权。新手最容易犯的错是只改了模型名字没改 base_url或者 Key 填了但格式不对结果请求发出去直接被拒。这篇就按「骨架 → 填参数 → 接 TaoToken → 验证生效」的顺序走一遍你跟着复制粘贴就能跑通。适合谁看第一次接触 OpenClaw 2.7.9、本地已经解压好但还没配通模型通道的人。不需要你会写代码但需要你能找到安装目录、会用文本编辑器打开 json 文件。2. 接入前先把 TaoToken 的 Key 和通道准备好OpenClaw 本身不绑定任何一家模型服务它通过 OpenAI 兼容格式去请求模型。所以你需要一个提供统一 API 通道的服务TaoToken 就是干这个的一个 Key 可以调多家模型base_url 统一省得你在配置文件里来回换地址。操作路径很直接打开 https://taotoken.net/api-keys 登录后创建一个 API Key。创建时注意两点一是 Key 只在创建时完整显示一次复制下来存好二是如果你只是本地测试权限给默认的就行不用开太高。拿到 Key 之后记下两个东西Key 本身形如sk-开头的一串字符以及 API 基础地址https://taotoken.net/api。这两个值马上要填进settings.json。如果你对通道概念还不熟可以先到 https://taotoken.net/doc 看一眼接入说明里面把 OpenAI 兼容格式的请求结构讲得比较清楚。注意Key 不要直接提交到 Git 仓库或者截图发群里。本地配置文件里填明文是正常的但别外传。3. 可直接复制的 settings.json 完整骨架OpenClaw 2.7.9 的配置文件一般在安装目录下的config文件夹里文件名就是settings.json。如果你解压后没找到这个文件可以在安装目录搜一下或者首次启动后它会自动生成一份默认的。用 VS Code 或 Notepad 打开把下面这段整体替换进去{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true, logLevel: info }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelName: claude-sonnet-4-20250514, maxTokens: 4096, temperature: 0.7, timeout: 60000 }, agent: { workspace: D:/OpenClaw/workspace, allowFileWrite: true, allowBrowserControl: true, maxSteps: 20 }, ui: { language: zh-CN, theme: dark } }逐项说一下关键参数。gateway.port是本地网关监听端口默认 18789如果你电脑上这个端口被占了改成 18790 也行但改完要重启程序。model.baseUrl必须填https://taotoken.net/api注意结尾不要多加/v1OpenClaw 内部会自己拼路径。model.apiKey换成你刚才复制的那个 Key。model.modelName填你想用的模型标识上面示例填的是 Claude 系列你也可以换成其他支持的模型名。agent.workspace是智能体干活的工作目录建议设成纯英文路径别带中文和空格。allowFileWrite和allowBrowserControl控制它能不能写文件和操控浏览器本地自己用可以都开true。保存文件时注意编码选 UTF-8别存成带 BOM 的格式否则解析可能报错。4. 启动并验证配置是否真的生效配置写完不算完得验证请求确实发出去了、模型确实回了。先重启 OpenClaw 主程序看右上角 Gateway 状态。如果显示「在线」说明网关起来了。然后点左侧「聊天对话」在底部输入框发一句最简单的你好请回复你的模型名称如果配置正确几秒内会返回模型的自报名称。这一步能通说明 baseUrl、apiKey、modelName 三个参数都对上了。想更直观地确认请求走的是 TaoToken 通道可以打开「运行日志」面板找类似这样的记录[model] POST https://taotoken.net/api/chat/completions [model] status200, modelclaude-sonnet-4-20250514看到status200就稳了。如果日志里出现401那是 Key 的问题出现404多半是 baseUrl 多写了路径出现timeout检查网络或者把timeout调大。再做一个实际动作验证在对话框输入「在 workspace 目录下新建一个 test.txt写入 hello」然后去D:/OpenClaw/workspace看文件在不在。这一步通了说明 agent 的文件写入权限也生效了。5. 新手最容易踩的四个配置坑第一个坑baseUrl 写成https://taotoken.net/api/v1。OpenClaw 内部拼接的是/chat/completions你多写/v1就变成/api/v1/chat/completions路径不对直接 404。正确写法就是https://taotoken.net/api。第二个坑Key 复制时带了空格或者换行。从网页复制 Key 经常会在末尾带一个不可见字符粘进 json 后请求鉴权失败。解决办法是粘贴后手动把光标移到末尾按一下退格或者用编辑器的「显示不可见字符」功能检查。第三个坑json 格式错误。少个逗号、多个逗号、引号用了中文引号都会导致程序读不到配置表现是启动后 Gateway 离线或者模型名显示为空。改完配置后可以用在线的 json 校验工具过一遍或者用 VS Code 打开格式错它会标红。第四个坑端口被占用。18789 这个端口有时候会被其他本地服务占了表现是 Gateway 一直起不来。改gateway.port为 18790 或 18800保存后完全退出程序再启动。如果排查完还是不通直接到 https://taotoken.net/api-keys 重新生成一个 Key 换上去试排除 Key 本身失效的可能。接入文档在 https://taotoken.net/doc 里面有完整的请求示例可以对照。6. 配通之后怎么继续用起来基础配置跑通后你其实已经拿到了一个能本地执行任务的智能体。日常用的时候模型对话入口在 https://taotoken.net/chat 想快速验证某个模型回不回、回得对不对直接在那里试比在 OpenClaw 里试更快。如果你打算长期跑编码类任务或者挂 Agent 自动执行可以看一下 Coding Plan通道稳定性和额度策略更适合持续调用。回到 OpenClaw 本身settings.json里还有几个可以按需调的agent.maxSteps控制单次任务最多执行多少步设太小复杂任务会中途停model.temperature设 0.2 到 0.3 会让文件整理这类操作更稳定设 0.7 以上适合创意类对话。改完记得重启程序配置不会热加载。最后提醒一句每次改完settings.json先发一句「你好」确认通道通再去跑复杂任务。这样出问题的时候你能快速判断是配置挂了还是任务本身的问题省得来回折腾。 
长河君 · 2026/9/29 10:44:42 · 阅读 1.2k OpenClaw 2.7.9 新手配置全流程：从 settings.json 骨架到 TaoToken 接入
1. 先搞清楚 OpenClaw 2.7.9 的 settings.json 到底管什么OpenClaw 2.7.9 是那种「装完之后不配一下就用不起来」的本地智能体项目圈内人管它叫小龙虾。它能读懂自然语言然后在你电脑上执行操作比如整理文件夹、抓网页数据、批量处理表格。但很多人卡在第一步装是装上了主界面右上角 Gateway 一直显示离线或者能启动但模型调用报错。问题九成出在settings.json这个文件上。settings.json是 OpenClaw 的核心配置文件它决定了三件事网关服务监听哪个端口、模型请求走哪条通道、以及用哪个 Key 去鉴权。新手最容易犯的错是只改了模型名字没改 base_url或者 Key 填了但格式不对结果请求发出去直接被拒。这篇就按「骨架 → 填参数 → 接 TaoToken → 验证生效」的顺序走一遍你跟着复制粘贴就能跑通。适合谁看第一次接触 OpenClaw 2.7.9、本地已经解压好但还没配通模型通道的人。不需要你会写代码但需要你能找到安装目录、会用文本编辑器打开 json 文件。2. 接入前先把 TaoToken 的 Key 和通道准备好OpenClaw 本身不绑定任何一家模型服务它通过 OpenAI 兼容格式去请求模型。所以你需要一个提供统一 API 通道的服务TaoToken 就是干这个的一个 Key 可以调多家模型base_url 统一省得你在配置文件里来回换地址。操作路径很直接打开 https://taotoken.net/api-keys 登录后创建一个 API Key。创建时注意两点一是 Key 只在创建时完整显示一次复制下来存好二是如果你只是本地测试权限给默认的就行不用开太高。拿到 Key 之后记下两个东西Key 本身形如sk-开头的一串字符以及 API 基础地址https://taotoken.net/api。这两个值马上要填进settings.json。如果你对通道概念还不熟可以先到 https://taotoken.net/doc 看一眼接入说明里面把 OpenAI 兼容格式的请求结构讲得比较清楚。注意Key 不要直接提交到 Git 仓库或者截图发群里。本地配置文件里填明文是正常的但别外传。3. 可直接复制的 settings.json 完整骨架OpenClaw 2.7.9 的配置文件一般在安装目录下的config文件夹里文件名就是settings.json。如果你解压后没找到这个文件可以在安装目录搜一下或者首次启动后它会自动生成一份默认的。用 VS Code 或 Notepad 打开把下面这段整体替换进去{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true, logLevel: info }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelName: claude-sonnet-4-20250514, maxTokens: 4096, temperature: 0.7, timeout: 60000 }, agent: { workspace: D:/OpenClaw/workspace, allowFileWrite: true, allowBrowserControl: true, maxSteps: 20 }, ui: { language: zh-CN, theme: dark } }逐项说一下关键参数。gateway.port是本地网关监听端口默认 18789如果你电脑上这个端口被占了改成 18790 也行但改完要重启程序。model.baseUrl必须填https://taotoken.net/api注意结尾不要多加/v1OpenClaw 内部会自己拼路径。model.apiKey换成你刚才复制的那个 Key。model.modelName填你想用的模型标识上面示例填的是 Claude 系列你也可以换成其他支持的模型名。agent.workspace是智能体干活的工作目录建议设成纯英文路径别带中文和空格。allowFileWrite和allowBrowserControl控制它能不能写文件和操控浏览器本地自己用可以都开true。保存文件时注意编码选 UTF-8别存成带 BOM 的格式否则解析可能报错。4. 启动并验证配置是否真的生效配置写完不算完得验证请求确实发出去了、模型确实回了。先重启 OpenClaw 主程序看右上角 Gateway 状态。如果显示「在线」说明网关起来了。然后点左侧「聊天对话」在底部输入框发一句最简单的你好请回复你的模型名称如果配置正确几秒内会返回模型的自报名称。这一步能通说明 baseUrl、apiKey、modelName 三个参数都对上了。想更直观地确认请求走的是 TaoToken 通道可以打开「运行日志」面板找类似这样的记录[model] POST https://taotoken.net/api/chat/completions [model] status200, modelclaude-sonnet-4-20250514看到status200就稳了。如果日志里出现401那是 Key 的问题出现404多半是 baseUrl 多写了路径出现timeout检查网络或者把timeout调大。再做一个实际动作验证在对话框输入「在 workspace 目录下新建一个 test.txt写入 hello」然后去D:/OpenClaw/workspace看文件在不在。这一步通了说明 agent 的文件写入权限也生效了。5. 新手最容易踩的四个配置坑第一个坑baseUrl 写成https://taotoken.net/api/v1。OpenClaw 内部拼接的是/chat/completions你多写/v1就变成/api/v1/chat/completions路径不对直接 404。正确写法就是https://taotoken.net/api。第二个坑Key 复制时带了空格或者换行。从网页复制 Key 经常会在末尾带一个不可见字符粘进 json 后请求鉴权失败。解决办法是粘贴后手动把光标移到末尾按一下退格或者用编辑器的「显示不可见字符」功能检查。第三个坑json 格式错误。少个逗号、多个逗号、引号用了中文引号都会导致程序读不到配置表现是启动后 Gateway 离线或者模型名显示为空。改完配置后可以用在线的 json 校验工具过一遍或者用 VS Code 打开格式错它会标红。第四个坑端口被占用。18789 这个端口有时候会被其他本地服务占了表现是 Gateway 一直起不来。改gateway.port为 18790 或 18800保存后完全退出程序再启动。如果排查完还是不通直接到 https://taotoken.net/api-keys 重新生成一个 Key 换上去试排除 Key 本身失效的可能。接入文档在 https://taotoken.net/doc 里面有完整的请求示例可以对照。6. 配通之后怎么继续用起来基础配置跑通后你其实已经拿到了一个能本地执行任务的智能体。日常用的时候模型对话入口在 https://taotoken.net/chat 想快速验证某个模型回不回、回得对不对直接在那里试比在 OpenClaw 里试更快。如果你打算长期跑编码类任务或者挂 Agent 自动执行可以看一下 Coding Plan通道稳定性和额度策略更适合持续调用。回到 OpenClaw 本身settings.json里还有几个可以按需调的agent.maxSteps控制单次任务最多执行多少步设太小复杂任务会中途停model.temperature设 0.2 到 0.3 会让文件整理这类操作更稳定设 0.7 以上适合创意类对话。改完记得重启程序配置不会热加载。最后提醒一句每次改完settings.json先发一句「你好」确认通道通再去跑复杂任务。这样出问题的时候你能快速判断是配置挂了还是任务本身的问题省得来回折腾。