1. 为什么要在第一天就把 openclaw 的模型配置理顺openclaw 是一个本地部署的 AI 智能体执行框架它本身不带大模型需要你给它接一个“大脑”才能干活。它能直接操作你的电脑——读写文件、跑代码、控制浏览器还能通过聊天软件接收指令数据全部留在本地。适合谁适合想把 AI 从“只会聊天”变成“能动手做事”的开发者、运维、自动化爱好者以及想在自己电脑上跑一套私有智能体工作流的同学。但很多人第一天就卡住了nodejs 版本不对、git 没装、npm 全局安装报错、settings.json 写错一个字段模型就注册不上。更麻烦的是如果你同时接多个模型平台每个平台一套 Key、一套 baseUrl管理起来很乱。我试过把硅基流动、ollama 本地模型、TaoToken 统一 Key 混在一起配结果 agents 里的模型 ID 和 providers 里的对不上网关重启了三次才通。这篇就是帮你把第一天跑通从 nodejs、git、ollama 这些前置依赖开始到 openclaw 安装、settings.json 可复制骨架、TaoToken 统一 Key 接入最后启动网关验证请求附上我踩过的报错排查动作。目标只有一个——当天本地模型调用链路能跑通。2. 前置依赖nodejs、git、ollama 一个都不能少openclaw 是用 JavaScript 写的你的电脑原生不认识 JavaScriptNode.js 就是那个翻译官。版本要求 Node.js 22低于这个版本 openclaw 的某些依赖会直接报错。下载地址在 nodejs.org装完后按 Win R 输入 cmd执行node -v看到 v22.x.x 以上就对了。如果显示 v18 或更低去官网下最新 LTS 覆盖安装。git 的作用是拉取 openclaw 的依赖和技能组件这些资源托管在 Git 仓库里。下载地址 git-scm.com装完验证git --versionollama 是可选的但如果你想跑本地模型、不依赖任何云端 API建议装上。它负责在本地拉起 qwen、llama 这类模型openclaw 通过 OpenAI 兼容接口调用它。装完后确认服务在跑ollama list如果提示连接失败先执行ollama serve把服务拉起来。默认监听http://127.0.0.1:11434这个地址后面配 settings.json 要用。注意nodejs 和 git 的安装路径不要带中文和空格否则 npm 全局安装时容易出权限问题。3. 安装 openclaw 与 TaoToken 统一 Key 的前置准备openclaw 官方推荐用 npm 全局安装npm i -g openclaw如果你在 cmd 里遇到npm error报错换 PowerShell 用官方脚本装Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned iwr -useb https://openclaw.ai/install.ps1 | iex装完验证openclaw --version如果 PowerShell 也报错去官网搜 Visual Studio Build Tools安装时勾选“使用 C 的桌面开发”工作负载再重试。接下来是 TaoToken 统一 Key 的准备。TaoToken 的作用是让你用一个 Key 统一接入多个模型渠道不用在每个平台单独申请、单独管理。你只需要在 TaoToken 控制台创建一个 API Key后面在 settings.json 里把 baseUrl 指向 TaoToken 的 API 地址模型名按渠道写就行。先去 TaoToken 控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建完 Key 后API 地址用https://taotoken.net/api这个地址不加 UTM 参数直接写进配置。模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配的时候对照着看。4. settings.json 可复制骨架TaoToken ollama 双通道openclaw 的配置文件在根目录下文件名是openclaw.json有些版本叫 settings.json以你启动时显示的根目录为准。启动网关时会打印根目录路径一般在C:\Users\你的用户名\.openclaw\下面。下面这份骨架同时配了 TaoToken 统一 Key 通道和 ollama 本地通道你可以直接复制把你的TaoTokenKey替换成真实 Key{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoTokenKey, api: openai-completions, models: [ { id: deepseek-ai/DeepSeek-V3, name: DeepSeek-V3, api: openai-completions, reasoning: false, input: [text], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 131072, maxTokens: 32768 }, { id: Qwen/Qwen2.5-72B-Instruct, name: Qwen2.5-72B-Instruct, api: openai-completions, reasoning: false, input: [text], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 32768, maxTokens: 8192 } ] }, ollama: { baseUrl: http://127.0.0.1:11434/v1, apiKey: ollama-local, api: openai-completions, models: [ { id: qwen3.5:9b, name: qwen3.5:9b, reasoning: true, input: [text], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 32768, maxTokens: 32768 } ] } } }, agents: { defaults: { model: { primary: taotoken/deepseek-ai/DeepSeek-V3 }, models: { taotoken/deepseek-ai/DeepSeek-V3: { alias: DeepSeek-V3 }, taotoken/Qwen/Qwen2.5-72B-Instruct: { alias: Qwen2.5-72B }, ollama/qwen3.5:9b: {} }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace, compaction: { mode: safeguard }, blockStreamingDefault: on, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } }, gateway: { port: 2639 }, tools: { profile: full, sessions: { visibility: all } } }几个关键点说明。baseUrl是 API 调用地址TaoToken 用https://taotoken.net/apiollama 用本地http://127.0.0.1:11434/v1。apiKey里 ollama 随便写ollama-local就行它不校验。models数组里每个模型的id必须和agents.defaults.models里的键完全匹配前缀taotoken/或ollama/不能少否则注册不上。agents.defaults.model.primary是默认模型改完重启网关生效。gateway.port我改成了 2639避免默认端口被扫描。tools.profile设成full是给 openclaw 完整工具权限如果你电脑上有重要数据建议改成目录白名单模式。注意每次改完openclaw.json都要关掉 cmd 窗口重新执行openclaw gateway配置才会生效。改端口后访问链接里的端口号也要同步换。5. 启动网关与验证请求确认模型真的通了配置写完后在 cmd 里执行openclaw gateway启动成功会打印根目录和监听端口。浏览器打开http://127.0.0.1:2639/chat?sessionmain如果提示需要 token去根目录的openclaw.json里搜token拼到链接后面http://127.0.0.1:2639/chat?token你的tokensessionmain进去后直接提问比如“帮我列出当前目录下的文件”如果模型正常返回说明 TaoToken 通道通了。再切到 ollama 模型问一句确认本地通道也通。如果你想单独验证 TaoToken 的 API 是否可用可以用 curl 直接打curl https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer 你的TaoTokenKey ^ -d {\model\:\deepseek-ai/DeepSeek-V3\,\messages\:[{\role\:\user\,\content\:\hi\}]}返回里有choices字段就说明 Key 和地址都没问题。模型对话入口也可以直接在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 里试确认模型可用后再回 openclaw 配。6. 本篇常见报错排查npm 安装报错 npm error换 PowerShell 脚本安装或者装 Visual Studio Build Tools 的 C 桌面开发负载。openclaw --version 提示不是内部命令npm 全局路径没加到 PATH执行npm config get prefix看路径手动加到系统环境变量。网关启动后浏览器打不开检查端口是否被占用netstat -ano | findstr 2639被占用就换端口。防火墙也可能拦临时关掉试。模型注册不上、agents 里模型不生效九成是agents.defaults.models里的键和providers里的id对不上。前缀taotoken/或ollama/必须和 provider 名一致模型 ID 大小写也要完全匹配。提示没有操作权限tools.profile设成full后重启网关如果还不行新开一个 session 或重启电脑可能是配置没热更新。ollama 模型调用失败先ollama serve确认服务在跑再ollama list确认模型已拉取。baseUrl 必须是http://127.0.0.1:11434/v1少/v1会 404。TaoToken 返回 401Key 复制时带了空格或者 baseUrl 写成了带 UTM 的地址。API 地址就用https://taotoken.net/api不要加参数。如果你后面要长期跑编码任务或 Agent 工作流建议把 Coding Plan 也配上入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 统一 Key 管理起来更省事。API Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配的时候对照着看少走弯路。