1. OpenClaw 自动填写网页表单卡点到底在哪OpenClaw 是一个浏览器自动化工具核心能力是模拟人在浏览器里的点击、输入、滚动、提交等操作。你可以把它理解成一个不知疲倦的助手你告诉它“点这个按钮”“在那个输入框里填这串文字”它就一丝不苟地执行。所以从原理上讲让它自动填写网页表单完全可行甚至可以说是它最典型的应用场景之一。但很多人第一次接触 OpenClaw 时会有一个误解以为它像密码管理器那样能自动识别页面上所有输入框并智能填充。默认状态下它做不到这一点。OpenClaw 需要你明确告诉它第一步找哪个元素第二步填什么内容第三步点哪里提交。这个“教”的过程可以通过图形界面录制操作流程也可以直接写脚本指明每一步动作。那为什么还要聊模型接入和统一 Key 呢因为当表单填写不再是“固定几个字段填死值”而是需要根据上下文动态生成内容时——比如根据一段产品描述自动生成摘要填入表单、根据用户提问自动分类填入下拉框、根据历史数据自动补全备注字段——OpenClaw 就需要调用大模型来生成这些动态内容。这时候模型调用的稳定性和配置的简洁性就成了关键。我试过在 OpenClaw 里直接硬编码某个模型厂商的 API Key结果换一个模型就要改一次配置多个项目之间 Key 散落各处管理起来很头疼。后来换成 TaoToken 的统一 Key 通道所有模型调用走同一个入口config.toml 里只维护一份配置切换模型只需要改一个字段。这篇文章就围绕这个思路给你一份可复制的 config.toml 配置骨架加上字段说明和一次完整的表单填写验证动作。2. TaoToken 前置统一 Key 与 API 通道准备在动手改 config.toml 之前你需要先拿到一个可用的 API Key。TaoToken 的定位是统一模型调用通道你可以在它的控制台里创建 Key然后这个 Key 就能用于 OpenClaw 里所有需要调模型的地方。具体操作路径是这样的打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台。在控制台里找到 API Keys 管理页面创建一个新的 Key。创建时建议给 Key 起一个能区分用途的名字比如 “openclaw-form-fill”这样后面如果多个项目共用排查问题时能快速定位。创建完成后你会拿到一串以特定前缀开头的字符串这就是你的统一 Key。把它复制下来后面配置里要用。注意不要把它直接提交到公开的代码仓库里建议通过环境变量或者本地配置文件的方式注入。TaoToken 的 API 基础地址是 https://taotoken.net/api 这个地址在 config.toml 里会作为 base_url 使用。OpenClaw 通过这个地址发送模型调用请求TaoToken 负责路由到对应的模型服务。你不需要在 OpenClaw 里分别配置每个模型厂商的地址和 Key只需要指向 TaoToken 的 API 地址加上你的统一 Key就能调用多个模型。如果你还没有 Key可以先到控制台的 API Keys 页面创建一个https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建过程很快拿到 Key 之后就可以进入下一步配置了。3. 可复制配置config.toml 配置骨架与字段说明OpenClaw 的配置文件通常放在项目根目录或者用户配置目录下文件名是 config.toml。下面这份骨架是我在实际项目里用过的结构你可以直接复制过去把其中需要替换的字段改成你自己的值。# OpenClaw 主配置 [openclaw] name form-fill-agent headless false timeout 30000 # 浏览器配置 [browser] type chromium viewport_width 1440 viewport_height 900 user_agent Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 # 模型调用统一通道 [llm] provider taotoken base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model claude-sonnet-4-20250514 max_tokens 2048 temperature 0.3 # 表单填写任务配置 [form_fill] target_url https://example.com/form wait_after_load 2000 retry_times 3 retry_interval 1500 # 字段映射网页表单字段 - 数据来源 [form_fill.fields] name { selector #name, source static, value 张三 } email { selector #email, source static, value zhangsanexample.com } summary { selector #summary, source llm, prompt 根据以下产品描述生成一段50字以内的摘要{{product_desc}} } category { selector #category, source llm, prompt 将以下问题分类到咨询/投诉/建议三个类别之一只输出类别名{{user_question}} }这份配置里几个关键字段需要说明一下。[llm]段是模型调用的核心配置。provider固定写taotoken表示走统一通道。base_url填 TaoToken 的 API 地址。api_key这里用了环境变量引用${TAOTOKEN_API_KEY}这样你不需要把 Key 明文写在配置文件里运行时通过环境变量注入即可。model字段填你要调用的模型标识TaoToken 支持多个模型你可以根据任务复杂度选择。temperature控制生成内容的随机性表单填写场景建议设低一些比如 0.3保证输出稳定。[form_fill.fields]段定义了每个表单字段的填充策略。selector是 CSS 选择器指向网页上对应的输入框。source有三种取值static表示填固定值llm表示调用模型动态生成excel表示从表格读取这个后面可以扩展。当source llm时prompt字段就是发给模型的提示词里面可以用{{变量名}}引用运行时传入的数据。这里有个细节要注意prompt里引用的变量需要在 OpenClaw 执行任务时通过上下文传入。比如{{product_desc}}这个变量你需要在调用 OpenClaw 的脚本里提前准备好或者从环境变量、外部文件读取后注入。4. 验证请求一次完整的表单填写动作配置写好了接下来要验证 OpenClaw 能不能真的完成一次表单填写。我建议先用一个简单的测试页面来跑通流程确认模型调用和字段填充都正常再切换到真实的目标网站。第一步准备一个本地测试页面。新建一个test-form.html文件内容如下!DOCTYPE html html headmeta charsetutf-8title测试表单/title/head body form label姓名input typetext idname/labelbr label邮箱input typeemail idemail/labelbr label摘要textarea idsummary/textarea/labelbr label类别select idcategory option value请选择/option option value咨询咨询/option option value投诉投诉/option option value建议建议/option /select/labelbr button typesubmit提交/button /form /body /html第二步写一个 OpenClaw 执行脚本。假设你把 OpenClaw 安装在项目目录下可以创建一个run_fill.pyimport os from openclaw import OpenClaw os.environ[TAOTOKEN_API_KEY] 你的统一Key agent OpenClaw(config_path./config.toml) context { product_desc: 这是一款支持多模型统一调用的 API 网关服务提供稳定的模型接入通道。, user_question: 我想反馈一下最近使用中遇到的一个小问题 } result agent.run_form_fill( target_urlfile:///path/to/test-form.html, contextcontext ) print(填写结果, result)第三步运行脚本。在终端里执行python run_fill.py如果一切正常你会看到 OpenClaw 启动浏览器打开测试页面依次填入姓名、邮箱然后调用模型生成摘要和类别最后把生成的内容填进对应字段。终端会输出填写结果包含每个字段实际填入的值。实测下来从启动到填写完成大概需要 5 到 8 秒其中模型调用占了大头。如果你把headless设为true浏览器不会显示出来速度会稍快一些但调试阶段建议保持false方便观察每一步动作。验证成功的标志是姓名和邮箱填入了固定值摘要字段填入了模型生成的简短描述类别字段填入了模型判断的类别名。如果某个字段为空或者报错就进入下一节的排查环节。5. 本篇常见错排查配置和验证过程中最容易遇到的几个问题我列在下面你可以对照排查。问题一模型调用返回 401 或 403这通常是 API Key 的问题。先检查config.toml里api_key字段引用的环境变量是否真的被设置了。你可以在终端里执行echo $TAOTOKEN_API_KEY确认。如果环境变量为空说明注入没成功。另外检查 Key 是否被误删或者过期可以到控制台的 API Keys 页面确认 Key 的状态。问题二表单字段填不进去selector 找不到元素最常见的原因是页面还没加载完OpenClaw 就开始找元素了。解决办法是调大wait_after_load的值比如从 2000 改成 4000。如果目标页面是动态渲染的可能需要用更精确的等待条件比如等待某个元素出现再执行。另外检查 selector 是否写对了可以在浏览器开发者工具里用document.querySelector验证一下。问题三模型生成的内容格式不对填进下拉框失败下拉框的填充和普通输入框不一样需要先点击下拉框再选择对应选项。如果你的category字段是select元素OpenClaw 需要知道你是要选值而不是输入文本。可以在字段配置里加一个action select参数告诉 OpenClaw 用选择的方式处理。另外模型输出的类别名必须和下拉框里的选项文本完全一致否则选不中。可以在 prompt 里明确要求“只输出类别名不要加任何其他文字”。问题四多个字段都调模型速度太慢如果表单里有五六个字段都需要模型生成串行调用会等很久。可以考虑把多个字段的生成合并成一次模型调用让模型返回一个 JSON里面包含所有需要生成的字段值。然后在 OpenClaw 脚本里解析 JSON分别填入对应字段。这样只需要一次模型请求速度会快很多。问题五提交后页面跳转OpenClaw 报错有些表单提交后会跳转到新页面如果 OpenClaw 还在等待原页面的某个元素就会超时。可以在提交动作后加一个等待跳转完成的逻辑或者把提交后的验证改成检查新页面的某个特征元素。6. 接入文档与后续操作入口配置骨架跑通之后你可以把它扩展到真实的业务表单上。核心思路是一样的先用 selector 定位字段再决定每个字段是填固定值还是调模型生成。区别只在于真实页面的元素结构可能更复杂需要多花点时间调试 selector 和等待逻辑。如果你在接入过程中遇到模型调用相关的报错比如返回格式异常、超时、限流等可以查阅 TaoToken 的接入文档里面有各模型的参数说明和错误码解释https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。文档里也包含了不同模型在结构化输出方面的差异对你设计 prompt 会有帮助。如果你只是想先验证某个模型能不能稳定生成表单需要的字段内容可以到模型对话页面直接测试 prompt 效果确认输出格式符合预期后再写进 config.tomlhttps://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。对于需要长期跑表单自动化任务、或者要把 OpenClaw 集成到更大 Agent 流程里的场景建议关注 Coding Plan 的额度方案避免频繁调用时遇到限流https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。表单填写这类任务的特点是调用频次高但单次 token 消耗不大选一个合适的额度档位能省不少事。最后提醒一点OpenClaw 的 config.toml 里[llm]段的model字段是可以随时切换的。你今天用某个模型跑通了表单填写明天想换一个模型对比效果只需要改这一个字段其他配置都不用动。这就是统一 Key 通道带来的便利——模型切换的成本被降到了最低。
