【最新教程】OpenClaw（原Clawdbot/Moltbot）本地部署快速指南：把 settings 改到 TaoToken

1. OpenClaw 本地部署后模型接入卡点settings 文件到底改哪一行OpenClaw原 Clawdbot / Moltbot本地部署跑通之后很多人会卡在同一个地方Web UI 能打开http://127.0.0.1:18789也进得去但一发消息就报错或者干脆一直转圈。这个环节的核心检索词就是OpenClaw 本地部署模型接入配置说白了就是让本地实例知道「去哪个地址、用哪个 Key、调哪个模型」。我先把场景说清楚。你已经完成了 Node.js 环境准备建议 22 以上实测 24 更稳用官方脚本装好了 OpenClawQuickStart 也走完了。此时 OpenClaw 的配置文件默认落在用户目录下的~/.openclaw/openclaw.jsonWindows 下是C:\Users\你的用户名\.openclaw\openclaw.json。这个文件里管着模型供应商、API Key、Base URL、频道Channel、技能Skill等一堆东西。问题在于QuickStart 阶段如果你跳过了模型配置或者随手填了一个不完整的 Key后面所有对话请求都会失败。表现通常是三种一是 Web UI 里发消息后提示鉴权失败二是终端日志里出现401或invalid api key三是请求发出去了但返回体里读不到choices字段前端直接白屏。适合谁看这篇适合已经跑通 Node.js、GitOpenClaw 主程序能启动但模型这一环没配利索的开发者。你不需要重新装一遍只要把 settings 里那几行改对再发一次请求验证连通性就行。下面我会给出可直接复制的 JSON 片段路径和字段名都按 OpenClaw 实际结构来改完重启服务即可生效。先明确一个概念OpenClaw 本身是个「壳」它负责调度、频道接入、技能执行真正干活的大模型要靠外部 API。所以配置的本质是告诉它——Base URL 指向谁、Key 用哪个、Model ID 叫什么。这三件套缺一不可后面每一节都会围绕它们展开。2. TaoToken 前置准备Base URL、Key 与 Model ID 三件套怎么拿在改 OpenClaw 的 settings 之前得先把「三件套」准备好。这里我用 TaoToken 作为模型接入方原因是它的接口格式和主流 OpenAI 兼容协议一致OpenClaw 这类工具接起来几乎零改造。你需要准备的是一个 Base URL、一个 API Key、一个 Model ID。Base URL 固定写成https://taotoken.net/api注意结尾不要多加/v1之类的后缀OpenClaw 内部会自己拼路径。API Key 需要你去控制台生成入口在 API Keys 页面生成后复制那一串以sk-开头的字符串只显示一次丢了就重新建一个。Model ID 则取决于你想用哪个模型比如常见的对话模型直接填对应名称即可具体可选项在模型对话页面能看到当前可用的列表。操作顺序建议这样先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录然后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsole 确认账户状态接着到 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keys 生成 Key。如果你不确定该选哪个模型可以先在模型对话 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchat 里试一句确认能正常返回再把这个 Model ID 填进 OpenClaw。这里有个容易踩的坑很多人把 Base URL 写成带/v1/chat/completions的完整路径结果 OpenClaw 又拼了一次变成双份路径直接 404。记住只写到/api为止。另一个坑是 Key 前后带了空格或换行复制时肉眼看不出来粘进 JSON 就报鉴权失败建议粘贴后手动检查首尾。如果你打算长期跑编码类或 Agent 类任务可以顺带了解 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-plan 它更适合高频调用场景。但本篇只聚焦本地实例的连通性配置套餐的事后面按需再看。三件套备齐后就可以进 settings 文件动手了。3. 可复制配置openclaw.json 里 Base URL 与 Key 的改法现在进入正题改~/.openclaw/openclaw.json。改之前先备份一份命令是cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bakWindows 下直接复制粘贴一份改名即可。然后用编辑器打开找到models或providers这一段。不同版本字段名略有差异但结构大同小异核心是填一个 OpenAI 兼容的 provider。下面这段是可直接复制的 JSON 片段路径与 OpenClaw 实际结构一致你把它合并进自己的配置文件即可注意 JSON 不允许尾逗号{ models: { default: your-model-id, providers: { taotoken: { type: openai, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key粘贴在这里, models: [ { id: your-model-id, name: TaoToken Chat } ] } } } }几个字段逐个说明。type填openai表示走 OpenAI 兼容协议OpenClaw 会用标准格式发请求。baseUrl就是上一步拿到的https://taotoken.net/api不要带多余路径。apiKey填你生成的sk-开头的串。models数组里的id必须和你在模型对话里验证过的 Model ID 完全一致大小写敏感。default指向默认使用的模型 id。如果你之前 QuickStart 时已经填过别的 provider比如 MiniMax建议把旧的 provider 整段删掉或注释掉避免 OpenClaw 按顺序取到旧配置。JSON 没有注释语法删掉最干净。改完保存然后重启 OpenClaw 服务。重启命令取决于你的启动方式如果是前台跑的CtrlC 后重新执行启动命令如果是后台服务用对应的 restart。改完配置后建议用一条命令快速校验 JSON 语法避免因为一个逗号导致整个文件解析失败node -e JSON.parse(require(fs).readFileSync(process.env.HOME /.openclaw/openclaw.json,utf8)); console.log(JSON OK)Windows PowerShell 下把process.env.HOME换成process.env.USERPROFILE。输出JSON OK就说明格式没问题。这一步能帮你提前排掉一大半「配置改了但没生效」的假故障。确认无误后进入下一节发真实请求验证。4. 验证请求发一次对话确认本地实例连通配置改完、服务重启后别急着开 Web UI 点按钮先用最直接的方式验证——发一条 curl 请求确认 Base URL 和 Key 本身是通的。这一步能把「网络问题」和「OpenClaw 配置问题」分开排障效率高很多。在终端执行curl https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: your-model-id, messages: [{role: user, content: 你好回复一句话确认连通}] }如果返回体里能看到choices数组且message.content里有正常文字说明三件套没问题。如果这里就报 401那是 Key 的问题报 404那是 Base URL 或路径的问题报模型不存在那是 Model ID 写错了。先把这一层跑通再回到 OpenClaw。接着打开 Web UIhttp://127.0.0.1:18789在对话框里发一句「帮我查一下当前磁盘使用情况」。正常情况下它会调用模型并返回结果。如果 Web UI 报错去看 OpenClaw 的终端日志日志里会打印实际发出的请求地址和返回码对照上一段的三种错误类型定位。实测下来最容易出问题的是 Model ID 和 Base URL 这两处。Model ID 建议直接从模型对话页面复制别手打。Base URL 确认结尾是/api没有斜杠结尾。两个都对上基本一次就通。连通之后你就可以继续接飞书频道、配 Skill 和 Hooks 了那些属于上层功能前提是模型这一层稳。5. 本篇常见错排查401、local proxy failed 与 reading choices这一节把几个高频报错摊开讲都是真实会遇到的对照着改就行。401 Unauthorized / invalid api key九成是 Key 的问题。检查三处——Key 是否复制完整、前后是否有空格换行、是否已经过期或在控制台被删除。还有一种情况是配置文件里同时存在多个 providerOpenClaw 取到了旧的那个 Key。解决方法是只保留一个 provider或确认default指向正确。local proxy failed / connection refused这个报错通常和 Base URL 有关。如果你填了http://127.0.0.1:xxxx这类本地地址但本地并没有对应服务在跑就会 refused。用 TaoToken 的话 Base URL 是https://taotoken.net/api是公网地址出现这个错多半是你把地址写成了别的。另外检查系统代理设置某些环境变量如HTTP_PROXY会干扰请求临时 unset 掉再试。Cannot read properties of undefined (reading choices)这个错说明请求发出去了但返回体结构不对OpenClaw 按 OpenAI 格式去读choices没读到。常见原因是 Base URL 写成了带/v1的完整路径导致实际请求打到了错误端点返回的是错误页而不是标准响应。把 Base URL 改回https://taotoken.net/api即可。也有可能是 Model ID 不存在服务端返回了错误对象。OAuth / 鉴权跳转类报错如果你在配置里误开了某些需要 OAuth 的 provider 类型OpenClaw 会尝试走授权流程但本地环境没有回调地址就会卡住。确认type填的是openai不要填成需要 OAuth 的类型。配置改了不生效先确认你改的是当前用户目录下的~/.openclaw/openclaw.json而不是项目目录里的示例文件。再确认服务真的重启了。最后用第 3 节的 JSON 校验命令确认文件语法正确。三件套Base URL Key Model ID任何一项写错都会导致失败建议逐项对照。6. 把配置固化下来一次改对后续复用配置跑通之后建议把这份openclaw.json单独备份到一个安全位置比如你的私有笔记或密码管理器里只保留结构、Key 单独存。这样下次换机器或重装时直接替换文件、补上 Key 就能用不用再从头摸一遍字段。另外如果你后续要接 Claude Code 或做更复杂的 Agent 编排可以看接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc 里的协议说明Base URL 和 Key 的用法是一致的换的只是调用方。本地 OpenClaw 这一层配好之后它就是个稳定的模型出口上层接飞书、接定时任务、接文件操作都建立在这次连通性验证成功的基础上。最后提醒一句改配置时养成先备份、再改、后校验的习惯node -e那行 JSON 校验命令值得存成快捷方式。模型接入这一环没有玄学就是三件套对齐对齐了就通。