1. 为什么要在本地跑 OpenClaw 图形界面
OpenClaw 是一个能自己动手操作浏览器的 AI Agent 框架,你可以把它理解成一个「会自己点鼠标、敲键盘的助手」——它不只是聊天,而是真的能打开网页、读取页面内容、填表单、抓数据。ClawX 则是它的图形化外壳,把原本需要命令行配置的东西变成了可视化界面,对不熟悉终端操作的人友好很多。
这篇要跑通的场景很具体:装好 ClawX,接上一个大模型,让它自动打开腾讯文档、读取里面的周报数据,最后生成一份周报。整个过程涉及四个关键环节——ClawX 安装、模型接入、Chrome 扩展加载、腾讯文档读取。任何一个环节掉链子,任务都会卡住,所以我会把每一步的配置项和可能踩的坑都写清楚。
适合谁看:想用 AI 自动处理重复性网页操作的人,比如每周要从后台系统导数据、从在线文档汇总信息、定时抓取页面内容的场景。如果你只是想找个聊天机器人,这个方案偏重了;但如果你需要「AI 帮我操作浏览器」,OpenClaw + ClawX 是目前比较完整的开源路线。
核心检索词先明确:OpenClaw 图形化界面安装、ClawX 配置教程、腾讯文档自动读取周报。下面按安装到验证的顺序展开,每一步都给可复制的命令或配置。
2. 前置准备:TaoToken 接入与模型选型
OpenClaw 本身不绑定特定模型,它通过 OpenAI 兼容接口调用大模型。也就是说,只要你的模型服务提供标准的/v1/chat/completions接口,就能接进来。这里我用 TaoToken 作为统一接入层,原因是它把多个模型的调用方式统一成一套 Base URL + Key + Model ID 的组合,切换模型时不用改代码,只改配置。
先拿 Key。打开 https://taotoken.net/api-keys ,登录后创建一个 API Key,复制保存。注意这个 Key 只在创建时完整显示一次,关掉页面就看不到了,建议先存到本地文本里。
Base URL 用https://taotoken.net/api,不要加多余的路径。Model ID 根据你要用的模型填,比如doubao-seed-2-0-pro-260215这类具体版本号。如果你不确定有哪些模型可用,可以打开 https://taotoken.net/models 看列表,或者在 https://taotoken.net/chat 里直接试对话,确认模型能正常响应再往 ClawX 里填。
这里有个容易混淆的点:豆包官方的 API Key 和 TaoToken 的 Key 不是一回事。官方控制台拿到的 Key 只能调火山引擎自己的接口,而 TaoToken 的 Key 走的是统一网关。两者都能用,但配置时的 Base URL 不同。如果你之前按官方文档配过,记得把 Base URL 换成 TaoToken 的地址,否则会报 401 或连接超时。
模型选型上,周报生成这种任务对推理能力要求中等,但对稳定性和上下文长度有要求——因为要读取腾讯文档的整页内容,token 消耗不小。实测下来,豆包系列在中文文档理解上表现稳定,适合这类场景。如果你有长期编码或 Agent 需求,可以考虑 Coding Plan,额度更充裕,具体在 https://taotoken.net/coding-plan 看。
注意:免费额度用完后服务会停止,这是正常现象。周报任务如果文档内容长,一次执行可能消耗几万 token,建议先在小文档上测试,确认流程跑通再换正式数据。
3. ClawX 安装与模型配置实操
ClawX 的安装包从官网下载,默认是 Windows 的 exe。下载后双击安装,路径建议不要放在 C 盘根目录,避免权限问题。我装在D:\soft\ClawX,后面 Chrome 扩展的路径也基于这个目录。
安装完成后首次启动,界面会引导你添加 AI 提供商。这里填三样东西:
Base URL:https://taotoken.net/apiAPI Key:你刚才创建的 Key Model ID:doubao-seed-2-0-pro-260215(或你实际要用的模型)
配置写进 ClawX 的 settings 文件里,格式是 JSON。如果你要手动改配置文件,路径通常在D:\soft\ClawX\resources\openclaw\config\settings.json,内容结构如下:
{ "providers": [ { "name": "taotoken", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "models": [ { "id": "doubao-seed-2-0-pro-260215", "name": "Doubao Seed 2.0 Pro" } ] } ], "defaultModel": "doubao-seed-2-0-pro-260215" }保存后重启 ClawX,在界面里新建一个对话,输入「你好,确认一下模型是否正常响应」。如果返回内容正常,说明模型接入成功。如果报错,先检查 Base URL 有没有多写斜杠、Key 有没有复制完整、Model ID 是否和平台列表一致。
接下来是 Chrome 扩展。OpenClaw 操作浏览器靠的是一个叫 OpenClaw Browser Relay 的扩展,它负责在 ClawX 和 Chrome 之间传递指令。扩展文件在 ClawX 安装目录下:D:\soft\ClawX\resources\openclaw\assets\chrome-extension。
打开 Chrome,地址栏输入chrome://extensions,右上角开启「开发者模式」,点「加载已解压的扩展程序」,选中上面那个文件夹。加载成功后,扩展列表里会出现 OpenClaw Browser Relay。
扩展需要填一个OPENCLAW_GATEWAY_TOKEN。这个 token 不用去别处找,直接在 ClawX 里新建对话,问它「你的 gateway token 是多少」,它会返回一串字符,复制填进扩展的设置页即可。
三件套确认:Base URL、API Key、Model ID 都填对,扩展 token 也填好,这时候 ClawX 才具备操作浏览器的能力。
4. 读取腾讯文档并生成周报的验证请求
配置完成后,先做一次最小验证:让 ClawX 打开一个腾讯文档页面,读取内容并输出摘要。这一步能确认浏览器扩展、模型调用、页面读取三个环节都通了。
在 ClawX 新建对话,输入类似这样的指令:
打开这个腾讯文档链接,读取里面的内容,然后告诉我文档标题和第一段文字。 链接:https://docs.qq.com/doc/你的文档ID正常情况下,你会看到 Chrome 自动打开一个新标签页,加载腾讯文档,然后 ClawX 返回读取到的内容。如果文档需要登录才能查看,Chrome 里得先登录腾讯文档账号,否则读到的是登录页而不是正文。
验证通过后,再建定时任务。在 ClawX 的任务界面新建一个任务,指令写:
读取腾讯文档中的本周工作记录,整理成周报格式,包含本周完成事项、进行中事项、下周计划三部分。执行一次,观察流程。实测下来,整个读取加生成大概需要几分钟,取决于文档长度和模型响应速度。如果文档内容多,token 消耗会明显上升,这也是为什么前面建议先用小文档测试。
成功的结果是:Chrome 自动打开文档,页面滚动读取,ClawX 输出结构化的周报文本。你可以把这段文本复制出来,或者让 ClawX 继续执行发送邮件的动作(需要额外配置邮件服务)。
如果任务执行失败,提示要安装 Chrome 插件,说明扩展没加载成功或者 token 没填。回到chrome://extensions确认扩展是启用状态,再检查 token 是否和 ClawX 返回的一致。
5. 常见报错排查:401、local proxy failed、reading choices
这一节列几个实际会撞上的错误,以及对应的处理方式。
401 Unauthorized:最常见的原因是 API Key 填错或过期。检查 Key 有没有多余空格,Base URL 是不是https://taotoken.net/api。如果 Key 是从官方控制台拿的,而 Base URL 填的是 TaoToken 地址,也会 401,因为两边不匹配。解决方法是统一用 TaoToken 的 Key 和 Base URL。
local proxy failed:这个报错通常出现在 ClawX 尝试连接模型服务时。原因可能是本地网络无法访问 Base URL,或者 ClawX 的代理配置有问题。先确认浏览器能打开 https://taotoken.net ,如果浏览器能开但 ClawX 报错,检查 ClawX 设置里有没有开系统代理。另外,某些安全软件会拦截本地程序的网络请求,临时关闭试试。
reading choices 报错:这个错误说明模型返回的数据结构不符合预期,通常是 Model ID 填错了,或者模型不支持当前调用方式。确认 Model ID 和平台列表完全一致,包括版本号后缀。如果用的是对话模型但接口按补全方式调用,也会出这个错。
OAuth 相关报错:如果 ClawX 在读取腾讯文档时提示授权失败,检查 Chrome 里是否已登录腾讯文档。OpenClaw 读取的是浏览器当前会话的页面,如果没登录,读到的是登录页,后续解析自然失败。先在 Chrome 手动打开文档确认能正常查看,再让 ClawX 执行任务。
扩展加载失败:chrome://extensions里如果扩展显示红色错误,点「错误」看详情。常见原因是扩展文件夹路径不对,或者 Chrome 版本太旧不支持 Manifest V3。确认路径是D:\soft\ClawX\resources\openclaw\assets\chrome-extension,里面应该有manifest.json文件。
token 用完服务停止:这是额度问题,不是配置错误。免费额度消耗完后需要充值或换其他模型。如果你有长期需求,Coding Plan 的额度更适合持续跑任务,具体在 https://taotoken.net/coding-plan 看。
排查顺序建议:先确认模型能单独调通(用模型对话页面测试),再确认扩展加载成功,最后跑完整任务。这样能把问题定位到具体环节,不用来回猜。
6. 跑通之后:把周报任务变成固定流程
流程跑通后,你可以把周报任务设成定时执行。ClawX 支持定时任务,设置每周五下午执行一次,它会自动打开腾讯文档、读取内容、生成周报。如果需要发送到邮箱,还得额外配置 SMTP 或者用其他方式转发。
几个实用建议:文档链接尽量用固定链接,不要用会过期的分享链接;如果文档内容经常变,可以在指令里加上「只读取本周新增内容」之类的限定,减少 token 消耗;模型响应慢的时候,任务执行时间会拉长,设定时任务时留足余量。
接入文档和更多配置细节在 https://taotoken.net/doc 可以查到。如果你要换模型,只需要改 Model ID,Base URL 和 Key 不用动,这是统一接入层的好处。模型对话测试在 https://taotoken.net/chat ,API Key 管理在 https://taotoken.net/api-keys ,长期跑 Agent 任务的话 Coding Plan 在 https://taotoken.net/coding-plan 。
最后说一个实际经验:周报这类任务,模型生成的初稿通常需要人工过一遍,尤其是数据类内容。把它当成「帮你把文档读出来、整理成框架」的工具,而不是完全替代人工,这样用起来最顺手。