企业官网建设流程全解析

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 写的，你的电脑原生不认识 JavaScript，Node.js 就是那个翻译官。版本要求 Node.js >= 22，低于这个版本 openclaw 的某些依赖会直接报错。下载地址在 nodejs.org，装完后按 Win + R 输入 cmd，执行：

node -v

看到 v22.x.x 以上就对了。如果显示 v18 或更低，去官网下最新 LTS 覆盖安装。

git 的作用是拉取 openclaw 的依赖和技能组件，这些资源托管在 Git 仓库里。下载地址 git-scm.com，装完验证：

git --version

ollama 是可选的，但如果你想跑本地模型、不依赖任何云端 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 控制台创建 Key：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

创建完 Key 后，API 地址用https://taotoken.net/api，这个地址不加 UTM 参数，直接写进配置。模型对话入口在 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，配的时候对照着看。

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/api，ollama 用本地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?session=main

如果提示需要 token，去根目录的openclaw.json里搜token，拼到链接后面：

http://127.0.0.1:2639/chat?token=你的token&session=main

进去后直接提问，比如“帮我列出当前目录下的文件”，如果模型正常返回，说明 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_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 里试，确认模型可用后再回 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 返回 401：Key 复制时带了空格，或者 baseUrl 写成了带 UTM 的地址。API 地址就用https://taotoken.net/api，不要加参数。

如果你后面要长期跑编码任务或 Agent 工作流，建议把 Coding Plan 也配上，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，统一 Key 管理起来更省事。API Key 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，配的时候对照着看，少走弯路。