1. 为什么要在 OpenClaw 龙虾里接 wechat-cli微信里的信息量一旦上来靠手指滑动基本等于放弃治疗。我自己加过十几个龙虾相关的群每天醒来未读 999真正有用的可能就三五条剩下的全是表情包和接龙。更麻烦的是微信收藏夹里存了一堆文章和聊天记录想找的时候翻半天翻不到等于没存。OpenClaw 龙虾这类 Agent 工具的价值就是把这些零散的本地数据变成可以对话查询的结构化信息。而 wechat-cli 是其中负责“读微信”的那一环——它只读不写操作的是本地微信数据不会往你的聊天记录里塞东西也不会替你发消息。适合谁用私域运营、社群管理员、做知识沉淀的内容创作者以及单纯想把群聊信息管明白的普通用户。这篇要交付的东西很具体一份可复制的 config.toml 与 settings.json 骨架、TaoToken 统一 Key 的接入步骤以及微信信息与收藏同步的验证动作。你照着配完就能在龙虾里直接问“这周谁发言最多”“收藏里最近存了什么”。2. TaoToken 前置统一 Key 与 API 通道在配 wechat-cli 之前先把模型通道理顺。OpenClaw 龙虾本身要调用大模型来理解你的自然语言指令如果你同时用多个工具每个都单独配 Key 会很乱。TaoToken 的作用就是提供一个统一的 API 入口一个 Key 走通对话、编码、Agent 场景。你需要先拿到 Key。访问控制台创建https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite创建后复制那串sk-开头的字符串后面配置里要用。API 基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接填在配置文件的 base_url 字段里。如果你用的是 Claude Code 或 Anthropic 风格的客户端接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite提示Key 只创建一次就够多个工具共用同一个 Key方便统一管理和排查问题。不要把 Key 提交到公开仓库。3. 可复制配置config.toml 与 settings.json 骨架wechat-cli 的安装命令在龙虾里可以直接发自然语言触发但配置骨架建议手动写清楚避免 Agent 猜错字段。先装 CLInpm install -g canghe_ai/wechat-cli装完后确认版本wechat-cli --version接下来是 OpenClaw 龙虾侧的 config.toml。这个文件通常放在~/.openclaw/config.toml如果没有就新建[model] provider taotoken base_url https://taotoken.net/api api_key sk-你的Key model_name claude-sonnet-4-20250514 timeout 60 [agent] name openclaw-lobster enable_tools true tool_whitelist [wechat-cli] [wechat] cli_path wechat-cli readonly true data_dir ~/Library/Containers/com.tencent.xinWeChat/Data几个关键点readonly true是硬性建议wechat-cli 本身只读但配置里写死能防止误操作data_dir在 macOS 下是微信容器目录Windows 下换成C:\Users\你的用户名\Documents\WeChat Files。然后是 settings.json这个文件控制 wechat-cli 自己的行为放在~/.wechat-cli/settings.json{ output_format: json, max_messages: 200, include_favorites: true, favorite_sync_interval: 300, stats: { enable_ranking: true, enable_type_distribution: true, enable_hourly_active: true }, filters: { exclude_system: true, min_text_length: 2 } }include_favorites打开后收藏夹内容会被纳入查询范围favorite_sync_interval单位是秒300 表示五分钟同步一次索引。stats里的三个开关对应发言排行、消息类型分布、24 小时活跃统计后面验证会用到。4. 验证请求确认配置生效配置写完先做一次最小验证确认龙虾能调通 wechat-cli 并且模型通道正常。在 OpenClaw 龙虾的对话窗口里发帮我查看与文件传输助手的最近 5 条信息如果返回的是 JSON 格式的聊天记录说明 CLI 和配置都通了。接着验证收藏微信收藏中最近收藏的 3 条内容正常会返回收藏的标题、类型和时间。再验证统计功能看看这周龙虾交流群里谁发言最多返回结果里应该包含发言排行格式类似{ group: 龙虾交流群, period: this_week, ranking: [ {user: 张三, count: 128}, {user: 李四, count: 96} ] }如果这三步都出结果说明 config.toml 的模型通道、settings.json 的统计开关、wechat-cli 的读取权限全部生效。想单独测模型对话是否走通 TaoToken可以打开模型对话页面发一句测试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite如果你打算长期跑编码或 Agent 任务建议了解 Coding Plan额度模型更适合高频调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite5. 本篇常见错排查配置过程中最容易卡在几个地方我按出现频率排一下。报错wechat-cli: command not foundnpm 全局路径没进 PATH。执行npm config get prefix看路径把它加到 shell 的 PATH 里或者直接用npx canghe_ai/wechat-cli代替。返回空数据或data_dir not found微信数据目录写错了。macOS 新版微信路径可能带版本号用ls ~/Library/Containers/ | grep -i wechat确认实际目录名。Windows 下注意WeChat Files和xwechat_files的区别。模型返回 401 或invalid api keyconfig.toml 里的api_key没填对或者 base_url 多写了斜杠。正确写法是https://taotoken.net/api不要加/v1或结尾斜杠。收藏内容查不到settings.json 里include_favorites是 false或者favorite_sync_interval设得太长还没同步。改成 true 并重启龙虾。统计结果里全是系统消息exclude_system没开。打开后系统提示、撤回通知会被过滤掉排行更干净。龙虾不调用 wechat-cli检查 config.toml 的tool_whitelist是否包含wechat-cli以及enable_tools是否为 true。有些版本需要显式声明工具白名单。注意wechat-cli 只读本地数据不会修改微信任何内容。如果某个命令提示写入权限说明你装到了非官方版本建议卸载后从官方 npm 源重装。6. 把微信信息变成可查询的知识资产配好之后真正的用法不是一条条翻记录而是把微信当成一个可以对话的数据库。比如你可以直接问“上周收藏里关于 RAG 的文章有哪些”或者“情绪识别群里讨论最多的三个话题是什么”。这些在龙虾里都是一句话的事。我自己的习惯是每天早上让龙虾跑一次未读摘要把群聊里超过 20 字的消息筛出来按发言人聚合。这样既不会漏掉有价值的内容也不用在几百条消息里手动捞。收藏夹则每周同步一次配合关键词检索慢慢就沉淀成了自己的知识库。如果你还没拿 Key从 API Keys 页面创建一个就行然后按上面的 config.toml 填进去。接入文档里有不同客户端的完整示例遇到字段不确定的时候对照一下https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewritehttps://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite配置这件事跑通一次后面就顺了。先把最小验证那三步走完确认数据能读出来再慢慢加统计和收藏的用法。