1. 为什么微信文章链接丢给 AI 总是读不出正文你大概遇到过这种场景把一条mp.weixin.qq.com的文章链接发给 AI让它帮忙总结结果它回你一句“继续滑动看下一个”或者干脆说抓不到内容。这不是模型笨而是微信文章的正文压根不在初始 HTML 里。普通网页抓取工具拿到的是 HTML 骨架微信文章的正文由 JavaScript 动态请求接口后再插入 DOM同时请求还要带上有效的wap_sid2Cookie请求头也得像真实浏览器。三层机制叠在一起纯接口抓取基本没戏。所以wechat-article-viewer这个 Skill 的思路很直接不跟接口硬碰改用真实浏览器渲染页面等 DOM 里出现.rich_media_content再提取。这篇要拆的是这个 Skill 在 OpenClaw 里的配置落地重点不是讲它多巧妙而是把目录结构、入口声明、config.toml骨架一项项写清楚并且用 TaoToken 统一 Key 和 API 通道让本地能真正跑通、能验证调用链路。适合已经在用 OpenClaw、想接一个真实 Skill 练手的人也适合想搞明白 Skill 配置到底长什么样的新手。2. 前置准备TaoToken 的 Key 与通道怎么接在动config.toml之前先把 Key 和 API 通道准备好。TaoToken 在这里扮演的角色是统一入口Skill 里需要调用模型能力时不用到处散落各家 Key而是走同一个 API 地址和同一把 Key。先去控制台创建 API Key地址是https://taotoken.net/api-keys登录后新建一个复制出来保存好。API 基础地址用https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base_url 填进配置。如果你还没注册从官网进就行https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。注册完顺手把 Key 建了后面配置里要用。这里有个容易踩的点很多人把 Key 直接写死在SKILL.md或者脚本里结果一提交就泄露。正确做法是 Key 只出现在config.toml或环境变量里Skill 脚本通过读取配置拿到不硬编码。下面第三节的骨架就是按这个原则写的。3. 可复制配置wechat-article-viewer 的 config.toml 骨架先把目录结构摆出来OpenClaw 加载 Skill 时是按目录识别的结构错了后面全白搭。wechat-article-viewer/ ├── SKILL.md # 入口声明与触发条件 ├── config.toml # 本篇重点Key 与通道配置 ├── scripts/ │ ├── check_browser.js # 浏览器连接分层诊断 │ └── fetch_article.js # 主执行逻辑 └── references/ └── browser_setup.md # 浏览器启动说明SKILL.md的入口声明负责告诉 OpenClaw 什么时候该加载这个 Skillfrontmatter 里写清楚name和description并且一定要有NOT for防止用户丢个知乎链接也触发它。--- name: wechat-article-viewer description: 微信公众号文章完整阅读器。 Use when: 用户提供 mp.weixin.qq.com 链接需要阅读或总结文章内容。 NOT for: 非微信链接的普通网页、需要登录的付费文章。 ---接下来是核心的config.toml骨架。这里把 TaoToken 的 API 地址和 Key 集中管理脚本只读配置不碰明文。# config.toml —— wechat-article-viewer 的通道配置 [provider] # TaoToken 统一 API 通道不带任何查询参数 base_url https://taotoken.net/api # Key 从环境变量读取避免明文入库 api_key_env TAOTOKEN_API_KEY # 默认走对话模型用于文章总结 default_model claude-sonnet [skill] name wechat-article-viewer enabled true # 触发关键词命中才加载完整逻辑 trigger_domains [mp.weixin.qq.com] [browser] # 调试端口与启动命令保持一致 debug_port 9222 # 等待正文元素出现的最长时间毫秒 render_timeout 15000 content_selector .rich_media_content [output] # 结构化输出开关 structured true include_source_url true配置里几个参数值得单独说。api_key_env指向环境变量名而不是 Key 本身这样config.toml可以安全地放进版本库。render_timeout给 15 秒是实测下来比较稳的值微信文章正文加载偶尔慢给太短会误判失败。content_selector就是那个关键选择器等它出现才说明渲染完成。环境变量在启动 OpenClaw 前设置好export TAOTOKEN_API_KEY你的KeyWindows 下用set TAOTOKEN_API_KEY你的Key或者写进系统环境变量。设完可以用echo $TAOTOKEN_API_KEY确认一下有没有生效。4. 验证请求跑通一次真实抓取并确认链路配置写完不算完得真跑一次。先启动带调试端口的 ChromemacOS 下命令是这样/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \ --remote-debugging-port9222 \ --user-data-dir/tmp/chrome-debug-profile启动后浏览器里先登录一次微信网页版让 Cookie 落地。这一步很多人跳过结果脚本一直报“未登录”。然后写一个最小验证脚本确认 TaoToken 通道和浏览器两条链路都通// scripts/verify.js import { readFileSync } from fs; import { parse } from toml; const config parse(readFileSync(./config.toml, utf-8)); const apiKey process.env[config.provider.api_key_env]; // 1. 验证 TaoToken 通道 async function verifyProvider() { const res await fetch(${config.provider.base_url}/v1/models, { headers: { Authorization: Bearer ${apiKey} }, }); if (!res.ok) throw new Error(通道异常: ${res.status}); console.log(TaoToken 通道正常); } // 2. 验证浏览器调试端口 async function verifyBrowser() { const res await fetch(http://localhost:${config.browser.debug_port}/json/version); if (!res.ok) throw new Error(浏览器调试端口未就绪); console.log(浏览器调试端口正常); } await verifyProvider(); await verifyBrowser();跑node scripts/verify.js两条都打印正常说明 Key、通道、浏览器环境都就位了。接着用真实链接跑主流程// scripts/fetch_article.js 核心片段 export default async function run(url) { if (!url.includes(mp.weixin.qq.com)) { return { success: false, message: 请提供有效的微信公众号文章链接 }; } const browser await connectToBrowser(9222); const page await browser.newPage(); await page.goto(url, { waitUntil: networkidle2 }); await page.waitForSelector(.rich_media_content, { timeout: 15000 }); const article await page.evaluate(() ({ title: document.querySelector(.rich_media_title)?.innerText, author: document.querySelector(.profile_nickname)?.innerText, content: document.querySelector(.rich_media_content)?.innerText, })); return { success: true, data: article }; }成功时你会拿到标题、作者、正文三段结构化数据正文不再是“继续滑动看下一个”。到这一步Skill 加载和调用链路就算真正跑通了。5. 本篇常见错排查报错一ECONNREFUSED localhost:9222。说明 Chrome 没带调试端口启动或者端口被别的进程占了。先lsof -i :9222看占用没有就按第 4 节的命令重新启动。注意--user-data-dir要指向一个独立目录别用默认配置目录否则调试端口可能起不来。报错二waitForSelector超时。正文元素一直没出现通常是没登录微信网页版Cookie 缺失导致服务端返回的是提示页。在调试浏览器里手动打开https://wx.qq.com登录一次再重跑。如果登录了还超时把render_timeout调到 20000 试试。报错三TaoToken 返回 401。基本是TAOTOKEN_API_KEY没设或设错。确认环境变量名和config.toml里的api_key_env完全一致大小写敏感。Key 本身去https://taotoken.net/api-keys重新复制一次注意别带多余空格。报错四Skill 不触发。用户发了微信链接但 OpenClaw 没加载这个 Skill检查SKILL.md的 frontmatter 里trigger_domains是否包含mp.weixin.qq.com以及enabled是不是true。目录名和name字段不一致也会导致加载失败。报错五正文抓到了但全是乱码或空行。这是提取时没做分段处理。.rich_media_content的innerText会保留换行但连续空行需要自己压缩。在返回前加一句content.replace(/\n{3,}/g, \n\n)就能清爽很多。6. 把通道固定下来后面接别的 Skill 也省事这个 Skill 跑通之后你会发现真正值钱的不是抓取逻辑本身而是那套“Key 集中管理 通道统一”的配置方式。config.toml里provider那一段换个 Skill 照样能用改的只是skill和browser部分。如果你后面要接更多需要模型能力的 Skill或者想让 OpenClaw 长期跑编码、Agent 类任务可以看下 Coding Plan通道和 Key 复用同一套不用每个 Skill 重新配一遍https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。想先单独验证模型对话是否正常用模型对话页面发一条消息就行https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面把 base_url 和鉴权头写得很清楚照着填不会错。最后留一个我踩过的坑config.toml改完记得重启 OpenClaw它不会热加载配置。有次我改完render_timeout死活不生效折腾半天才发现是没重启。