ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

用 wx-cli + Claude Skill 搭本地总结器:TaoToken 统一 Key 配置与验证

2026/9/25 14:08:06 拓冰建站 浏览量
用 wx-cli + Claude Skill 搭本地总结器:TaoToken 统一 Key 配置与验证 1. 手动翻群 40 分钟到底卡在哪先说结论微信群聊总结这件事真正耗时间的不是总结而是翻。我统计过自己一周的操作——打开微信、点进 8 个群、往上滚、跳过表情包和收到、把散落在几百条消息里的决策和待办挑出来、复制到备忘录、再整理成能看的格式。这一套下来单个活跃群 5 分钟起步8 个群就是 40 分钟而且每天都要重来一遍。更麻烦的是信息形态。群聊里的关键内容往往藏在对话流中间一句下午 3 点灰度夹在十几条闲聊里一个待办是王哥你那个脚本好了吗这种口语化提问。人眼扫一遍容易漏扫两遍又太费时间。市面上的 AI 总结工具我也试过几个功能看着不错但有个绕不开的问题——你的聊天记录得先传到对方服务器AI 才能处理。对普通闲聊无所谓但团队群里经常有产品细节、客户信息、内部决策这些东西上传到第三方存多久、用来干什么你根本不知道。所以这篇要解决的就是用 wx-cli 在本地把群聊记录导出来用 Claude Skill 编排总结流程再通过 TaoToken 统一 Key 接入模型通道整条链路跑在你自己的电脑上。目标很明确——把每天手动翻群的 40 分钟压到 5 分钟以内。适合谁每天要盯多个工作群、又对数据流向有顾虑的开发者、产品、运营。下面从环境准备到端到端验证一步步来。2. TaoToken 前置统一 Key 与通道准备在动手写配置之前先把模型通道这块理清楚。这套方案里wx-cli 负责取数据Claude Skill 负责编排流程而真正调用模型做总结的那一步需要一个稳定的 API 通道。TaoToken 在这里的角色就是统一 Key 和统一入口——你不用为每个工具单独配一套密钥一个 Key 走通对话、编码、Agent 各类场景。为什么强调统一因为本地总结器往往不止一个调用点Claude Code 里跑 Skill 要调模型你可能还想在脚本里加个自动摘要或者用 Coding Plan 做长期编码任务。如果每个地方都配一套 Key管理成本高换 Key 的时候还得逐个改。TaoToken 把这些收敛到一个入口配置一次多处复用。具体要准备的东西一个 TaoToken 账号登录后进控制台创建 API Key记下 API 地址https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base_url 用确认你要用的模型名比如 Claude 系列、GPT 系列按控制台里列出的可用模型填创建 Key 的入口在控制台的 API Keys 页面生成后只显示一次复制下来存到本地密码管理器或者环境变量里别直接写进会提交到 Git 的配置文件。这一步很多人踩坑Key 写进settings.json然后不小心 push 上去只能作废重建。注意TaoToken 是合规的 API 聚合通道配置时只填官方给的https://taotoken.net/api作为 base_url不要自行拼接或改动路径。拿到 Key 之后先别急着配 Claude Code用一条 curl 确认通道是通的能省掉后面一半的排障时间。这个验证动作放在第 4 节先把配置骨架搭好。3. 可复制配置settings.json / config.toml / CC Switch这一节是全文的核心直接给可复制的骨架。分三块Claude Code 的settings.json、通用工具的config.toml、以及 CC Switch 的多配置切换示例。3.1 Claude Code 的 settings.json 骨架Claude Code 读取配置的位置通常在用户目录下的.claude/settings.json。如果你要用 TaoToken 作为模型通道核心是配好env段里的 base_url 和 API Key。骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read, Bash(wx:*), Bash(cat:*) ] } }几个关键点解释一下。ANTHROPIC_BASE_URL填 TaoToken 的 API 地址这样 Claude Code 的请求就走统一通道而不是默认的官方端点。ANTHROPIC_AUTH_TOKEN填你刚创建的 Key。ANTHROPIC_MODEL按控制台里可用的模型名填写错模型名会直接报 404 或 model not found。permissions.allow这块是给 Skill 用的——总结器需要读本地文件Read、执行 wx-cli 命令Bash(wx:*)、读导出内容Bash(cat:*)。把权限收窄到具体命令前缀比直接放开所有 Bash 安全得多。如果你不想把 Key 明文写进文件可以用环境变量引用{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: ${TAOTOKEN_API_KEY}, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }然后在 shell 的~/.zshrc或~/.bashrc里export TAOTOKEN_API_KEYsk-...。这样配置文件可以安全地进版本库。3.2 config.toml 骨架通用工具用有些工具比如某些 CLI 客户端、脚本框架习惯用 TOML 配置。给你一份通用骨架字段名按你实际用的工具调整[provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 timeout 120 [summarizer] input_dir ~/wechat-summaries output_dir ~/wechat-summaries/digest max_tokens 2048 language zhtimeout建议给到 120 秒群聊记录长的时候模型处理需要时间默认 30 秒容易超时。input_dir和output_dir对应后面脚本的导出和摘要目录。3.3 CC Switch 多配置切换示例如果你同时用多个通道比如一个 TaoToken 通道跑总结另一个跑别的任务手动改settings.json太麻烦。CC Switch 这类配置切换工具可以帮你管理多套配置。它的配置通常长这样{ profiles: [ { name: taotoken-summary, settings: { env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } } }, { name: taotoken-coding, settings: { env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } } } ], active: taotoken-summary }切换的时候改active字段或者用 CC Switch 的命令行直接切。这样总结任务和编码任务用不同的模型或参数互不干扰。长期跑编码和 Agent 任务的话可以考虑用 Coding Plan 那套配置把额度用在刀刃上。3.4 wx-cli 与 Skill 的目录约定配置里涉及的路径统一约定一下后面脚本直接复用# 导出目录 mkdir -p ~/wechat-summaries/raw # 摘要输出目录 mkdir -p ~/wechat-summaries/digest # Skill 目录 mkdir -p ~/.claude/skills/wechat-summarizerwx-cli 的安装和导出命令沿用你熟悉的方式导出到~/wechat-summaries/raw/下按群名和日期命名。Skill 文件放在~/.claude/skills/wechat-summarizer/SKILL.md注意路径大小写Claude Code 对目录名敏感。4. 端到端验证一次请求跑通全链路配置写完必须做一次端到端验证确认取数据 → 编排 → 调模型 → 出摘要整条链路是通的。分四步。4.1 验证 TaoToken 通道先用 curl 打一发确认 Key 和 base_url 没问题curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 只回复两个字通了}] }返回里能看到content字段带通了两个字说明通道正常。如果返回 401检查 Key返回 404检查模型名返回超时检查网络到taotoken.net的连通性。4.2 验证 wx-cli 导出确认微信在运行状态然后导出目标群wx export 项目周例会群 --format markdown -o ~/wechat-summaries/raw/项目周例会群-$(date %Y%m%d).md打开导出的文件应该能看到类似这样的结构[2026-05-15 09:23] 张工今天的发布计划确认了吗 [2026-05-15 09:25] 李姐确认了下午 3 点灰度晚上 8 点全量 [2026-05-15 09:26] 王哥测试环境没问题回归测试今早已跑完 [2026-05-15 09:30] 张工好3 点前大家准备好回滚脚本文件在本地没有任何上传动作。这一步通了数据源就有了。4.3 验证 Skill 被加载启动 Claude Codeclaude进入交互界面后输入/看已加载的 Skill 列表里有没有wechat-summarizer。没有的话检查~/.claude/skills/wechat-summarizer/SKILL.md路径和文件名注意SKILL.md必须大写。4.4 跑一次完整总结在 Claude Code 里执行/wechat-summary ~/wechat-summaries/raw/项目周例会群-20260515.md或者直接说帮我总结这个群聊记录用结构化格式输出。预期输出## 群聊摘要项目周例会群 2026-05-15 ### 核心决策 - 今日发布计划确认下午 3 点灰度晚上 8 点全量 — 由李姐确认 ### 待办事项 - [ ] 准备回滚脚本 — 负责人所有人截止下午 3 点前 ### 未解决问题 - 本段记录中无未解决问题 ### 重要信息 - 测试环境回归测试已完成张工确认从导出到出摘要实测下来 30 秒到 1 分钟。500 条以上的长记录可能到 2 分钟但比手动翻 40 分钟已经不是一个量级。这一步跑通整条链路就闭环了。5. 本篇常见错排查配置和验证过程中几个高频报错集中说一下都是我自己踩过的。报错一401 Unauthorized或invalid api key九成是 Key 的问题。检查三处Key 有没有复制完整前后有没有多余空格、settings.json里有没有被环境变量覆盖、Key 是不是已经作废。TaoToken 控制台里可以重新生成生成后立刻更新配置。报错二404 model not found模型名写错了。ANTHROPIC_MODEL必须和控制台里列出的可用模型名完全一致大小写、版本号后缀都不能差。不确定的话先用 curl 那一步试出正确的模型名再填进配置。报错三wx: command not found或导出报无法连接到 WeChat 进程前者是 wx-cli 没装好重新npm install -g对应包。后者是微信没运行或者微信版本太老。wx-cli 依赖读取运行中的微信进程来获取解密密钥微信必须处于登录状态。macOS 首次运行如果弹开发者无法验证做一次 ad-hoc 签名即可。报错四Skill 没被识别输入/看不到路径问题。必须是~/.claude/skills/skill-name/SKILL.md目录名和文件名都要对SKILL.md大写。改完不用重启 Claude Code重新输入/就能看到。报错五总结结果里出现[引用消息]、[文件]这类占位符这是 wx-cli 对特殊消息格式引用、文件分享、小程序卡片的占位处理不是 bug。对总结影响不大Skill 里可以加一条约束让模型跳过这些无内容占位符。如果占位符特别多检查一下是不是导出的群消息里这类格式占比过高。报错六请求超时群聊记录太长或者timeout设太短。把config.toml里的timeout提到 120 秒或者分批导出比如按天切分再总结。另外确认到taotoken.net的网络是通的本地防火墙没拦。6. 把 40 分钟压到 5 分钟收尾与通道选择整套方案跑通之后日常操作就变成早上打开电脑wx-cli 已经把各群记录导出到本地Claude Code 里一条指令出摘要5 分钟内搞定一天的群信息归总。数据全程在本地流转模型调用走 TaoToken 统一通道Key 配一次多处复用。几个实用建议。第一把导出脚本加到 crontab工作日早上自动跑你到工位时原始记录已经就位。第二Skill 里的输出格式按你的习惯调比如加上我 的消息单独列一段这样不会漏掉直接找你的内容。第三Key 用环境变量管理别写死在配置文件里。通道这块按场景分流日常总结和对话验证用模型对话入口快速试长期跑编码和 Agent 任务用 Coding Plan 更划算接入和排障过程中要查 Key 和文档直接进 API Keys 和接入文档。配置里所有 base_url 统一填https://taotoken.net/api不要自己改路径。最后说个我自己的习惯每周五花 10 分钟把这一周的摘要归档到~/wechat-summaries/digest/按周建目录。月底回看的时候哪些决策落地了、哪些待办一直没动一目了然。这比翻聊天记录靠谱多了。