企业官网建设流程全解析

1. 为什么要在微信里跑 OpenClaw：ClawBot 插件解决的真实问题

OpenClaw 本身是个能力很强的本地 AI 运行环境，但它的交互入口一直偏「开发者向」——终端、Web 面板、或者飞书、Telegram 这类平台插件。问题在于，国内开发者日常最高频的沟通工具其实是微信，如果每次想让 AI 帮忙处理点事情都要切到另一个 App，使用频率自然就掉下来了。

ClawBot 是腾讯官方推出的 OpenClaw 微信插件，包名@tencent-weixin/openclaw-weixin-cli。它做的事情很直接：把 OpenClaw 的 AI 能力接进微信聊天窗口，扫码绑定之后，你在微信里发消息，背后跑的是你自己那套 OpenClaw 实例。适合谁？适合已经装好 OpenClaw、想把它变成随手可用的微信 AI 助手的开发者，尤其是做本地知识库问答、代码片段速查、日常文本处理这类场景的人。

不过这里有个容易被忽略的环节：OpenClaw 要调用大模型，就得配 Key。很多人卡在「插件装好了，消息发出去没反应」，八成是模型接入没配通。这篇我会用 TaoToken 的统一 Key 来打通模型层，再给出 ClawBot 的完整安装配置流程和一份可直接复制的settings.json骨架，让你一次跑通。

2. 前置准备：OpenClaw 版本、微信版本与 TaoToken 统一 Key

2.1 环境要求先对齐

ClawBot 对两端版本都有要求，版本不够会直接导致插件入口不出现或者绑定失败。微信端建议始终保持最新，插件页面显示的版本要求才是准的。OpenClaw 端先确认版本：

# 查看当前 OpenClaw 版本 openclaw --version # 升级到最新版 npx -y openclaw@latest

Node.js 建议 18.0 以上，低于这个版本安装命令可能直接报错退出。

2.2 为什么用 TaoToken 统一 Key

OpenClaw 支持多种模型供应商，但每个供应商一套 Key、一套 Base URL，配置起来很碎。TaoToken 提供的是统一接入层：一个 Key 走https://taotoken.net/api，模型名按需切换，省掉在多个控制台之间来回复制粘贴的麻烦。对 ClawBot 这种「配一次就想长期用」的场景，统一 Key 的价值在于——以后换模型只改一个字段，不用动插件配置。

先去控制台创建 Key：

# 控制台地址（创建 API Key） https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

创建完把 Key 存好，形如sk-xxxxxxxx。接入文档在这里，配置字段有疑问可以对照：

https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

注意：Key 只显示一次，建议创建后立刻写进配置文件或密码管理器，别留在聊天记录里。

3. 可复制配置：settings.json 骨架与 ClawBot 安装命令

3.1 settings.json 骨架

OpenClaw 的模型配置集中在settings.json。下面这份骨架把 TaoToken 作为统一 provider 接进去，你可以直接复制后替换 Key：

{ "providers": { "taotoken": { "type": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-替换成你自己的Key", "models": { "default": "claude-sonnet-4-5", "fast": "gpt-4o-mini" } } }, "defaultProvider": "taotoken", "plugins": { "openclaw-weixin": { "enabled": true, "workspace": "~/.openclaw/workspace" } } }

几个字段说明一下。type用openai-compatible是因为 TaoToken 的接口兼容 OpenAI 格式，大多数客户端不用改代码。baseUrl结尾不要带/v1，SDK 会自己拼。models.default是你日常对话用的主力模型，fast留给需要低延迟的短任务。plugins.openclaw-weixin.workspace指向工作区目录，ClawBot 出于合规和隐私保护，只能上传这个目录内的文件，路径别写错。

3.2 安装 ClawBot 插件

配置写好后装插件：

# 安装微信插件 npx -y @tencent-weixin/openclaw-weixin-cli@latest install # 查看已安装插件，确认 openclaw-weixin 在列表里 openclaw plugins list

安装完成后终端会输出一个二维码。打开手机微信，进入「我 → 设置 → 插件」，找到 ClawBot 入口，点「扫一扫」扫描终端二维码完成绑定。如果插件列表里没有 ClawBot 入口，说明账号还没被灰度覆盖，这种情况只能等放量，不是配置问题。

3.3 模型侧单独验证

在装插件之前，建议先确认 TaoToken 这条链路是通的，避免把模型问题和插件问题混在一起排查：

curl https://taotoken.net/api/chat/completions \ -H "Authorization: Bearer sk-替换成你自己的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "回复：链路正常"}] }'

返回里能看到choices[0].message.content就说明 Key 和 Base URL 都没问题。想先在网页里直观试一下模型效果，可以用模型对话页：

https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite

4. 验证请求：插件加载与微信消息收发测试

4.1 确认插件真的加载了

装完别急着发消息，先看插件状态：

# 查看插件详情与运行状态 openclaw plugins info openclaw-weixin # 查看 OpenClaw 运行日志，过滤插件相关输出 openclaw logs --follow | grep -i weixin

日志里出现插件初始化成功、provider 指向 taotoken 的记录，说明加载正常。如果日志里报 provider 找不到，回去检查settings.json的defaultProvider拼写。

4.2 微信端消息收发测试

绑定成功后，在微信里给 ClawBot 发一条测试消息，比如「你好，帮我总结一下这段话」。正常情况你会收到模型返回的文本。这里要提醒一个预期管理：微信插件目前不支持流式输出，所以回复是一次性整段出现的，不是逐字蹦出来，别以为是卡住了。

再测一条带上下文的：

帮我用 Python 写一个读取 CSV 并统计行数的函数

如果返回了代码块，说明模型调用和消息回传都通了。实测下来，首次响应会比后续慢一点，因为要建立会话上下文。

4.3 功能边界心里有数

微信插件和飞书、Telegram 插件相比有明确差异，提前知道能少踩坑。群聊不支持，只能单聊；流式输出不支持；文件传输有限制，只能传工作区内的文件；表格渲染体验一般。改名字支持，改头像不支持。这些是当前版本的状态，后续可能变，以官方公告为准。

5. 本篇常见错排查

5.1 微信里找不到 ClawBot 入口

最常见的原因就是没被灰度覆盖。插件处于逐步放量阶段，不是所有账号都能立刻看到入口。先确认微信已更新到最新版，然后等几天再看。如果急着用，可以联系腾讯官方了解内测资格。这不是你配置错了。

5.2 安装命令执行后没反应

先查 Node.js 版本：

node -v

低于 18.0 就升级。再确认 OpenClaw 本身装好了：

openclaw --version

两个都正常还卡住，试试清掉 npx 缓存重跑：

npx clear-npx-cache npx -y @tencent-weixin/openclaw-weixin-cli@latest install

5.3 扫码后提示绑定失败

检查微信版本是否达到插件页面要求的最低版本。再确认终端二维码完整显示、没有被终端换行截断。如果反复失败，重新执行一次安装命令生成新二维码再扫。

5.4 消息发出去没有回复

这个大概率是模型层没通。按第 3.3 节的 curl 先验证 TaoToken 链路，确认 Key 有效、Base URL 正确。然后检查settings.json里defaultProvider是否指向taotoken，apiKey有没有多余空格。日志里如果出现 401，就是 Key 问题；出现 404，多半是baseUrl写成了带/v1的地址。

5.5 文件上传失败

ClawBot 只能上传~/.openclaw/workspace工作区内的文件。把要传的文件先放进这个目录，再在微信里发送。路径写错或者文件在目录外，都会失败。

6. 长期使用建议与接入入口

如果你打算把 ClawBot 当成日常工具长期跑，建议把模型 Key 的管理和编码类任务分开考虑。日常对话用统一 Key 走 TaoToken 就够了；如果是长时间跑 Agent、批量代码生成这类消耗大的场景，可以看下 Coding Plan，额度模型更适合持续调用：

https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite

Key 的创建和管理都在控制台，接入字段有疑问对照文档：

# API Key 管理 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite # 接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

最后说个实际经验：settings.json改完一定要重启 OpenClaw 进程，热加载不一定生效，我见过好几次改完配置没重启、以为配置写错了的情况。另外 Key 别硬编码在会提交到 Git 的文件里，用环境变量或者单独的本地配置文件更稳妥。