1. Windows 上装 QClaw 到底卡在哪先看清环境与通道两个坑QClaw 是腾讯电脑管家团队做的本地 AI 智能助手圈内叫它「小龙虾」本质是 OpenClaw 的腾讯发行版。它能用自然语言帮你整理文件、远程操控电脑、跑定时任务数据在本地执行。适合谁第一次在 Windows 上碰这类本地 Agent 的开发者以及想把模型通道统一到一处、不想每个工具单独配 Key 的人。但「初次安装」这四个字真正让人卡住的往往不是双击安装包而是两件事一是环境没检查干净装到一半报缺依赖二是装完之后模型通道没配好界面能打开、指令发出去却一直转圈。我见过太多人把这两件事混在一起以为是软件坏了其实是 endpoint 和 Key 没落到统一通道上。这篇按「环境检查 → 依赖准备 → 安装 → 通道配置 → 最小验证 → 排错」的顺序走一遍。核心检索词就三个Windows 安装 QClaw、QClaw 环境准备、QClaw API 通道配置。你跟着做最后能发一条最小对话请求拿到回复就算通了。先说清楚一个前提QClaw 目前是邀请制内测得先在官网申请资格审核通过后才能下载。这一步没法跳过也不在本篇的技术范围内申请入口在 qclaw.qq.com。拿到资格之后下面的步骤才有意义。环境这块官方要求是 Windows 10 或 Windows 1132 位 64 位都行磁盘预留 500MB 以上网络能正常访问互联网。听起来很宽松但实际部署时真正影响成败的是三样东西系统版本号、PowerShell 执行策略、以及有没有装 VC 运行库。前两个决定了安装脚本能不能跑第三个决定了主程序启动时会不会闪退。我建议你在动手之前先花两分钟把下面这组检查命令跑一遍。它们不改变任何系统状态只是把信息读出来安全无副作用。很多人跳过这步结果装完发现 PowerShell 被策略锁死脚本根本执行不了又回头折腾反而更慢。还有一个容易被忽略的点通道。QClaw 本身是客户端它要调模型才能干活。默认通道能用但如果你同时还在用别的编码工具、Agent 工具每个都单独配 Key、单独记 endpoint管理成本会很高。把通道统一到 TaoTokenBase URL 和 Key 只维护一份后面换工具、加工具都省事。这也是本篇把「通道配置」单独拎出来讲的原因。所以这一节你要建立的认知是安装 QClaw 装客户端 配通道两件事都完成才算真的可用。只装不配界面能开但干不了活只配不装没有载体。下面从环境检查开始一步步来。2. TaoToken 前置准备把 Base URL 和 Key 先拿到手在装 QClaw 之前我建议你先把 TaoToken 的通道信息准备好也就是 Base URL 和 API Key。原因很简单安装过程中如果临时去注册、去找 Key容易打断节奏而且装完立刻要填配置手边没有就得再切窗口。先把这两样拿到后面配置片段直接复制粘贴一气呵成。TaoToken 的定位是统一模型通道。你把它理解成一个「总入口」不管后面是 QClaw、还是别的编码工具、Agent 工具都指向同一个 Base URL用同一套 Key。好处是换工具时不用重新申请、重新记地址模型 ID 也在一处管理。对同时折腾多个工具的人来说这个统一入口省下的心智负担很实在。具体要拿两样东西。第一是 API Key去控制台的 API Keys 页面创建地址是 https://taotoken.net/api-keys 。创建后立刻复制保存页面刷新后通常不再完整显示这是常规安全设计。第二是 Base URL统一用 https://taotoken.net/api 注意这个地址后面不加任何多余路径配置时原样填。这里有个细节要提醒Base URL 和完整请求地址不是一回事。有些工具要求填到/v1这一层有些只填到域名根。QClaw 的通道配置里Base URL 填 https://taotoken.net/api 即可具体拼接由客户端处理。如果你填错层级最常见的表现就是请求 404 或者一直转圈后面排错章节会专门讲。模型 ID 也要提前想好。TaoToken 通道下可以选不同模型你在配置时填的是模型标识符比如常见的对话模型 ID。这个 ID 要和通道支持的列表对得上填错会报「model not found」之类的错误。建议先在模型对话页面确认一下可用模型地址是 https://taotoken.net/models 看清楚再填。如果你后面打算长期跑编码类、Agent 类任务可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan 。它面向的是持续性的编码和 Agent 场景和单次对话的用量模式不一样。初次安装 QClaw 只是验证通道通不通用普通 Key 就够等确认要长期用再按需升级。把这三样记在一个临时文本里Base URL、API Key、Model ID。下面安装完 QClaw 后配置片段直接引用它们。别小看这个前置动作它能让整个安装流程从「边装边找」变成「照着填」效率差很多。3. 可复制配置环境检查命令与 QClaw 通道 settings 片段这一节是整篇最核心的部分全部给可复制的内容。分两块先是安装前的环境检查命令再是安装后的通道配置片段。你按顺序执行中间不需要自己改逻辑只替换 Key 和模型 ID 就行。先做环境检查。打开 PowerShell注意用普通权限即可不需要管理员。逐条跑下面这组命令把结果看一眼# 1. 查看系统版本与架构 [System.Environment]::OSVersion.Version $env:PROCESSOR_ARCHITECTURE # 2. 查看磁盘剩余空间C 盘为例 Get-PSDrive C | Select-Object Used,Free # 3. 查看 PowerShell 执行策略 Get-ExecutionPolicy -List # 4. 检查 VC 运行库是否已安装看是否有 2015-2022 条目 Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Where-Object { $_.DisplayName -like *Visual C* } | Select-Object DisplayName, DisplayVersion第一条确认系统是 Win10 还是 Win11以及是 64 位还是 32 位。第二条看 C 盘剩余空间低于 500MB 就先清理。第三条最关键如果CurrentUser或LocalMachine显示Restricted安装脚本可能跑不起来需要临时放开命令是Set-ExecutionPolicy -Scope CurrentUser RemoteSigned执行后按提示确认。第四条看有没有 VC 运行库没有的话去微软官网装一个 2015-2022 的 x64 版本装完再继续。环境没问题后正常下载安装 QClaw。安装过程是图形向导勾选协议、选安装路径、点安装、等完成这里不展开。装完先别急着登录微信先把通道配好否则登录后发指令会失败容易误判成软件问题。QClaw 的通道配置走的是本地 settings 文件。路径通常在用户目录下的配置文件夹里形如%USERPROFILE%\.qclaw\settings.json。如果安装后该文件不存在手动新建一个即可。下面是一份可直接复制的 JSON 片段把YOUR_API_KEY和模型 ID 替换成你自己的{ api: { baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, model: YOUR_MODEL_ID, timeout: 60000 }, runtime: { localOnly: true, logLevel: info } }三个字段对应三件套baseUrl填 TaoToken 的 API 地址apiKey填你在控制台创建的 Keymodel填模型 ID。timeout给 60 秒本地 Agent 任务有时响应慢给足时间避免误判超时。runtime.localOnly保持 true符合本地执行的定位。如果你更习惯用 TOML 风格的工具链等价配置长这样字段含义一致[api] base_url https://taotoken.net/api api_key YOUR_API_KEY model YOUR_MODEL_ID timeout 60000 [runtime] local_only true log_level info保存文件后重启 QClaw 让配置生效。这里有个坑JSON 对格式很敏感多一个逗号、少一个引号都会导致解析失败客户端可能直接回退到默认通道表现就是「配置了但没生效」。保存前用编辑器的 JSON 校验看一眼或者用Get-Content settings.json | ConvertFrom-Json验证一下能不能解析。配置写完后建议再确认一次文件编码是 UTF-8 无 BOM。Windows 记事本有时会加 BOM导致解析异常。用 VS Code 或 Notepad 另存为 UTF-8 即可。这一步很小但能省掉后面一堆莫名其妙的报错。4. 验证请求发一条最小对话请求确认通道可用配置写完、客户端重启后别急着上复杂任务先发一条最小对话请求确认「安装 通道」两件事都通了。这一步是整个流程的验收点过了就说明基础可用后面再叠加文件整理、定时任务这些功能。验证分两层。第一层在 QClaw 界面里直接发一条最简单的指令比如「你好回复一句话确认通道正常」。如果几秒内收到回复说明客户端到 TaoToken 通道的链路是通的。如果一直转圈或者报错先别怀疑软件去排错章节对照报错信息。第二层用命令行直接打通道排除客户端本身的干扰。这样能区分是「通道问题」还是「客户端配置问题」。用 PowerShell 发一个最小请求$headers { Authorization Bearer YOUR_API_KEY Content-Type application/json } $body { model YOUR_MODEL_ID messages ( { role user; content 回复通道正常 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body把YOUR_API_KEY和YOUR_MODEL_ID替换后执行。如果返回结构里能看到choices字段并且里面有模型回复的内容说明通道完全正常。这时候再回到 QClaw 界面配置基本不会有问题。如果命令行通了、但 QClaw 界面不通问题就在客户端的 settings 文件上要么路径不对要么 JSON 格式错要么 Key 复制时带了空格。反过来如果命令行也不通那就是通道侧的问题重点看 Key 是否有效、模型 ID 是否正确、Base URL 是否写成了https://taotoken.net/api。验证通过后你可以顺手在 QClaw 里试一条真实指令比如「把下载文件夹里大于 100MB 的文件列出来」。这条指令会触发本地文件操作能同时验证通道和本地执行能力。如果它能正确列出文件说明整套链路都跑通了。这里提醒一句验证阶段不要一上来就发多步复杂任务。多步任务涉及多次模型调用和本地操作一旦中间某步失败你很难判断是通道问题还是任务逻辑问题。先用单步、最小请求确认基础链路再逐步加复杂度排错成本最低。5. 本篇常见错排查401、local proxy failed、reading choices 逐个拆装 QClaw 配通道报错集中在几个固定位置。这一节按真实报错逐个拆你对照自己的现象找对应条目。每个都给出原因和动作不绕弯。401 Unauthorized。这是最常见的。原因基本是 Key 无效或没带上。检查三处一是 Key 是否复制完整有没有首尾空格二是请求头里Authorization是不是Bearer开头注意 Bearer 后面有一个空格三是 Key 是否已在控制台被删除或过期。重新去 https://taotoken.net/api-keys 生成一个替换后重试。如果命令行通、客户端不通重点看 settings.json 里apiKey字段有没有被引号包住、有没有多余字符。local proxy failed。这个报错通常出现在客户端尝试走本地代理转发时。原因可能是系统里配了代理或者客户端配置里残留了代理字段。检查系统代理设置确认没有指向一个不可用的本地端口。同时检查 settings.json 里有没有proxy相关字段有的话删掉让请求直连 TaoToken 通道。这个报错和网络环境有关确保网络能正常访问互联网即可。reading choices 相关报错。典型表现是「cannot read property choices of undefined」或者「reading choices」。这说明请求发出去了但返回结构里没有choices字段客户端解析失败。原因通常是Base URL 层级写错比如写成了https://taotoken.net/api/v1导致路径重复或者模型 ID 填错通道返回了错误结构或者 Key 无效返回的是错误对象而不是正常响应。先确认 Base URL 是https://taotoken.net/api再确认模型 ID 在可用列表里最后确认 Key 有效。OAuth 相关报错。如果出现 OAuth 字样说明客户端在尝试走某种授权流程而你的配置是 Key 直连模式两者冲突。检查配置里有没有残留的 OAuth 字段比如authType、oauthToken之类删掉只保留apiKey直连方式。QClaw 走 TaoToken 通道时用 Key 直连即可不需要额外授权流程。配置不生效、回退默认通道。现象是明明改了 settings.json但请求还是走默认地址。原因通常是 JSON 解析失败客户端静默回退。用Get-Content settings.json | ConvertFrom-Json验证能否解析报错就说明格式有问题。另外确认文件路径正确不同安装方式路径可能略有差异可以在 QClaw 设置里看它实际读取的配置路径。模型 ID 报 not found。通道通了但模型标识符不对。去 https://taotoken.net/models 看可用列表复制准确的 ID。注意大小写和连字符模型 ID 通常对格式敏感手打容易错建议直接复制。排错的核心思路是分层先命令行验证通道再验证客户端配置最后验证具体任务。哪一层断就修哪一层不要混着改。每次只改一个变量改完立刻重测这样能快速定位真正的故障点。6. 通道统一之后把 QClaw 接进你的日常工具链走到这里QClaw 应该已经装好、通道也通了。最后聊一下通道统一之后能带来什么以及怎么把它接进你已有的工具链。这部分不是必须但对同时用多个工具的人价值很大。统一通道最直接的好处是「一处改处处生效」。你后面如果还装了别的编码工具、Agent 工具只要它们支持自定义 Base URL 和 Key就都指向 https://taotoken.net/api 用同一套 Key。换模型时也只改一处不用每个工具单独进设置页翻。工具越多这个优势越明显。QClaw 本身适合做本地文件操作、定时任务、远程指令这类事。你可以把它当成「本地执行的手」模型通道当成「大脑」。大脑统一到 TaoToken手可以有很多只——QClaw 是一只别的工具是另外几只。这样分工清晰管理也简单。如果你打算长期跑编码类、Agent 类任务可以了解下 Coding Plan地址是 https://taotoken.net/coding-plan 。它面向持续性用量场景和单次对话的计费模式不同。初次安装验证阶段用普通 Key 就够确认要长期用再按需切换。接入文档在 https://taotoken.net/doc 里面有各工具的配置示例遇到字段不确定时可以去对照。模型对话页面 https://taotoken.net/models 可以随时确认可用模型和 ID。控制台 https://taotoken.net/console 管理你的 Key 和用量。最后给一个实用建议把 Base URL、Key、Model ID 这三样存在一个你顺手的地方比如密码管理器或者本地加密笔记。后面每接一个新工具都是这三样复制粘贴不用重新找。装 QClaw 只是第一步通道统一才是让后续所有工具都省事的那一步。
1. Windows 上装 QClaw 到底卡在哪先看清环境与通道两个坑QClaw 是腾讯电脑管家团队做的本地 AI 智能助手圈内叫它「小龙虾」本质是 OpenClaw 的腾讯发行版。它能用自然语言帮你整理文件、远程操控电脑、跑定时任务数据在本地执行。适合谁第一次在 Windows 上碰这类本地 Agent 的开发者以及想把模型通道统一到一处、不想每个工具单独配 Key 的人。但「初次安装」这四个字真正让人卡住的往往不是双击安装包而是两件事一是环境没检查干净装到一半报缺依赖二是装完之后模型通道没配好界面能打开、指令发出去却一直转圈。我见过太多人把这两件事混在一起以为是软件坏了其实是 endpoint 和 Key 没落到统一通道上。这篇按「环境检查 → 依赖准备 → 安装 → 通道配置 → 最小验证 → 排错」的顺序走一遍。核心检索词就三个Windows 安装 QClaw、QClaw 环境准备、QClaw API 通道配置。你跟着做最后能发一条最小对话请求拿到回复就算通了。先说清楚一个前提QClaw 目前是邀请制内测得先在官网申请资格审核通过后才能下载。这一步没法跳过也不在本篇的技术范围内申请入口在 qclaw.qq.com。拿到资格之后下面的步骤才有意义。环境这块官方要求是 Windows 10 或 Windows 1132 位 64 位都行磁盘预留 500MB 以上网络能正常访问互联网。听起来很宽松但实际部署时真正影响成败的是三样东西系统版本号、PowerShell 执行策略、以及有没有装 VC 运行库。前两个决定了安装脚本能不能跑第三个决定了主程序启动时会不会闪退。我建议你在动手之前先花两分钟把下面这组检查命令跑一遍。它们不改变任何系统状态只是把信息读出来安全无副作用。很多人跳过这步结果装完发现 PowerShell 被策略锁死脚本根本执行不了又回头折腾反而更慢。还有一个容易被忽略的点通道。QClaw 本身是客户端它要调模型才能干活。默认通道能用但如果你同时还在用别的编码工具、Agent 工具每个都单独配 Key、单独记 endpoint管理成本会很高。把通道统一到 TaoTokenBase URL 和 Key 只维护一份后面换工具、加工具都省事。这也是本篇把「通道配置」单独拎出来讲的原因。所以这一节你要建立的认知是安装 QClaw 装客户端 配通道两件事都完成才算真的可用。只装不配界面能开但干不了活只配不装没有载体。下面从环境检查开始一步步来。2. TaoToken 前置准备把 Base URL 和 Key 先拿到手在装 QClaw 之前我建议你先把 TaoToken 的通道信息准备好也就是 Base URL 和 API Key。原因很简单安装过程中如果临时去注册、去找 Key容易打断节奏而且装完立刻要填配置手边没有就得再切窗口。先把这两样拿到后面配置片段直接复制粘贴一气呵成。TaoToken 的定位是统一模型通道。你把它理解成一个「总入口」不管后面是 QClaw、还是别的编码工具、Agent 工具都指向同一个 Base URL用同一套 Key。好处是换工具时不用重新申请、重新记地址模型 ID 也在一处管理。对同时折腾多个工具的人来说这个统一入口省下的心智负担很实在。具体要拿两样东西。第一是 API Key去控制台的 API Keys 页面创建地址是 https://taotoken.net/api-keys 。创建后立刻复制保存页面刷新后通常不再完整显示这是常规安全设计。第二是 Base URL统一用 https://taotoken.net/api 注意这个地址后面不加任何多余路径配置时原样填。这里有个细节要提醒Base URL 和完整请求地址不是一回事。有些工具要求填到/v1这一层有些只填到域名根。QClaw 的通道配置里Base URL 填 https://taotoken.net/api 即可具体拼接由客户端处理。如果你填错层级最常见的表现就是请求 404 或者一直转圈后面排错章节会专门讲。模型 ID 也要提前想好。TaoToken 通道下可以选不同模型你在配置时填的是模型标识符比如常见的对话模型 ID。这个 ID 要和通道支持的列表对得上填错会报「model not found」之类的错误。建议先在模型对话页面确认一下可用模型地址是 https://taotoken.net/models 看清楚再填。如果你后面打算长期跑编码类、Agent 类任务可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan 。它面向的是持续性的编码和 Agent 场景和单次对话的用量模式不一样。初次安装 QClaw 只是验证通道通不通用普通 Key 就够等确认要长期用再按需升级。把这三样记在一个临时文本里Base URL、API Key、Model ID。下面安装完 QClaw 后配置片段直接引用它们。别小看这个前置动作它能让整个安装流程从「边装边找」变成「照着填」效率差很多。3. 可复制配置环境检查命令与 QClaw 通道 settings 片段这一节是整篇最核心的部分全部给可复制的内容。分两块先是安装前的环境检查命令再是安装后的通道配置片段。你按顺序执行中间不需要自己改逻辑只替换 Key 和模型 ID 就行。先做环境检查。打开 PowerShell注意用普通权限即可不需要管理员。逐条跑下面这组命令把结果看一眼# 1. 查看系统版本与架构 [System.Environment]::OSVersion.Version $env:PROCESSOR_ARCHITECTURE # 2. 查看磁盘剩余空间C 盘为例 Get-PSDrive C | Select-Object Used,Free # 3. 查看 PowerShell 执行策略 Get-ExecutionPolicy -List # 4. 检查 VC 运行库是否已安装看是否有 2015-2022 条目 Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Where-Object { $_.DisplayName -like *Visual C* } | Select-Object DisplayName, DisplayVersion第一条确认系统是 Win10 还是 Win11以及是 64 位还是 32 位。第二条看 C 盘剩余空间低于 500MB 就先清理。第三条最关键如果CurrentUser或LocalMachine显示Restricted安装脚本可能跑不起来需要临时放开命令是Set-ExecutionPolicy -Scope CurrentUser RemoteSigned执行后按提示确认。第四条看有没有 VC 运行库没有的话去微软官网装一个 2015-2022 的 x64 版本装完再继续。环境没问题后正常下载安装 QClaw。安装过程是图形向导勾选协议、选安装路径、点安装、等完成这里不展开。装完先别急着登录微信先把通道配好否则登录后发指令会失败容易误判成软件问题。QClaw 的通道配置走的是本地 settings 文件。路径通常在用户目录下的配置文件夹里形如%USERPROFILE%\.qclaw\settings.json。如果安装后该文件不存在手动新建一个即可。下面是一份可直接复制的 JSON 片段把YOUR_API_KEY和模型 ID 替换成你自己的{ api: { baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, model: YOUR_MODEL_ID, timeout: 60000 }, runtime: { localOnly: true, logLevel: info } }三个字段对应三件套baseUrl填 TaoToken 的 API 地址apiKey填你在控制台创建的 Keymodel填模型 ID。timeout给 60 秒本地 Agent 任务有时响应慢给足时间避免误判超时。runtime.localOnly保持 true符合本地执行的定位。如果你更习惯用 TOML 风格的工具链等价配置长这样字段含义一致[api] base_url https://taotoken.net/api api_key YOUR_API_KEY model YOUR_MODEL_ID timeout 60000 [runtime] local_only true log_level info保存文件后重启 QClaw 让配置生效。这里有个坑JSON 对格式很敏感多一个逗号、少一个引号都会导致解析失败客户端可能直接回退到默认通道表现就是「配置了但没生效」。保存前用编辑器的 JSON 校验看一眼或者用Get-Content settings.json | ConvertFrom-Json验证一下能不能解析。配置写完后建议再确认一次文件编码是 UTF-8 无 BOM。Windows 记事本有时会加 BOM导致解析异常。用 VS Code 或 Notepad 另存为 UTF-8 即可。这一步很小但能省掉后面一堆莫名其妙的报错。4. 验证请求发一条最小对话请求确认通道可用配置写完、客户端重启后别急着上复杂任务先发一条最小对话请求确认「安装 通道」两件事都通了。这一步是整个流程的验收点过了就说明基础可用后面再叠加文件整理、定时任务这些功能。验证分两层。第一层在 QClaw 界面里直接发一条最简单的指令比如「你好回复一句话确认通道正常」。如果几秒内收到回复说明客户端到 TaoToken 通道的链路是通的。如果一直转圈或者报错先别怀疑软件去排错章节对照报错信息。第二层用命令行直接打通道排除客户端本身的干扰。这样能区分是「通道问题」还是「客户端配置问题」。用 PowerShell 发一个最小请求$headers { Authorization Bearer YOUR_API_KEY Content-Type application/json } $body { model YOUR_MODEL_ID messages ( { role user; content 回复通道正常 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body把YOUR_API_KEY和YOUR_MODEL_ID替换后执行。如果返回结构里能看到choices字段并且里面有模型回复的内容说明通道完全正常。这时候再回到 QClaw 界面配置基本不会有问题。如果命令行通了、但 QClaw 界面不通问题就在客户端的 settings 文件上要么路径不对要么 JSON 格式错要么 Key 复制时带了空格。反过来如果命令行也不通那就是通道侧的问题重点看 Key 是否有效、模型 ID 是否正确、Base URL 是否写成了https://taotoken.net/api。验证通过后你可以顺手在 QClaw 里试一条真实指令比如「把下载文件夹里大于 100MB 的文件列出来」。这条指令会触发本地文件操作能同时验证通道和本地执行能力。如果它能正确列出文件说明整套链路都跑通了。这里提醒一句验证阶段不要一上来就发多步复杂任务。多步任务涉及多次模型调用和本地操作一旦中间某步失败你很难判断是通道问题还是任务逻辑问题。先用单步、最小请求确认基础链路再逐步加复杂度排错成本最低。5. 本篇常见错排查401、local proxy failed、reading choices 逐个拆装 QClaw 配通道报错集中在几个固定位置。这一节按真实报错逐个拆你对照自己的现象找对应条目。每个都给出原因和动作不绕弯。401 Unauthorized。这是最常见的。原因基本是 Key 无效或没带上。检查三处一是 Key 是否复制完整有没有首尾空格二是请求头里Authorization是不是Bearer开头注意 Bearer 后面有一个空格三是 Key 是否已在控制台被删除或过期。重新去 https://taotoken.net/api-keys 生成一个替换后重试。如果命令行通、客户端不通重点看 settings.json 里apiKey字段有没有被引号包住、有没有多余字符。local proxy failed。这个报错通常出现在客户端尝试走本地代理转发时。原因可能是系统里配了代理或者客户端配置里残留了代理字段。检查系统代理设置确认没有指向一个不可用的本地端口。同时检查 settings.json 里有没有proxy相关字段有的话删掉让请求直连 TaoToken 通道。这个报错和网络环境有关确保网络能正常访问互联网即可。reading choices 相关报错。典型表现是「cannot read property choices of undefined」或者「reading choices」。这说明请求发出去了但返回结构里没有choices字段客户端解析失败。原因通常是Base URL 层级写错比如写成了https://taotoken.net/api/v1导致路径重复或者模型 ID 填错通道返回了错误结构或者 Key 无效返回的是错误对象而不是正常响应。先确认 Base URL 是https://taotoken.net/api再确认模型 ID 在可用列表里最后确认 Key 有效。OAuth 相关报错。如果出现 OAuth 字样说明客户端在尝试走某种授权流程而你的配置是 Key 直连模式两者冲突。检查配置里有没有残留的 OAuth 字段比如authType、oauthToken之类删掉只保留apiKey直连方式。QClaw 走 TaoToken 通道时用 Key 直连即可不需要额外授权流程。配置不生效、回退默认通道。现象是明明改了 settings.json但请求还是走默认地址。原因通常是 JSON 解析失败客户端静默回退。用Get-Content settings.json | ConvertFrom-Json验证能否解析报错就说明格式有问题。另外确认文件路径正确不同安装方式路径可能略有差异可以在 QClaw 设置里看它实际读取的配置路径。模型 ID 报 not found。通道通了但模型标识符不对。去 https://taotoken.net/models 看可用列表复制准确的 ID。注意大小写和连字符模型 ID 通常对格式敏感手打容易错建议直接复制。排错的核心思路是分层先命令行验证通道再验证客户端配置最后验证具体任务。哪一层断就修哪一层不要混着改。每次只改一个变量改完立刻重测这样能快速定位真正的故障点。6. 通道统一之后把 QClaw 接进你的日常工具链走到这里QClaw 应该已经装好、通道也通了。最后聊一下通道统一之后能带来什么以及怎么把它接进你已有的工具链。这部分不是必须但对同时用多个工具的人价值很大。统一通道最直接的好处是「一处改处处生效」。你后面如果还装了别的编码工具、Agent 工具只要它们支持自定义 Base URL 和 Key就都指向 https://taotoken.net/api 用同一套 Key。换模型时也只改一处不用每个工具单独进设置页翻。工具越多这个优势越明显。QClaw 本身适合做本地文件操作、定时任务、远程指令这类事。你可以把它当成「本地执行的手」模型通道当成「大脑」。大脑统一到 TaoToken手可以有很多只——QClaw 是一只别的工具是另外几只。这样分工清晰管理也简单。如果你打算长期跑编码类、Agent 类任务可以了解下 Coding Plan地址是 https://taotoken.net/coding-plan 。它面向持续性用量场景和单次对话的计费模式不同。初次安装验证阶段用普通 Key 就够确认要长期用再按需切换。接入文档在 https://taotoken.net/doc 里面有各工具的配置示例遇到字段不确定时可以去对照。模型对话页面 https://taotoken.net/models 可以随时确认可用模型和 ID。控制台 https://taotoken.net/console 管理你的 Key 和用量。最后给一个实用建议把 Base URL、Key、Model ID 这三样存在一个你顺手的地方比如密码管理器或者本地加密笔记。后面每接一个新工具都是这三样复制粘贴不用重新找。装 QClaw 只是第一步通道统一才是让后续所有工具都省事的那一步。
