1. OpenClaw 是什么？从零安装到 MiniMax 模型接入的完整链路

OpenClaw 是一个本地运行的 AI Agent 网关，它能让你在浏览器里直接操控网页、调用大模型、执行自动化任务。你可以把它理解成一个「住在你电脑里的 AI 助手」——它通过本地网关服务（默认跑在 127.0.0.1:18789）接收指令，再转发给你配置的模型提供商。适合谁？适合想在自己机器上跑 Agent、又不想被云端绑定的人；适合需要浏览器自动化 + 大模型推理的开发者；也适合想用 MiniMax 这类国产模型做本地 Agent 实验的人。

我这次要走的链路是：安装 OpenClaw → 配置向导选 MiniMax → 把 settings 里的模型端点改到 TaoToken → 装浏览器 MCP 插件 → 发一次真实请求验证。整条链路里最容易卡住的地方不是安装本身，而是模型端点的配置——很多人装完了发现模型调不通，就是因为 Base URL 和 Key 没对上。TaoToken 在这里的角色是提供一个统一的模型接入层，你不需要分别去每个模型厂商注册、拿 Key、记不同的端点格式，用一套 Base URL + Key 就能切换模型。

OpenClaw 的安装脚本会从官方地址拉取，Windows 用 PowerShell，macOS/Linux 用 curl。安装过程会停很久，这是正常的，别空按回车——安装完第一步有个风险确认，默认是 no，回车就结束安装了。如果不小心回车导致安装提前结束，直接重新跑配置向导就行，因为包已经下载完了。

安装完成后会自动进入新手配置界面，用方向键选择、回车确定。步骤依次是：确认风险 → 选择快速开始 → 选择 AI 提供商和模型 → 输入 API 密钥 → 确认密钥 → 配置技能（可选）→ 安装网关服务。这里选 MiniMax 作为提供商，API Key 你自己准备。Windows 终端里 Ctrl+V 可能粘不上，复制 Key 后在终端窗口内点鼠标右键通常就能粘贴，粘完检查一下有没有多余空格。

网关服务安装需要管理员权限，装完后系统会自动访问 http://127.0.0.1:18789/chat。注意：这个地址直接复制到浏览器会提示 token 未认证，这是 OpenClaw 的安全设置，不是 bug。你需要用带 token 的链接打开，具体命令后面会讲。

整个安装配置过程大概 10-15 分钟，其中安装脚本下载和网关服务安装占大头。配置向导本身很快，关键是 API Key 要填对。如果你打算用 TaoToken 作为模型接入层，那在配置向导里选 MiniMax 之后，Key 填 TaoToken 的 Key，端点后面在 settings 里改。这样你既保留了 OpenClaw 的 Agent 能力，又通过 TaoToken 统一管理模型调用。

2. TaoToken 前置准备：拿 Key、认端点、选模型

在改 settings 之前，你得先把 TaoToken 这边的三件套准备好：Base URL、API Key、Model ID。这三样缺一不可，而且必须完全对应，否则后面请求会报 401 或 model not found。

Base URL 是https://taotoken.net/api，注意不要加 UTM 参数，API 调用地址就是干净的这一个。API Key 去 TaoToken 控制台的 API Keys 页面创建，创建后复制保存，页面关了就看不到了。Model ID 取决于你要用哪个模型，MiniMax 系列有对应的模型标识，具体在模型列表里查。

我建议你按这个顺序操作：先打开 TaoToken 官网注册登录，然后进控制台创建 API Key，再去模型对话页面确认你要用的 MiniMax 模型 ID 是什么。模型对话页面可以直接测试模型能不能通，这样你在改 OpenClaw 配置之前就知道 Key 和模型 ID 是对的。

TaoToken 的接入文档里有完整的端点说明和示例请求，你可以对照着看。文档地址在官网导航里能找到。如果你只是想让 OpenClaw 跑起来，不需要把文档全读完，重点看 Base URL 格式、认证方式（Bearer Token）、以及 chat completions 的请求体结构就行。

这里有个容易踩的坑：TaoToken 的 Base URL 是https://taotoken.net/api，但有些工具的配置里需要你填完整的 chat completions 路径，有些只需要填到/api这一级。OpenClaw 的 settings 里通常填到/api就行，它会自己拼接/v1/chat/completions。如果你填多了或填少了，都会导致 404 或 401。

另外，TaoToken 支持多种模型，你可以在一个 Key 下切换不同模型。这意味着你可以在 OpenClaw 里配一个 TaoToken 的 Key，然后通过改 Model ID 来切换 MiniMax 的不同版本，不需要重新拿 Key。这对做模型对比实验很方便。

如果你打算长期用 OpenClaw 做编码或 Agent 任务，可以考虑 TaoToken 的 Coding Plan，它针对高频调用场景做了优化。但如果你只是先跑通链路，用按量计费的 API Key 就够了。控制台里可以随时查看用量和余额，避免跑着跑着突然没额度了。

准备好这三样之后，你就可以进入下一步——改 OpenClaw 的 settings 文件。改之前建议先备份原文件，万一改错了可以回滚。settings 文件的位置取决于你的安装方式，Windows 通常在用户目录下的.openclaw文件夹里，macOS/Linux 类似。你可以用openclaw configure命令打开配置界面，也可以直接编辑 settings 文件。

3. 可复制配置：把 settings 改到 TaoToken

OpenClaw 的 settings 文件是 JSON 格式，路径通常在~/.openclaw/settings.json（Windows 是C:\Users\{用户名}\.openclaw\settings.json）。你可以直接用文本编辑器打开，也可以先跑openclaw configure看看当前配置长什么样。

下面是一个完整的 settings 片段，把模型端点指向 TaoToken，模型用 MiniMax。你复制的时候把sk-你的TaoToken密钥替换成真实的 Key：

{ "models": { "default": "minimax", "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "models": { "minimax": { "id": "MiniMax-Text-01", "name": "MiniMax via TaoToken", "contextWindow": 128000, "maxTokens": 4096 } } } } }, "gateway": { "port": 18789, "host": "127.0.0.1" }, "browser": { "mcp": { "enabled": true, "extensionPath": "" } } }

几个关键点说明。baseUrl填https://taotoken.net/api，不要加末尾斜杠，也不要加/v1。apiKey填你在 TaoToken 控制台创建的 Key，注意不要有多余空格。models.minimax.id填 MiniMax 的模型 ID，具体值以 TaoToken 模型列表为准，上面写的MiniMax-Text-01只是示例，你要换成实际可用的 ID。

如果你之前已经在配置向导里选了 MiniMax 并填了 Key，那 settings 里可能已经有一个minimax的 provider。你需要做的是把那个 provider 的baseUrl改成 TaoToken 的地址，apiKey换成 TaoToken 的 Key，id换成 TaoToken 支持的 MiniMax 模型 ID。不要保留原来的官方端点，否则请求会走到官方去，而你的 Key 是 TaoToken 的，会报 401。

改完 settings 后，需要重启 OpenClaw 网关服务让配置生效。命令是openclaw gateway restart，或者你先openclaw gateway stop再openclaw gateway start。重启后跑一下openclaw doctor检查配置有没有语法错误，再跑openclaw status看网关状态。

如果你用的是openclaw configure交互式配置，它可能会覆盖你手动改的 settings。所以建议先手动改好 settings，再用openclaw configure只改其他不相关的项，或者干脆全程手动编辑。改完记得保存，然后重启。

还有一个细节：OpenClaw 的 settings 里可能有多个 provider，你要确保models.default指向的是你配好的那个。如果 default 指向了一个没配好的 provider，启动时会报错。你可以把 default 设成taotoken/minimax这种带 provider 前缀的格式，具体看 OpenClaw 的文档要求。

配置改完后，你可以用openclaw health看一下模型连通性。如果显示模型可用，说明 Base URL 和 Key 都对上了。如果报错，先检查 Key 有没有多余空格，再检查 Base URL 是不是https://taotoken.net/api，最后检查 Model ID 是不是 TaoToken 支持的。

4. 验证请求：发一次真实调用确认配置生效

配置改完、网关重启后，别急着开浏览器插件，先用命令行发一次请求验证模型能不能通。OpenClaw 提供了openclaw chat命令，可以直接在终端里跟模型对话。你跑：

openclaw chat --model minimax --message "用一句话介绍你自己"

如果配置正确，你会看到模型返回的文本。如果报错，根据错误信息排查。常见的成功输出类似：

[taotoken/minimax] MiniMax-Text-01 > 我是一个由 MiniMax 提供支持的人工智能助手...

这说明请求已经通过 TaoToken 转发到 MiniMax 并成功返回。你也可以用 curl 直接测 TaoToken 的端点，排除 OpenClaw 配置的干扰：

curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "MiniMax-Text-01", "messages": [{"role": "user", "content": "你好"}], "max_tokens": 100 }'

如果 curl 能通但 OpenClaw 不通，说明问题在 OpenClaw 的 settings 配置上。如果 curl 也不通，说明 Key 或模型 ID 有问题，去 TaoToken 控制台检查。

验证通过后，打开浏览器访问http://127.0.0.1:18789/chat。注意直接访问会提示 token 未认证，你需要用带 token 的链接。跑：

openclaw dashboard

这个命令会自动打开一个带 token 的浏览器页面。如果你想手动复制链接，用：

openclaw dashboard --no-open

它会输出一个带 token 的 URL，你复制到浏览器打开就行。注意--no-open模式下输出的链接任何能访问你局域网的人都能用，所以不要随便分享。

打开聊天界面后，在输入框里发一条消息，比如「帮我总结一下当前页面的内容」。如果模型正常返回，说明整条链路通了：OpenClaw 网关 → TaoToken → MiniMax → 返回结果。

这时候你可以再验证一下浏览器 MCP 插件。在聊天界面里让模型执行一个浏览器操作，比如「打开 example.com 并截图」。如果插件配置正确，你会看到浏览器自动打开并执行操作。如果插件没配好，模型会报找不到 browser 工具。

验证阶段的关键是分步排查：先确认 TaoToken 端点能通（curl），再确认 OpenClaw 能调到模型（openclaw chat），最后确认浏览器插件能接管页面。每一步都过了，才算整条链路配置完成。

5. 常见报错排查：401、local proxy failed、reading choices、OAuth

配置过程中最容易遇到的几个报错，我逐个说下原因和解法。

401 Unauthorized：这是最常见的。原因通常是 API Key 不对、Key 有多余空格、或者 Base URL 指向了错误的端点。你先检查 settings 里的apiKey是不是 TaoToken 的 Key，有没有复制时带了空格。然后检查baseUrl是不是https://taotoken.net/api，有没有多写/v1或少写。如果都对，去 TaoToken 控制台确认 Key 还有效、余额够。还有一种情况是你把 Key 填到了错误的 provider 下，比如 settings 里有两个 provider，你改了一个但 default 指向另一个。

local proxy failed：这个报错通常出现在网关启动时，意思是本地代理服务起不来。原因可能是端口 18789 被占用，或者网关服务没装好。你先跑openclaw status看网关状态，再跑openclaw doctor做系统诊断。如果是端口占用，改 settings 里的gateway.port换一个端口，然后重启。如果是服务没装好，重新跑openclaw onboard --install-daemon重装网关服务。

reading choices 报错：这个通常出现在模型返回格式不对的时候。OpenClaw 期望模型返回标准的 chat completions 格式，里面有choices数组。如果 TaoToken 返回的格式不兼容，或者模型 ID 填错了导致返回了错误信息，就会报这个。你先用 curl 直接测 TaoToken 端点，看返回的 JSON 里有没有choices。如果没有，说明模型 ID 不对或请求体格式有问题。检查model字段是不是 TaoToken 支持的 MiniMax 模型 ID。

OAuth 相关报错：如果你在配置向导里选了 OAuth 方式认证，但 TaoToken 用的是 API Key 认证，就会报 OAuth 错误。解法是在 settings 里把认证方式改成 API Key，或者重新跑配置向导选 API Key 导入方式。OpenClaw 的配置向导里选「API 导入方式」时，选「API Key」而不是「OAuth」。

Token 认证失败（gateway token mismatch）：这个不是模型配置问题，是网关的 token 认证问题。你直接访问http://127.0.0.1:18789/chat会报disconnected (1008): unauthorized: gateway token mismatch。解法是用openclaw dashboard生成带 token 的链接打开，或者用openclaw dashboard --no-open拿到链接手动打开。不要直接复制地址栏的 URL。

浏览器插件加载失败：如果你在 Chrome 里加载 OpenClaw 扩展时提示「无法加载扩展程序」，检查你选的文件夹是不是扩展的根目录（里面有 manifest.json 的那一层）。先用openclaw browser extension path拿到路径，然后在 Chrome 的chrome://extensions/里开启开发者模式，点「加载已解压的扩展程序」，选那个路径。加载后需要填入 token，token 从openclaw dashboard --no-open的输出里拿。

模型返回空或超时：如果模型不返回内容或超时，先检查网络能不能访问 TaoToken 的端点。然后检查maxTokens设置是不是太小，或者contextWindow设得不对。MiniMax 的上下文窗口比较大，但如果你设了一个很小的值，长对话会被截断。另外检查 TaoToken 控制台的用量，如果余额不足会返回错误。

排查的核心思路是分层：先确认 TaoToken 端点能通（curl），再确认 OpenClaw 配置对（openclaw doctor），最后确认浏览器插件加载对（chrome://extensions/）。每一层都过了，问题就定位到了。

6. 浏览器 MCP 插件安装与接管网页实操

OpenClaw 的浏览器 MCP 插件是它区别于普通聊天工具的核心能力——装好后你可以让模型直接操控浏览器标签页，做截图、填表单、抓数据这些事。安装分两步：先在本地装扩展文件，再在 Chrome 里加载。

第一步，跑：

openclaw browser extension install

这会把扩展程序安装到本地路径。然后跑：

openclaw browser extension path

拿到扩展的目录路径，复制下来。

第二步，打开 Chrome，地址栏输入chrome://extensions/回车。在页面右上角找到「开发者模式」开关，打开。页面顶部会出现「加载已解压的扩展程序」按钮，点它，然后选择刚才复制的 OpenClaw 扩展根文件夹（里面有 manifest.json 的那一层），点「选择文件夹」。

加载成功后，扩展会弹出配置界面，让你填 token。token 从哪来？跑：

openclaw dashboard --no-open

输出里会有一个带 token 的 URL，把 token 部分复制出来，填到扩展的配置界面里。填完保存。

第三步，接管网页标签。打开你要接管的网页，点浏览器工具栏里的 OpenClaw 插件图标。如果接管成功，插件图标会变成激活状态，页面右上角可能显示一个提示。这时候你在 OpenClaw 的聊天界面里让模型操作浏览器，它就能控制这个标签页了。

接管成功的标志是：插件图标变色或显示已连接，并且在 OpenClaw 聊天界面里发「当前页面标题是什么」这类问题，模型能返回正确标题。如果模型说找不到 browser 工具，说明插件没加载好或 token 没填对。

浏览器 MCP 插件的配置在 settings 里的browser.mcp部分。enabled设为true，extensionPath可以留空（它会自动找），也可以填你实际的扩展路径。如果你改了 settings 里的这部分，需要重启网关并重新加载扩展。

装完插件后，你可以试一个完整的浏览器操作：在聊天界面输入「打开 example.com，截图，然后告诉我页面标题」。模型会调用 browser 工具，打开标签页、截图、返回标题。如果这一步成功，说明 OpenClaw + TaoToken + MiniMax + 浏览器 MCP 整条链路全部打通。

最后说一个实用技巧：如果你经常用浏览器自动化，可以把常用的操作写成 OpenClaw 的技能（skill），放在~/.openclaw/skills/目录下。技能就是一段预设的指令模板，模型可以调用它来执行固定流程。比如你写一个「抓取当前页面所有链接」的技能，以后直接让模型调用这个技能就行，不用每次重新描述。技能文件是 JSON 或 YAML 格式，具体写法参考 OpenClaw 文档里的技能示例。

整条链路配下来，最花时间的是排查模型端点的问题。只要你把 TaoToken 的 Base URL、Key、Model ID 三样对齐，剩下的就是重启和验证。浏览器插件部分只要 token 填对、扩展加载对，基本不会出问题。