1. OpenClaw 小龙虾在 Windows 上到底能做什么
OpenClaw 小龙虾是一个跑在本地电脑上的开源智能体,圈内人管部署它叫“养虾”。它和网页版 AI 最大的区别是:它能直接操作你的 Windows 系统——整理文件夹、批量重命名、打开浏览器抓数据、把结果存成表格,全程在你本机离线运行,数据不出电脑。适合谁?适合不想写代码、但想让电脑自动干重复活的办公党、学生、自媒体运营。我实测下来,Win11 家庭版和专业版都能跑,核心门槛只有一个:路径别带中文。
很多人第一次装失败,不是软件问题,而是被系统安全拦截或路径含中文卡住。这篇就按“拿安装包 → 解压 → 放行拦截 → 初始化 → 验证在线”的顺序走一遍,每一步都给可复制的路径和命令。你不需要装 Python、Node.js,也不需要敲终端,全程图形化。装完后你会看到一个主界面,右上角显示“Gateway 在线”,那就成了。
需要先说明一点:OpenClaw 本身是本地智能体,但如果你想让它在执行任务时调用更强的云端模型能力(比如复杂推理、长文档总结),可以把它接到兼容 OpenAI 协议的模型服务上。下面第 2 节会讲怎么用 TaoToken 这类模型网关给它补上“大脑”,第 3 节给可直接复制的配置片段。
2. 部署前的前置准备与 TaoToken 模型接入
2.1 关闭安全防护,避免核心文件被误删
OpenClaw 要模拟键鼠、读写本地文件、接管浏览器,这些行为会被安全软件判定为风险动作。这是误判,项目开源可查源码。部署前请临时关闭:360 安全卫士与杀毒、腾讯电脑管家、火绒、以及 Win11 自带的 Defender 实时监测。装完并确认能正常跑之后,再把 Defender 实时监测开回来,同时把 OpenClaw 安装目录加入排除项,这样既安全又不影响使用。
2.2 为什么建议接一个模型网关
OpenClaw 本地负责“动手”,但“动脑”的部分如果只靠本地小模型,复杂任务容易卡壳。TaoToken 提供兼容 OpenAI 接口的模型网关,你只要拿到一个 API Key 和一个 Base URL,就能让 OpenClaw 在需要时调用更强的模型。它的控制台地址是 https://taotoken.net/api-keys ,文档在 https://taotoken.net/doc ,模型对话体验在 https://taotoken.net/chat 。如果你打算长期跑编码类或 Agent 类任务,可以看 Coding Plan:https://taotoken.net/coding-plan 。
2.3 拿 Key 与确认三件套
登录控制台后创建一个 API Key,你会得到三样东西,后面配置要用:
| 配置项 | 值 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | 兼容 OpenAI 协议,末尾不加斜杠 |
| API Key | sk-xxxx(你自己的) | 控制台生成,别泄露 |
| Model ID | 控制台模型列表里的名称 | 例如你选定的对话或编码模型 |
这三件套是后面所有配置的基础。Claude Code 用户如果走 Anthropic 兼容入口,参考 https://taotoken.net/claude-code-anthropic ;用 Cline 挂 MCP 的话,Base URL、Key、Model ID 同样要填全,缺一个都会报错。
3. 可复制的配置文件与环境变量设置
3.1 解压与路径规范
下载整合包后,用 7-Zip 或 WinRAR 解压(Win11 自带解压容易丢文件)。解压出来是Openclaw-win文件夹,里面能看到红色小龙虾图标的Openclaw Windows一键启动.exe。存放路径只能用纯英文,推荐:
D:\OpenClaw E:\AI\OpenClaw不要用D:\软件\OpenClaw、D:\小龙虾、C:\Program Files\OpenClaw这类含中文、空格或系统保护目录的路径,否则初始化阶段会直接报错。
3.2 环境变量设置
如果你要让 OpenClaw 调用 TaoToken 的模型,需要设置环境变量。按 Win 键搜索“环境变量”,打开“编辑系统环境变量”→“环境变量”,在“用户变量”里新建:
变量名:OPENAI_API_KEY 变量值:sk-你的Key 变量名:OPENAI_BASE_URL 变量值:https://taotoken.net/api设置完记得点确定,然后重启一次启动程序让变量生效。这一步很多人漏掉,导致后面请求一直 401。
3.3 settings 配置片段
OpenClaw 的模型配置一般放在安装目录下的config或settings文件里。以 JSON 为例,可复制如下片段(路径按你实际安装位置调整):
{ "model": { "provider": "openai-compatible", "base_url": "https://taotoken.net/api", "api_key_env": "OPENAI_API_KEY", "model_id": "你的Model ID", "timeout": 60 }, "gateway": { "host": "127.0.0.1", "port": 8765 } }如果你用的是 TOML 风格配置,等价写法:
[model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key_env = "OPENAI_API_KEY" model_id = "你的Model ID" timeout = 60 [gateway] host = "127.0.0.1" port = 8765注意base_url末尾不要加斜杠,model_id必须和控制台里显示的完全一致,大小写都别错。
4. 启动服务与验证部署成功
4.1 放行 SmartScreen 拦截
双击Openclaw Windows一键启动.exe,会弹出“Windows 已保护你的电脑”。点【更多信息】→【仍要运行】。这是无数字签名程序的正常拦截,放行即可。
4.2 初始化与等待
进入欢迎页点【开始使用】,填入纯英文路径,点【开始安装】。程序会自动检测环境、装依赖、部署后台服务、配权限、生成桌面快捷方式。全程 3~5 分钟,期间不要关窗口。第一次启动会做完整系统初始化,等 1~3 分钟是正常的。
4.3 验证 Gateway 在线
安装结束后主界面右上角出现“Gateway 在线”,就代表部署完成。此时可以下发指令测试,比如“规整 D 盘下载目录下所有图片文件”。
4.4 用 curl 验证模型通道
想确认模型通道是否通,可以在 PowerShell 里跑一条请求:
curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的Key" \ -d '{ "model": "你的Model ID", "messages": [{"role": "user", "content": "回复:通道正常"}] }'返回里能看到choices字段和内容,就说明 Key、Base URL、Model ID 三件套都对。如果 OpenClaw 界面里 AI 能正常执行任务,同时这条 curl 也通,那整条链路就没问题了。
5. 常见报错排查对照
5.1 401 Unauthorized
最常见。原因通常是 Key 没设进环境变量、Key 复制时带了空格、或者base_url写成了带斜杠的版本。检查OPENAI_API_KEY是否重启程序后生效,base_url是否为https://taotoken.net/api。
5.2 local proxy failed
这个报错一般出现在你本地配了代理但代理没起来,或者端口被占用。先确认没有残留的代理进程,再检查gateway.port是否被别的程序占用,换个端口如 8766 重试。
5.3 reading choices 报错
返回体里读不到choices,说明请求没走到模型或返回了错误结构。多半是model_id写错,或者 Base URL 指向了错误路径。对照控制台模型列表逐字核对。
5.4 OAuth 相关报错
如果你走的是需要 OAuth 的入口,报错通常是 token 过期或回调地址不匹配。重新在控制台生成 Key,或改用 API Key 方式接入,避免 OAuth 回调的坑。
5.5 权限不足 / 文件被清除
右键程序选“以管理员身份运行”。如果文件被 Defender 清除,关闭实时监测后重新解压,再走一遍安装。
5.6 Gateway 持续离线
确认 Defender 实时监测已关、路径全英文、然后完全退出程序重新启动。三件事都做到,基本能恢复在线。
6. 后续使用与接入入口
部署完成后,日常使用就是打开桌面快捷方式,等“Gateway 在线”后下发指令。想让 OpenClaw 在复杂任务上更稳,建议把模型通道固定成 TaoToken 的兼容接口,Key 和 Base URL 一次配好,后面不用反复改。
需要新建或轮换 Key,去 https://taotoken.net/api-keys ;配置细节看文档 https://taotoken.net/doc ;想先单独试试模型效果,用模型对话 https://taotoken.net/chat ;长期跑编码和 Agent 任务,看 Coding Plan https://taotoken.net/coding-plan 。Claude Code 接入参考 https://taotoken.net/claude-code-anthropic ,控制台总入口 https://taotoken.net/console 。
最后提醒一句:装完后把 OpenClaw 安装目录加进 Defender 排除项,再把实时监测开回来,这样既不影响养虾,也不给系统留安全缺口。路径全英文、Key 别带空格、Model ID 逐字核对,这三条记住,后面基本不会再踩坑。