1. 装完 OpenClaw 之后，真正卡住人的那一步
OpenClaw 可视化安装本身并不难，双击启动、选个纯英文路径、等几分钟就能看到主界面。但很多人装完之后会停在同一个地方：界面能打开，Gateway 却一直显示离线，或者能对话但一让它读写本地文件就报错。问题基本不在安装包，而在安装完成后那两个配置文件——config.toml和settings.json没填对，尤其是模型通道这一段。
OpenClaw 是一个本地部署的自动化执行工具，能接收自然语言指令去操作本地文件、浏览器和办公软件，适合想在自己电脑上跑 AI 自动化、又不想把文件传到云端的职场人和技术爱好者。它本身不绑定某一家模型服务，模型能力靠配置里的 API 通道接入。所以「装完能不能用」这件事，本质是「通道有没有接通」。
这篇就聚焦安装之后的那一段：怎么在 Windows 和 Mac 上找到配置文件、怎么填config.toml与settings.json的骨架、怎么把 TaoToken 的统一 Key 和 API 地址接进去，最后用一条 curl 把连通性验证掉。全程不需要写代码，复制粘贴改几个字段就行。
我试过在 Windows 11 和 macOS 上各走一遍，两边路径不同但字段完全一致，下面会分别标出来。
2. 接入前先把 TaoToken 的 Key 和地址准备好
在动配置文件之前，先把两样东西拿到手：一个 API Key，一个 API 地址。OpenClaw 的模型通道填的就是这两个值。
打开 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册登录后进入控制台。控制台里能看到 API Keys 管理入口，新建一个 Key，复制出来先存到记事本里——这个 Key 只显示一次，关掉页面就得重新建。
API 地址统一用 https://taotoken.net/api ，注意这里不带任何查询参数，直接填这个根地址即可。OpenClaw 的配置里通常要求填到/v1这一层，具体看下面骨架里的写法，两种我都标了。
注意：Key 属于敏感信息，别直接贴到公开的截图或仓库里。配置文件是本地的，问题不大，但分享配置模板时记得把 Key 那行替换成占位符。
如果你后面打算长期跑编码类、Agent 类任务，可以顺带看一下 Coding Plan 页面，它面向的是高频调用场景，和单次对话的计费方式不一样。地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。这一步不是必须的，先把基础通道跑通再说。
3. config.toml 与 settings.json 骨架怎么填
OpenClaw 的配置分两个文件，职责不同：config.toml管服务层和模型通道，settings.json管界面侧和客户端行为。两个都要改，只改一个会出现「能连上但发不出请求」或者「能发请求但界面不认」的情况。
3.1 找到配置文件的真实位置
Windows 下一般在安装目录的config子文件夹里，也就是你解压出来的Openclaw-win\config\。如果安装时选了自定义路径，就去那个路径下找。Mac 下通常在用户目录的应用支持文件夹里，路径形如~/Library/Application Support/OpenClaw/config/。
两个文件如果不存在，手动新建即可，OpenClaw 启动时会读取。文件名必须严格是config.toml和settings.json，大小写敏感，Mac 上尤其注意别写成Config.toml。
3.2 config.toml 骨架
下面这段是模型通道的核心，把api_key换成你自己的 Key：
[server] host = "127.0.0.1" port = 8765 [model] provider = "openai-compatible" base_url = "https://taotoken.net/api/v1" api_key = "sk-你的TaoToken密钥" model_name = "gpt-4o-mini" timeout = 60 [gateway] enabled = true log_level = "info"几个字段说明一下。provider填openai-compatible，因为 TaoToken 的通道兼容 OpenAI 的请求格式，OpenClaw 认这个类型。base_url填到/v1这一层，这是大多数兼容客户端的约定。model_name先填一个通用模型名，跑通之后再按需换。timeout给 60 秒，本地网络波动时不容易误判超时。
提示：如果你的 OpenClaw 版本里
base_url要求不带/v1，就改成https://taotoken.net/api，两种写法在不同版本里都出现过，以启动日志里的实际请求地址为准。
3.3 settings.json 骨架
这个文件管客户端侧，重点是让它知道去连本地哪个 Gateway，以及默认用哪个模型通道：
{ "gateway": { "url": "http://127.0.0.1:8765", "autoStart": true }, "model": { "default": "gpt-4o-mini", "provider": "openai-compatible" }, "ui": { "language": "zh-CN", "theme": "light" } }gateway.url的端口要和config.toml里[server]的port一致，这是最常见的对不上的地方。autoStart设成 true，省得每次手动点重启服务。
3.4 CC Switch / Cline 侧参数示例
如果你是用 CC Switch 或 Cline 这类客户端去连 OpenClaw 暴露的接口，参数填法如下。以 Cline 为例，在它的 API 配置里选 OpenAI Compatible：
| 参数项 | 填写值 |
|---|---|
| Base URL | https://taotoken.net/api/v1 |
| API Key | sk-你的TaoToken密钥 |
| Model | gpt-4o-mini |
| Provider | OpenAI Compatible |
CC Switch 里同理，把 Base URL 和 Key 填进对应字段，模型名保持一致。这样 OpenClaw 和外部客户端走的是同一条 TaoToken 通道，Key 只需要维护一份。
4. 一条 curl 验证通道是否真的通了
配置文件填完，先别急着开界面。用一条 curl 直接打 TaoToken 的接口，能排除掉 OpenClaw 本身的干扰，确认 Key 和地址没问题。
Windows 的 PowerShell 和 Mac 的终端都能跑，命令一样：
curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 10 }'返回里如果出现choices字段和一段模型回复，说明 Key 和地址都是对的。如果返回 401，是 Key 错了或没带上Bearer；返回 404，多半是base_url少了或多了/v1；返回超时，检查本机网络能不能正常访问外网接口。
这一步通了，再回到 OpenClaw 界面点重启服务，右上角 Gateway 状态应该会从离线变成在线。然后随便发一句「列出当前目录的文件」，能正常返回就说明整条链路跑通了。
5. 本篇常见报错排查
Gateway 一直离线：九成是config.toml里[server]的端口和settings.json里gateway.url的端口不一致。两个都改成 8765，重启服务。
提示 api_key 无效：检查 Key 有没有多余空格，Bearer后面有没有漏空格。复制 Key 时容易带上换行符，粘到配置文件里要确认是单行。
请求返回 model not found：model_name填的模型名在 TaoToken 通道里不存在。换成gpt-4o-mini这类通用名先跑通，再按需替换。
Mac 上配置文件不生效：确认文件放在~/Library/Application Support/OpenClaw/config/下，而不是安装目录。Mac 的权限机制会让它优先读用户目录那份。
改了配置但行为没变：OpenClaw 不会热加载配置，改完必须重启 Gateway 服务，界面上的重启按钮或直接关掉程序重开都行。
6. 跑通之后可以接着做什么
通道验证通过、Gateway 在线之后，OpenClaw 的模型能力就接上了。接下来可以试的是把常用指令固化下来，比如文件分类、表格整理这类重复操作，让它按固定话术执行。模型对话页面可以先用来测不同模型名的响应速度和效果，地址是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，换模型只需要改config.toml里的model_name再重启。
如果后面要管多个 Key 或者看调用量，控制台的 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 可以新建和吊销 Key。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有针对不同客户端的参数对照，遇到字段对不上时翻一下比猜快。
配置文件骨架这部分，建议跑通后把config.toml和settings.json各备份一份，下次换机器或者重装时直接改 Key 就能用，省得再走一遍排查。
