☰
openclaw接入微信:变形二维码:)——用 PowerShell 生成可扫的 TaoToken 配置骨架
2026/9/27 19:04:43 网站建设 项目流程

1. openclaw 接入微信时二维码为什么会变形

你在 PowerShell 里跑完 openclaw 的安装命令,终端最后吐出一个二维码,满心期待地拿微信去扫,结果扫了半天没反应。仔细一看,那个二维码根本不是正方形,字符被拉得又扁又宽,像被横向拉伸过一样。这不是 openclaw 的 bug,也不是微信的问题,而是 PowerShell 终端字体在“捣鬼”。

openclaw 接入微信的流程本身不复杂:升级微信到较新版本,进入设置里的插件入口,然后在终端运行 clawbot 的安装命令,最后用微信扫码确认。问题就卡在“扫码确认”这一步——终端里显示的二维码是用扩展 ASCII 字符拼接出来的,不同字体对这些字符的宽度解释不一样。如果字体不是等宽且字符宽高比接近 1:1,二维码就会被拉伸变形,微信的识别算法自然读不出来。

我实测下来,Windows 10 简体中文环境下,PowerShell 默认用的是“新宋体”,这个字体在显示二维码字符块时宽高比不对,导致二维码变成扁的。换成“MS Gothic”之后,字符宽高比恢复正常,二维码立刻就能扫了。所以这篇内容会从字体调整、二维码重新生成、TaoToken 配置骨架三个角度,帮你一次跑通 openclaw 接入微信的完整流程。

适合谁看:正在用 openclaw 做微信接入、被终端二维码变形卡住、想用 PowerShell 快速生成可扫配置骨架的开发者。下面直接进入操作。

2. TaoToken 前置准备:统一 Key 与配置骨架

在解决二维码问题之前,先把 TaoToken 的接入信息准备好。openclaw 接入微信后,后续的模型调用、coding plan、Agent 任务都需要一个统一的 API Key 来驱动。TaoToken 的作用就是把这些能力统一到一个 Key 上,你不需要为每个模型单独申请凭证。

你需要先拿到一个可用的 API Key。打开 TaoToken 的 API Keys 管理页面:

https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite

登录后创建一个新的 Key,复制出来备用。这个 Key 会用在 openclaw 的 config.toml 里,作为模型请求的凭证。注意不要把它提交到公开仓库,本地配置文件记得加进 .gitignore。

TaoToken 的 API 基础地址是:

https://taotoken.net/api

这个地址不加任何 UTM 参数,直接用于程序请求。你在 config.toml 里填的就是这个 base_url。

如果你后续要做长期编码或者 Agent 任务,可以了解一下 Coding Plan,它把常用的编码模型和额度打包在一起,适合 openclaw 这种需要持续调用模型的场景:

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

模型对话的调试入口在这里,配置完 Key 之后可以先用它验证模型是否通:

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

接入文档在:

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

把这些地址记下来,后面配置和排障都会用到。

3. 可复制配置:config.toml 骨架与 PowerShell 字体调整

3.1 先改 PowerShell 字体,解决二维码变形

二维码变形的根因是字体宽高比。操作步骤:

在 PowerShell 窗口的标题栏上点右键,选择“属性”,切换到“字体”选项卡。把字体从“新宋体”改成“MS Gothic”。如果你列表里没有 MS Gothic,可以选“Consolas”或者“Lucida Console”试试,但实测 MS Gothic 最稳。

改完之后,关闭当前 PowerShell 窗口,重新打开一个新的。注意:字体设置有时候只对新窗口生效,旧窗口可能还是老字体。重新打开后,再运行一次 openclaw 的安装命令,让二维码重新生成。

如果你用的是 Windows Terminal,字体设置在 settings.json 里,把 font face 改成:

{ "profiles": { "defaults": { "font": { "face": "MS Gothic", "size": 12 } } } }

改完保存,重启 Windows Terminal。二维码的宽高比就会恢复正常。

3.2 config.toml 骨架

openclaw 的配置文件通常放在用户目录下的 .openclaw 文件夹里,文件名是 config.toml。下面是一个可复制的骨架,把 YOUR_TAOTOKEN_API_KEY 替换成你刚才创建的 Key:

# openclaw 接入微信配置骨架 # 将 YOUR_TAOTOKEN_API_KEY 替换为你的 TaoToken API Key [model] provider = "taotoken" base_url = "https://taotoken.net/api" api_key = "YOUR_TAOTOKEN_API_KEY" model_name = "claude-3-5-sonnet" timeout_seconds = 60 [wechat] enabled = true qr_render_mode = "terminal" qr_font_hint = "MS Gothic" auto_reconnect = true [logging] level = "info" file = "./openclaw.log"

几个关键参数说明:

base_url 填 TaoToken 的 API 地址,不要加 UTM 参数。api_key 填你创建的 Key。model_name 根据你实际使用的模型填,比如 claude-3-5-sonnet 或者 gpt-4o。qr_render_mode 设为 terminal 表示在终端渲染二维码,qr_font_hint 是提示用的字体,实际生效还是靠你手动改 PowerShell 字体。

如果你用的是 Claude Code 或者 Anthropic 风格的接入,可以参考这个入口:

https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude_code&utm_campaign=rewrite

3.3 重新生成二维码

配置改完后,在 PowerShell 里重新运行 openclaw 的启动命令。通常是:

openclaw start --config .\.openclaw\config.toml

或者如果你用的是 clawbot 命令:

clawbot run --wechat

运行后终端会重新输出二维码。这时候因为字体已经改成 MS Gothic,二维码应该是正方形且可扫的。如果还是变形,往下看排障部分。

4. 验证请求:扫码成功与模型连通性测试

4.1 扫码验证

二维码正常显示后,打开微信,用扫一扫对准终端里的二维码。注意不要离屏幕太远,终端二维码的尺寸有限,保持 15 到 20 厘米距离比较合适。扫描成功后,微信会提示确认登录或者授权,点确认。

如果扫码后微信提示“无法识别”或者一直转圈,先检查二维码是不是正方形。如果还是扁的,说明字体没生效,回到 3.1 重新设置,并且确保关闭旧窗口重新打开。

4.2 模型连通性测试

扫码成功后,openclaw 会尝试用 config.toml 里的 Key 去请求 TaoToken 的模型接口。你可以在终端看到类似这样的日志:

[INFO] wechat connected [INFO] model provider: taotoken [INFO] sending test request... [INFO] response received: ok

如果看到 response received: ok,说明 Key 和 base_url 都配置正确。如果报 401 或者 403,检查 api_key 是否复制完整,有没有多余空格。如果报连接超时,检查 base_url 是不是写成了带 UTM 的地址,应该用纯 API 地址。

你也可以手动用 curl 测试一下 Key 是否可用:

curl -X POST https://taotoken.net/api/v1/chat/completions ` -H "Authorization: Bearer YOUR_TAOTOKEN_API_KEY" ` -H "Content-Type: application/json" ` -d '{"model":"claude-3-5-sonnet","messages":[{"role":"user","content":"ping"}]}'

返回 JSON 里有 choices 字段就说明 Key 正常。这个测试和 openclaw 用的是同一套凭证,能提前排除 Key 的问题。

5. 本篇常见错排查

5.1 二维码还是变形

最常见的原因是字体改了但窗口没重启。PowerShell 的字体设置对已打开的窗口不一定立即生效,必须关掉重新开。另外,如果你用的是 VS Code 内置终端或者 ConEmu 之类的第三方终端,字体设置位置不一样,需要在对应终端的设置里改。

还有一种情况:系统里没有 MS Gothic 字体。这是 Windows 可选字体,如果列表里找不到,可以去“设置-应用-可选功能”里添加“日语补充字体”,安装后 MS Gothic 就会出现。

5.2 扫码成功但模型报错

如果微信扫码通过了,但 openclaw 日志里出现 model request failed,先检查 config.toml 里的 base_url 是不是 https://taotoken.net/api,不要多写斜杠或者路径。然后检查 api_key 有没有换行或者空格。可以用 4.2 的 curl 命令单独测 Key。

如果报 model not found,检查 model_name 是不是 TaoToken 支持的模型名。不同模型的名称不一样,参考接入文档里的模型列表。

5.3 PowerShell 执行策略拦截

运行 openclaw 或者 clawbot 命令时,如果提示“无法加载文件,因为在此系统上禁止运行脚本”,需要调整执行策略:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后输入 Y 确认。这个操作只影响当前用户,不会影响系统全局。

5.4 二维码显示不全

如果终端窗口太小,二维码可能被截断。把 PowerShell 窗口拉大,或者调整字体大小到 10 到 12 之间。窗口宽度至少保证 80 个字符,高度至少 40 行。如果二维码还是显示不全,可以尝试把 qr_render_mode 改成 url,让 openclaw 输出一个 URL,然后复制到浏览器里打开,浏览器渲染的二维码更可靠。

5.5 微信版本不兼容

openclaw 接入微信依赖微信的插件机制,微信版本太旧可能没有对应入口。把微信升级到较新版本,然后在“设置-插件”里确认有 openclaw 相关的插件入口。如果找不到插件入口,说明当前微信版本不支持,需要升级。

6. 继续用 TaoToken 驱动你的 openclaw 工作流

二维码变形这个问题,说到底就是 PowerShell 字体宽高比不对,改成 MS Gothic 就能解决。配置骨架里的 base_url 和 api_key 填对,扫码通过后模型请求就能正常跑。如果你后面要做更长时间的编码任务或者 Agent 自动化,建议把 Coding Plan 用起来,统一 Key 管理比每个模型单独配要省事得多。

需要新建或者管理 Key 的时候,直接去 API Keys 页面:

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

想先验证模型通不通,用模型对话入口快速测:

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

长期编码和 Agent 任务,看 Coding Plan:

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

Claude Code 和 Anthropic 风格接入:

https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude_code&utm_campaign=rewrite

控制台入口:

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

把字体改好,把 config.toml 填好,扫码通过之后,openclaw 接入微信的流程就算跑通了。后面再遇到二维码问题,先看字体,再看窗口大小,基本都能解决。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询