1. 为什么浏览器自动化总在“配置”这一步卡住OpenClaw 浏览器自动化简单说就是让 AI 直接接管你本机 Chrome用自然语言完成打开页面、点击按钮、填表单、抓数据这类重复动作。它适合三类人经常做数据采集的运营、需要回归测试的前端、以及想把日常网页操作脚本化的开发者。和 Selenium、Puppeteer 相比它最大的差别是不用你写选择器靠 Browser Relay 扩展把页面结构转成可引用的 aria-refAI 再根据 ref 去操作。但真正上手时卡人的往往不是“怎么点按钮”而是环境链路太长Gateway 服务、Browser Relay 扩展、模型调用通道、config.toml、settings.json任何一环没对齐openclaw browser status就给你一个冷冰冰的Disconnected。尤其是模型调用这一层很多人本地跑通了浏览器连接却在 Agent 推理时因为 Key 分散、通道不统一而反复报 401 或超时。这篇就聚焦一件事从零搭一个可复现的本地环境用 TaoToken 统一 Key 和 API 通道把 OpenClaw 的配置与验证一次跑通。我会给出 config.toml 和 settings.json 的可复制骨架、启动脚本以及一次完整的自动化任务验证动作。你照着做能拿到一个稳定可复用的基线环境后面再叠加采集、测试、定时任务都不会推倒重来。2. TaoToken 前置统一 Key 与 API 通道OpenClaw 的 Agent 需要调用大模型来做页面理解和动作决策默认配置里模型通道是分散的换一个模型就要改一处 Key。TaoToken 在这里的角色是统一入口一个 Key 走 API 通道模型对话、编码计划、控制台管理都在同一套体系里省掉多份凭证来回切换的麻烦。你需要先拿到 Key。登录控制台后进入 API Keys 页面创建建议按项目命名比如openclaw-local方便后面在 config.toml 里对应。创建后复制保存页面只展示一次。控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_browser_automationAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_browser_automation接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_browser_automationAPI 基础地址统一用https://taotoken.net/api注意这个地址不带任何查询参数配置里直接写死即可。如果你后面要验证模型是否通可以先用模型对话页面发一条测试消息确认 Key 有效再往下配 OpenClaw这样能把“Key 问题”和“OpenClaw 配置问题”分开排查。注意Key 只放在本地配置文件或环境变量里不要提交到 Git也不要在截图里露出完整字符串。建议用.env加.gitignore的方式管理。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两层config.toml管 Gateway、浏览器 Profile 和模型通道settings.json管 Agent 行为和工具开关。下面这份骨架是我实测能跑通的最小集你按自己路径改chromePath和userDataDir即可。先建目录结构保持可复现mkdir -p ~/openclaw-lab/{config,logs,scripts} cd ~/openclaw-lab然后是config/config.toml# ~/openclaw-lab/config/config.toml [gateway] host 127.0.0.1 port 9527 log_level info log_dir /Users/yourname/openclaw-lab/logs [model] # TaoToken 统一通道 provider openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY default_model gpt-4o-mini timeout_ms 60000 max_retries 2 [browser] # 使用本机 Chrome保留登录态 profile chrome chrome_path /Applications/Google Chrome.app/Contents/MacOS/Google Chrome user_data_dir /Users/yourname/Library/Application Support/Google/Chrome remote_debugging_port 9222 headless false default_timeout_ms 30000 [browser.relay] enabled true extension_id your-browser-relay-extension-idsettings/settings.json管 Agent 的工具权限和快照策略{ agent: { name: openclaw-local, max_steps: 30, snapshot_mode: aria, auto_retry: true, retry_limit: 3 }, tools: { browser: { enabled: true, actions: [status, open, navigate, snapshot, act, screenshot, tabs], allow_upload: false, allow_download: true }, cron: { enabled: true } }, safety: { confirm_before_submit: true, blocked_domains: [] } }Key 用环境变量注入别写进 toml。启动脚本scripts/start.sh#!/usr/bin/env bash set -euo pipefail export TAOTOKEN_API_KEYsk-your-key-here export OPENCLAW_CONFIG$HOME/openclaw-lab/config/config.toml export OPENCLAW_SETTINGS$HOME/openclaw-lab/settings/settings.json echo [1/3] 检查 Gateway 状态... openclaw gateway status || openclaw gateway start echo [2/3] 等待端口就绪... sleep 2 echo [3/3] 检查浏览器连接... openclaw browser status给脚本执行权限并运行chmod x ~/openclaw-lab/scripts/start.sh ~/openclaw-lab/scripts/start.sh参数对照表方便你按环境改配置项作用常见取值base_url模型 API 通道https://taotoken.net/apiapi_key_envKey 环境变量名TAOTOKEN_API_KEYprofile浏览器 Profilechrome/openclawsnapshot_mode快照引用方式aria推荐/roleremote_debugging_port调试端口9222max_steps单任务最大步数304. 验证请求一次完整的自动化任务配置写完必须验证否则你不知道是通道问题还是浏览器问题。分两步先验模型通道再验浏览器自动化。第一步确认 TaoToken 通道可用。用 curl 直接打 API避免 OpenClaw 层干扰curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: reply with ok}] } | head -c 300返回里带choices字段就说明 Key 和通道没问题。如果这里就报 401先回控制台确认 Key 状态别急着改 OpenClaw。第二步跑一次浏览器自动化任务。启动 Gateway 和浏览器后执行openclaw browser status # 期望输出: Connected, 1 tab active openclaw browser open --url https://example.com openclaw browser snapshot --refs ariasnapshot会返回带e1、e2这类 aria-ref 的元素列表。拿到 ref 后执行一次点击和输入验证动作链路openclaw browser act --request {kind:type,ref:e5,text:openclaw test} openclaw browser act --request {kind:press,key:Enter} openclaw browser screenshot --full-page --output ~/openclaw-lab/logs/verify.png如果截图里能看到输入结果说明“模型决策 → 浏览器执行 → 结果回传”整条链路通了。这一步跑通后再让 Agent 用自然语言执行一个完整任务比如“打开 example.com截图并保存”观察它是否自动完成 snapshot、act、screenshot 的编排。5. 本篇常见错排查报错一Failed to connect to gateway on port 9527端口没起来或被占用。先lsof -i :9527看占用再openclaw gateway restart。如果反复失败检查 config.toml 里host是否被改成了非本地地址。报错二Browser Relay not responding扩展没启用或 extension_id 不匹配。打开chrome://extensions/确认 Browser Relay 已启用把扩展 ID 回填到 config.toml 的extension_id。改完重启 Gateway。报错三401 Unauthorized出现在 Agent 推理阶段Key 没注入或环境变量名不一致。确认TAOTOKEN_API_KEY在当前 shell 里echo有值且 config.toml 的api_key_env拼写一致。注意 base_url 用https://taotoken.net/api不要多加路径。报错四Element ref e12 not found页面结构变了或快照过期。重新执行openclaw browser snapshot --refs aria拿新 ref别复用旧 ref。动态加载页面建议先wait再操作。报错五操作超时默认 30s 不够。在 act 请求里加timeoutMs或调大 config.toml 的default_timeout_ms。网络慢的站点建议配合{kind:wait,textGone:加载中...}。报错六登录态丢失用了openclaw独立 Profile。需要登录态的站点改用chromeProfile并在启动前确保本机 Chrome 已登录目标站点。6. 把环境固化下来再谈自动化跑通之后建议把config.toml、settings.json、start.sh一起放进版本库Key 走环境变量这样换机器或重装能五分钟复原。日常调试时我习惯先openclaw browser status确认连接再跑任务出问题先看logs/下的 Gateway 日志比盲猜快得多。后续要扩展采集或定时任务直接在这个基线上加cron配置即可不用再动模型通道。如果你还没建 Key从 API Keys 页面开始想先验证模型通不通用模型对话发一条消息最快长期跑编码或 Agent 任务可以看 Coding Plan 的额度方案。环境稳了自动化才谈得上效率。