企业官网建设流程全解析

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，注意结尾不要多加/v1，OpenClaw 内部会自己拼路径。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] status=200, model=claude-sonnet-4-20250514

看到status=200就稳了。如果日志里出现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，先发一句「你好」确认通道通，再去跑复杂任务。这样出问题的时候你能快速判断是配置挂了还是任务本身的问题，省得来回折腾。