1. 从一次“鉴权打架”说起openclaw Agent 篇二要解决什么如果你已经跟着篇一跑通了 openclaw 的基础 Agent那么篇二大概率会卡在同一个地方Gateway 和 agent-browser 各自维护一套 Key改一处忘一处浏览器自动化调用时好时坏。这篇就聚焦这个落地环节把鉴权通道统一到 TaoToken 上给出可直接复制的config.toml与settings.json骨架并演示启动后怎么验证 agent-browser 的浏览器自动化调用真的生效了。openclaw 是一个把大模型能力接到本地工具链上的 Agent 框架Gateway 负责统一入口和路由agent-browser 负责通过 Chrome DevTools Protocol 控制浏览器实例。适合谁适合已经能跑通单 Agent、现在想让 AI 自己上网抓页面、填表单、点按钮的开发者。核心检索词就三个openclaw、Gateway、agent-browser外加一个统一 Key 的诉求。我试过把 Gateway 和 agent-browser 的 Key 分开配结果就是 Gateway 能对话、浏览器插件却报 401排查半天才发现是两处 provider 指向了不同通道。所以篇二的重点不是再讲一遍安装而是把鉴权收敛成一条通道让 Gateway 和 agent-browser 共用同一个 TaoToken Key。2. TaoToken 前置为什么用它统一 KeyTaoToken 在这里扮演的是“统一 API 通道”的角色。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。它的价值在于你不需要在 Gateway 里配一个 Key、在 agent-browser 里再配另一个 Key而是让两者都指向同一个 API 通道鉴权只维护一份。具体到 openclaw 的配置结构Gateway 侧的模型调用和 agent-browser 侧的浏览器工具调用最终都会走 provider 的base_url和api_key。把这两个值统一成 TaoToken 的地址和 Key就避免了“改了一处、另一处没同步”的经典问题。你需要先拿到一个可用的 Key。进入控制台创建https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 然后在 API Keys 页面生成https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。生成后先复制保存后面config.toml和settings.json都要用到它。注意Key 只显示一次建议生成后立刻写入配置文件不要留在聊天记录里。如果你只是先验证模型通道是否通可以先用模型对话页面测一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。3. 可复制配置config.toml 与 settings.json 骨架openclaw 的配置分两层Gateway 侧用config.tomlAgent 与浏览器插件侧用settings.json。下面给出的是骨架字段名按你本地版本可能略有差异但结构是通用的。先看 Gateway 侧的config.toml。路径通常在~/.openclaw/config.tomlWindows 下是$env:USERPROFILE\.openclaw\config.toml。# ~/.openclaw/config.toml [gateway] host 127.0.0.1 port 8787 [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey default_model claude-sonnet-4-5 [agents.defaults] id myagent provider taotoken model claude-sonnet-4-5 [browser] enabled true cdp_port 9222这里的关键是provider.taotoken这一段base_url指向 TaoToken 的 API 地址api_key填你刚生成的 Key。Gateway 和后面的 agent-browser 都引用这个 provider就实现了统一鉴权。再看 Agent 侧的settings.json路径在~/.openclaw/agents/myagent/agent/settings.json{ auth: { taotoken: { apiKey: sk-你的TaoTokenKey, baseUrl: https://taotoken.net/api } }, model: { provider: taotoken, model: claude-sonnet-4-5 }, tools: { alsoAllow: [browser] }, browser: { provider: agent-browser, cdpPort: 9222, headless: false } }tools.alsoAllow里加上browser是让 Agent 有权限调用浏览器工具browser.provider指向 agent-browsercdpPort和 Gateway 侧的cdp_port保持一致。这样 Gateway 和 agent-browser 都通过taotoken这个 auth 条目鉴权Key 只维护一份。如果你更习惯用命令行写入等价操作是openclaw config set provider.taotoken.base_url https://taotoken.net/api openclaw config set provider.taotoken.api_key sk-你的TaoTokenKey openclaw config set agents.defaults.provider taotoken openclaw config set agents.defaults.tools.alsoAllow [browser] openclaw config set browser.enabled true改完配置后重启 Gatewayopenclaw gateway restart正常输出类似Restarted Scheduled Task: OpenClaw Gateway说明配置已加载。4. 验证请求确认 agent-browser 调用真的生效配置写完不代表生效必须做一次端到端验证。验证分两步先确认 Gateway 的模型通道通再确认 agent-browser 的浏览器自动化调用通。第一步验证 Gateway 模型通道。用 curl 直接打 TaoToken 的 APIcurl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复 ok}] }如果返回里有正常的choices字段说明 Key 和通道没问题。这一步排除了鉴权本身的问题。第二步验证 agent-browser 是否被 Agent 正确调用。先确认 agent-browser 安装到位agent-browser --version然后确认浏览器插件已启用openclaw config get plugins.entries.browser.enabled openclaw config get browser.enabled两个都返回true才算启用。接着在 openclaw 的 Web 界面或 CLI 里给 myagent 发一条指令帮我打开 https://example.com读取页面标题并返回如果 agent-browser 生效你会看到它启动一个 Chrome 实例非 headless 模式下会弹出窗口访问目标页面然后把标题返回。返回结果类似页面标题Example Domain这一步成功说明 Gateway 和 agent-browser 已经共用同一条 TaoToken 鉴权通道浏览器自动化调用生效。提示如果想让 Agent 长期跑编码或自动化任务可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节可查文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。5. 本篇常见错排查401、CDP 连不上、插件没生效配置过程中最容易踩的坑集中在三类逐个说。第一类401 鉴权失败。表现是 Gateway 能启动但一发消息就报401 Unauthorized。原因通常是config.toml里的api_key和settings.json里的apiKey不一致或者其中一个还是旧 Key。排查方法分别openclaw config get provider.taotoken.api_key和查看settings.json的auth.taotoken.apiKey确保两者完全相同。另外注意base_url结尾不要多加/v1TaoToken 的基址是https://taotoken.net/api路径拼接由客户端处理。第二类CDP 连不上。表现是 agent-browser 启动后报connect ECONNREFUSED 127.0.0.1:9222。原因是config.toml的cdp_port和settings.json的cdpPort不一致或者端口被占用。排查netstat -ano | findstr 9222看端口占用改成一个空闲端口两处同步改。另外 headless 模式下如果 Chrome 没正确下载也会连不上先跑agent-browser install补装。第三类插件没生效。表现是 Agent 收到浏览器指令后回复“没有可用工具”。原因是tools.alsoAllow没加browser或者插件没启用。排查openclaw config get agents.defaults.tools.alsoAllow openclaw config get plugins.entries.browser.enabled前者应包含browser后者应为true。改完记得openclaw gateway restart配置不重启不生效。还有一个隐蔽的坑settings.json是 JSON 格式不能写注释末尾不能有多余逗号否则 Agent 加载时会静默失败。建议改完用python -m json.tool settings.json校验一下。6. 统一 Key 之后下一步怎么走把 Gateway 和 agent-browser 的鉴权统一到 TaoToken 之后你的 openclaw Agent 就有了一个稳定的入口模型调用和浏览器自动化走同一条通道Key 只维护一份排查问题时也只需要看一个地方。如果你还没生成 Key现在去 API Keys 页面创建一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。接入过程中遇到报错优先查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。想先确认模型通道是否正常用模型对话页面发一条消息最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。最后留一个实操建议把config.toml和settings.json里的 Key 抽成环境变量引用比如api_key ${TAOTOKEN_KEY}这样换 Key 时不用改两个文件也避免把 Key 提交到版本库。openclaw 支持环境变量插值具体写法查一下你本地版本的文档即可。
