1. 为什么要在 Windows 上给龙虾安个家QClaw 是腾讯电脑管家基于 OpenClaw 开源生态做的本地化 AI Agent 助手今天正式全量公测不用邀请码官网直接下 exe 就能装。它最大的特点是零门槛不需要你预装 Node.js、Python也不用敲命令行装完登录就能用。对刚接触 AI Agent 的人来说这基本是把「部署」这道墙给拆了。但真正让我想写这篇的是它的「龙虾像素工作室」。这个功能的设计灵感来自开源项目 Star-Office-UI把后台跑的 AI 变成一个像素风的小人你发指令的时候它会翻文件、忙忙碌碌、执行任务、待机摸鱼。听起来像个玩具可用起来你会发现它解决了一个很实际的问题Agent 在后台干活时你是「瞎」的现在你能看见它在动心里有底。这篇教程面向 Windows 用户和 AI Agent 新手我会带你走完安装、初次配置、接入 TaoToken 统一 Key 通道、验证连通性这几步最后给你一份可复制的 config.toml 骨架。装完之后你的龙虾就有家了而且模型通道是统一的不用在七八个厂商后台之间来回切。2. 装 QClaw 之前先把 TaoToken 这条通道备好QClaw 内置了默认大模型每天给 4000 万 Token 免费额度日常办公指令够用。但如果你要跑复杂任务、或者想固定用某个模型就得接自定义大模型。QClaw 支持一键配置 Minimax、Kimi、DeepSeek、智谱、千问、混元、豆包这些厂商问题是每换一个模型就要去对应后台拿一次 Key管理起来很碎。TaoToken 在这里的作用是给你一个统一的 API 通道和一把 Key把上面这些模型的调用收敛到一个入口。你不用记每个厂商的 base_url 和鉴权格式配置里填同一个地址和同一把 Key 就行。对 QClaw 这种支持自定义大模型的客户端来说这能省掉大量重复配置。你需要提前准备两样东西第一一个 TaoToken 账号去官网注册即可https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content第二一把 API Key。登录后进控制台在 API Keys 页面创建https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完把 Key 复制出来形如sk-xxxxxxxx先存到记事本里后面配置要用。注意这个 Key 只显示一次关掉页面就看不到了。提示TaoToken 的 API 入口是 https://taotoken.net/api配置时不要带任何查询参数直接填这个地址。如果你对某个模型的实际对话效果没把握可以先在模型对话页面试几条指令确认响应正常再往 QClaw 里配https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3. 可复制的安装与 config.toml 配置骨架3.1 Windows 端安装 QClaw去 QClaw 官网点「下载 Windows 版」拿到一个 .exe 安装包。双击运行安装向导里可以改安装路径建议别装在 C 盘根目录找个空间大的盘符单独建个文件夹。一路下一步装完桌面会出现 QClaw 图标。双击启动首次使用要注册账号支持微信快捷登录扫码就完成认证。登录成功后直接进对话界面这时候你就能发指令了比如「帮我整理下载文件夹里的图片」它会开始干活。3.2 接入 TaoToken 自定义模型在 QClaw 对话界面点对话框旁边的「默认大模型」勾选「自定义大模型」。厂商那一栏如果列表里没有 TaoToken 选项就选「自定义」或「OpenAI 兼容」这类通用入口然后填三个关键字段配置项填写内容API Base URLhttps://taotoken.net/apiAPI Key你在 TaoToken 控制台创建的那把 sk- 开头的 Key模型名称按需填比如 deepseek-chat、qwen-plus 等填完点确定再发一条对话测试。如果返回正常说明通道打通了。3.3 config.toml 骨架QClaw 的图形界面配置对新手够用但如果你想把配置固化下来、方便迁移或版本管理可以维护一份 config.toml。下面是我实测可用的骨架字段名以你本地 QClaw 版本为准核心是 provider 段和 model 段# QClaw 本地配置骨架 - TaoToken 统一通道版 # 路径通常在 %APPDATA%\QClaw\config.toml 或安装目录下的 config 文件夹 [provider] name taotoken type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 timeout 60 [model] default deepseek-chat fallback qwen-plus max_tokens 8192 temperature 0.7 [agent] workspace D:/QClawWorkspace pixel_studio true permission_guard true [schedule] enabled true timezone Asia/Shanghai几个字段说明一下。base_url固定填 TaoToken 的 API 地址不要加斜杠结尾。api_key换成你自己的。pixel_studio true就是开启龙虾像素工作室permission_guard true对应默认开启的工具权限限制防止 AI 误删文件。workspace建议指向一个专门的文件夹别直接指到系统盘根目录。改完配置保存重启 QClaw 让它重新加载。4. 验证 Agent 连通性三步确认龙虾真的活了配置填完不代表通了得实际验证。我一般走这三步。第一步基础对话验证。在 QClaw 对话框发一句「你好请回复你的模型名称」。如果它正常回复并且能说出模型名说明 API 通道是通的。如果报 401就是 Key 错了报 404多半是 base_url 写错了。第二步工具调用验证。发一条需要动文件的指令比如「在 workspace 目录下新建一个 test.txt写入 hello」。看它能不能真的创建文件。这一步验证的是 Agent 的工具权限和文件系统访问是否正常。如果它说「我没有权限」去设置里检查工具权限开关。第三步像素工作室联动验证。点左侧【工作室】进入龙虾像素小屋然后发一条稍微复杂点的指令比如「帮我搜索一下今天的天气并整理成文档」。这时候你应该能看到像素小人开始翻文件、忙碌起来。状态会跟着任务阶段变整理资料时翻文件执行任务时忙碌待机时休闲。如果像素小人一直不动检查pixel_studio是否设为 true以及 QClaw 版本是否支持。三步都过说明你的龙虾工作流在本地跑通了。这时候你可以试试手机微信远程操控在 QClaw 里登录微信账号点设置左侧的手机图标用手机微信扫码绑定。绑定成功后在手机微信里发指令电脑上的 QClaw 会执行并把结果反馈回来。出门在外也能指挥家里的电脑干活。5. 本篇常见错排查报错一401 Unauthorized。最常见的原因是 Key 复制时带了空格或者 Key 已经失效。去 TaoToken 控制台重新创建一把注意复制完整。另外确认base_url是https://taotoken.net/api不要写成带/v1或其他路径的版本。报错二连接超时。检查本机网络是否能正常访问外网以及防火墙有没有拦 QClaw。可以先用 curl 测一下通道curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的密钥 \ -H Content-Type: application/json \ -d {model:deepseek-chat,messages:[{role:user,content:ping}]}如果这条命令返回正常 JSON说明通道没问题问题在 QClaw 配置侧。报错三模型名称不识别。不同厂商的模型名不一样填错了会报 model not found。去 TaoToken 的模型列表页确认可用模型名别凭记忆填。报错四像素工作室不显示。确认 QClaw 是最新公测版旧版本可能没有这个模块。另外config.toml里pixel_studio要设为 true改完重启。报错五定时任务不执行。检查timezone是否设对以及任务是否被手动关闭。在定时任务管理页可以单独开启、关闭、删除、立即执行。如果任务列表里状态是关闭的点一下开启。报错六AI 误删文件。这就是权限限制开关存在的意义。默认开启时 AI 按低权限执行降低误删误改风险。如果你发现它权限过大去设置里确认开关是打开的。别为了图方便关掉它。6. 把龙虾养起来后续怎么用装好只是开始。QClaw 的技能管理支持从 AI 会话生成技能也支持从 GitHub 仓库导入你可以按自己的工作流慢慢攒一套专属技能。定时任务配合像素工作室适合做那种「每天固定时间跑一次」的活比如早上的天气推送、下班前的文件归档。模型通道这边TaoToken 的统一 Key 让你换模型时不用改配置结构只改model.default那一行就行。想试新模型去模型对话页面先聊几句觉得合适再写进 config.toml。如果你打算长期跑编码类或 Agent 类任务可以了解一下 Coding Plan额度模型更适合高频调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入过程中遇到鉴权或参数问题翻一下接入文档常见报错都有对照说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content龙虾安了家剩下的就是让它干活。先从整理文件这种小事开始跑顺了再上复杂任务。