OpenClaw Browser Relay 跑已登录网站操作Key 用 TaoTokenTaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建 Key是补上 OpenClaw Browser Relay“步骤3AI 操作”模型缺口的起点。跑已登录网站操作时最容易卡住的不是扩展安装也不是 Chrome 权限而是 Badge 已经 ON、ws://localhost:18880 Gateway 也已经连通后Agent 要决定 snapshot、find_element 还是 act却不知道模型 Key 从哪来。本文从 Agent / Harness 视角把模型 Key 来源补清楚在 OpenClaw 模型配置里填入 TaoToken 的 Base URL 和 API KeyBrowser Relay 的 Gateway 地址与扩展激活流程保持原样。这样 OpenClaw 才能真正驱动 Chrome 扩展在已登录会话里完成页面快照、元素查找和点击操作且模型调用产生的 Token 消耗统一走 TaoToken。一、原问题与场景Browser Relay 已连接但“步骤3AI 操作”缺模型 KeyOpenClaw 使用 Chrome 扩展模式的核心价值是复用用户已经登录的浏览器会话。内置浏览器往往是一个相对独立的环境需要重新登录、重新处理 Cookie也不方便直接使用用户当前浏览器里的扩展和调试工具。Browser Relay 解决的正是这一层Chrome 里安装 OpenClaw Browser Relay 扩展扩展通过 WebSocket 连到本机 GatewayOpenClaw 的 Browser Tool 再把标签页控制命令转成扩展可执行的动作。原文 4.2 操作步骤里流程看起来是完整的在 Chrome 中打开目标网页点击扩展图标确认 Badge 显示 ONAI 操作。问题就出在第 3 步。前两步只证明扩展已经连接标签页Badge 为 ON 说明这个标签页处于可操作状态。但 AI Agent 并不是只靠扩展就能工作。Agent 需要先理解页面 snapshot再判断哪个元素是按钮接着决定是点击、输入还是等待。这个过程必须调用大模型。Harness 负责编排工具调用模型负责推理和动作选择而模型 provider 需要 Key、Base URL 和模型 ID。原文没有交代 Key 从哪里来于是就会出现一种割裂扩展连接正常Gateway 正常Badge 正常但 Agent 在模型层没有可用入口操作无法继续。从 Agent / Harness 视角看这不是 Browser Relay 本身的问题而是模型接入层缺失。已登录网站操作、内部系统访问、多标签页协作这些场景都依赖 Agent 先能思考再能调用 browser 工具。TaoToken 补上的就是这一层它不改变 Chrome 扩展的安装方式也不改变 ws://localhost:18880 的 Gateway 结构只提供 OpenClaw 模型配置所需的 Base URL、API Key 和模型调用入口。二、TaoToken 前置给 OpenClaw Agent 准备模型 Key 与 Base URL在配置 OpenClaw 之前先准备模型侧参数。打开 TaoToken 官网登录后进入控制台找到 API Keys 页面创建 Key。这里建议给 OpenClaw 单独创建一个 Key命名成类似“openclaw-browser-relay”的用途后续轮换、禁用和排查都更清楚。拿到的 Key 占位为YOUR_API_KEYAPI 地址按固定写法使用https://taotoken.net/api注意这个地址是 OpenClaw 模型配置里的 Base URL不是 Chrome 扩展的 Gateway 地址。Browser Relay 的 Gateway 仍然是ws://localhost:18880两者职责不同。前者负责 Agent 推理时调用大模型后者负责 OpenClaw 与 Chrome 扩展之间的标签页控制。不要把 API Base URL 填到扩展的 background.js 里也不要把 ws://localhost:18880 填到模型 provider 里。模型 ID 使用你账号下可用的 MODEL_ID具体名称以 TaoToken 控制台或接入文档为准不要凭记忆乱填。如果你需要确认接入字段可以查看 TaoToken 的 API Keys 与接入文档API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite这一步的目标不是“拿到一个 Key”就结束而是让 OpenClaw 的 Agent 在需要推理时能稳定请求到 https://taotoken.net/api。只要模型入口可用Browser Relay 后面执行 snapshot、find_element、act 才有决策来源。三、可复制配置OpenClaw 模型配置与 Browser Relay 保持分离OpenClaw 不同版本对模型配置的字段命名可能略有差异但核心信息一致provider、base URL、API Key、model ID。下面给一个通用 JSON 结构字段名以你的 OpenClaw 版本为准关键是三处不要错。{ model: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, model: MODEL_ID }, browser: { profile: chrome, gatewayUrl: ws://localhost:18880 } }如果你的 OpenClaw 使用 models/providers 结构可以等价写成{ models: { default: MODEL_ID, providers: { taotoken: { type: openai-compatible, base_url: https://taotoken.net/api, api_key: YOUR_API_KEY } } } }如果 OpenClaw 支持环境变量也可以这样设置export OPENCLAW_MODEL_PROVIDERtaotoken export OPENCLAW_MODEL_BASE_URLhttps://taotoken.net/api export OPENCLAW_MODEL_API_KEYYOUR_API_KEY export OPENCLAW_MODEL_IDMODEL_IDBrowser Relay 侧不需要因为 TaoToken 而改动。扩展的 background.js 仍然连接本机 Gatewayconst GATEWAY_URL ws://localhost:18880; const ws new WebSocket(GATEWAY_URL);扩展权限也保持原样继续使用 tabs、activeTab、scripting、storage 这类必要权限。Chrome 扩展管理页仍然是chrome://extensions/开发者模式、加载已解压扩展、点击图标激活、Badge 显示 ON这些流程都不用变。需要变的只是 OpenClaw 模型配置把模型请求指向 TaoToken把 Key 换成 YOUR_API_KEY把模型 ID 换成 MODEL_ID。四、验证请求从模型 ping 到 snapshot、find_element、act 跑通已登录网站配置完成后不要直接上复杂页面先用最小请求验证模型通道。因为 Base URL 是 https://taotoken.net/apiOpenAI 兼容路径通常会落到 /v1/chat/completions。可以用 curl 做一次模型 pingcurl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: MODEL_ID, messages: [ {role: user, content: 只回复 pong} ] }如果返回结构里能看到 choices 或类似内容说明 Key、Base URL、模型 ID 至少已经打通。接下来验证 Browser Relay 链路。先在 OpenClaw 侧确认 Gateway 已启动ws://localhost:18880 可连接。然后在 Chrome 中打开一个已经登录的目标网站点击 Browser Relay 扩展图标确认 Badge 为 ON。接着让 OpenClaw 以 Chrome profile 启动浏览器工具browser(actionstart, profilechrome)获取当前标签页快照snapshot browser(actionsnapshot, profilechrome)这一步成功时Agent 会拿到页面结构、可交互元素和 ref。接着查找按钮target_btn find_element(snapshot, button, 提交)再执行点击browser( actionact, kindclick, reftarget_btn[ref], profilechrome )成功结果通常表现为扩展 Badge 保持 ONGateway 日志能看到命令往返snapshot 返回了页面元素find_element 命中了预期按钮act 点击后页面状态发生变化。更重要的是OpenClaw 在决定“找哪个按钮、点击哪个 ref”时模型请求已经发往 https://taotoken.net/apiToken 消耗会体现在 TaoToken 侧。对于已登录网站操作这一步不需要重新登录也没有切换浏览器环境用户当前会话直接参与自动化流程。多标签页场景也类似先通过 tabs 获取标签页列表再 focus 到目标标签页然后继续 snapshot、find_element、act。已登录状态仍然由 Chrome 当前会话提供模型决策则来自 TaoToken。五、本篇常见错排查Badge、ws://localhost:18880、模型 401、act 无响应现象常见原因排查方式Badge 不变 ON扩展未激活或当前页不是目标标签页打开目标页点击扩展图标到chrome://extensions/重新加载 Browser Relay连接失败 ws://localhost:18880Gateway 未启动或 18880 被占用启动 OpenClaw Gateway用lsof -i :18880检查端口模型 401 或 403Key 错误、复制不完整、Base URL 填错确认 API Key 为 YOUR_API_KEY 的实际值Base URL 为 https://taotoken.net/api模型 404模型 ID 不存在或名称写错到 TaoToken 控制台或接入文档确认 MODEL_IDAgent 仍走旧模型默认 provider 未切换配置未重启检查 OpenClaw 模型配置重启 OpenClaw 进程snapshot 正常但 act 无响应标签页未聚焦、页面在 iframe、权限不足先 focus 目标标签页检查扩展 host_permissions重新激活扩展find_element 找不到页面异步加载按钮文本变化增加等待使用更稳定的 ref 或元素特征多标签页操作混乱targetId 不对先 tabs 获取列表再 focus 到正确标签页Token 用量不出现请求没有走到 TaoToken检查 OpenClaw 日志里的模型请求地址是否为 https://taotoken.net/api额外注意一点Browser Relay 的 background.js 只负责扩展与 Gateway 的 WebSocket不负责模型鉴权。模型 401、404 这类错误要去 OpenClaw 模型配置和 TaoToken 侧查不要反复重装 Chrome 扩展。反过来如果模型请求正常但 act 点击无效也不要怀疑 Key应该回到标签页激活、Badge 状态、Gateway 连接和页面元素本身。六、CTA把 OpenClaw Browser Relay 的模型 Key 固定到 TaoToken本文解决的问题很具体OpenClaw Browser Relay 已经能连接 Chrome 标签页但原文“步骤3AI 操作”没有交代模型 Key 从哪来。现在把 Key 固定到 TaoTokenOpenClaw 就可以在已登录网站操作中完成 snapshot、find_element、actBrowser Relay 的 ws://localhost:18880 Gateway 和扩展激活流程保持不变。如果你正在排障或刚接入建议先看 API Keys 和接入文档创建与管理 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你要先验证模型是否可用可以直接去模型对话做一次最小请求模型对话https://taotoken.net/console/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite如果你准备长期跑 OpenClaw Agent、Browser Relay、多标签页协作或内部系统自动化建议使用 Coding Plan 管理长期编码与 Agent 调用Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite把 Key 放到正确的位置让模型调用走 TaoToken让标签页控制继续走 Browser Relay。这样 OpenClaw 的 Agent / Harness 链路才是完整的Chrome 提供已登录会话Gateway 提供标签页通道TaoToken 提供模型推理入口。