1. 为什么我选择在 VMware 里跑 OpenClaw
OpenClaw 是一个本地优先的 AI 工具运行环境,你可以把它理解成一个「装在自己电脑里的 AI 工作台」:它把模型调用、会话管理、工具链编排都收拢到一个本地服务里,浏览器打开127.0.0.1就能用。适合谁?适合想快速搭一套本地 AI 环境、又不想把整台物理机折腾成实验场的开发者,尤其是手上有游戏本或台式机、内存和 CPU 都比较宽裕的人。
但直接在物理机上装 OpenClaw 有个现实问题:依赖冲突。你机器上可能已经有一堆 Python 版本、Node 版本、各种环境变量,装完 OpenClaw 之后别的项目可能就跑不起来了。所以我更推荐用 VMware 虚拟机隔离出一套干净环境,装完即用,坏了直接删掉重来,不影响宿主机。
这篇要交付的是:在 VMware 里导入一个已经预装好 OpenClaw 的 Win10 镜像,然后用三条命令完成模型接入和网关启动,并且把 TaoToken 的统一 Key/API 通道接进去,让 OpenClaw 能直接调用模型。整个过程不需要你从零编译,也不需要手动配一堆依赖。
先说清楚硬件门槛,避免你白忙一场:宿主机至少留 60G 闲置磁盘空间(虚拟机文件本身就不小),处理器建议 16 核以上,也就是游戏本和台式机比较稳,轻薄本跑起来会非常吃力,导入和首次启动都可能卡到你想砸键盘。这不是吓唬人,是实测下来的经验。
2. 前置准备:TaoToken 统一 Key 与 API 通道
OpenClaw 本身只是个运行框架,它要真正干活,得接一个模型通道。这里我用 TaoToken 来做统一接入,原因是它把 Key 管理和 API 通道收敛到一处,OpenClaw 里只需要填一个地址和一个 Key,不用为每个模型单独配一遍。
你需要先拿到两样东西:一个是 API Key,一个是 API 基础地址。Key 在控制台的 API Keys 页面创建,地址固定用https://taotoken.net/api,注意这个地址后面不要带任何多余路径,OpenClaw 会自己在后面拼具体端点。
创建 Key 的入口在这里:
API Keys 管理:https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
进去之后点新建,复制出来的 Key 一般长这样:sk-开头的一串字符。把它先存到记事本里,后面配置要用。如果你还没注册,官网入口是https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=,注册完再回到 API Keys 页面即可。
这里有个容易踩的坑:很多人拿到 Key 之后直接往 OpenClaw 的模型配置里塞,但忘了改base_url,结果请求还是打到默认地址上,报 401 或者连接超时。所以下面配置骨架里,我会把base_url和api_key放在一起写,你照着填就不会漏。
另外提醒一句,TaoToken 在这里的角色是「统一模型通道」,不是让你绕过什么限制,它就是个正常的 API 聚合入口,OpenClaw 通过它调用模型,和你平时用 SDK 调 API 是一回事。
3. 三条命令完成 OpenClaw 安装与接入
镜像导入的部分我先快速带过,因为真正核心的是后面三条命令。下载好Windows 10 with openclaw.ovf之后,双击它,VMware 会让你选一个保存虚拟机文件的文件夹,这个文件夹所在磁盘至少要有 60G 可用空间,然后给虚拟机起个名字,点导入。导入完成后第一次开机可能会很卡,这是正常的,因为虚拟磁盘文件很大,重启一次 VMware 或者重启宿主机,第二次打开就顺畅了。
开机后你会看到一个终端框,这说明 OpenClaw 已经在虚拟机里了。接下来右键开始菜单,打开「管理员终端」,我们开始三条命令。
第一条,登录模型通道并设为默认:
openclaw models auth login --provider qwen-portal --set-default这条命令会拉起浏览器,让你登录账号完成授权。登录成功后回到终端,继续第二条:
openclaw dashboard这条会启动 OpenClaw 的仪表盘服务,终端里会打印出访问地址,一般是http://127.0.0.1:18789。先别急着关这个终端,它得一直开着。
第三条,启动网关:
openclaw gateway start这条命令会额外弹出一个终端窗口,OpenClaw 的服务就跑在这个窗口里。记住:这个窗口一关,OpenClaw 服务就停了。如果执行后 5 分钟还没反应,或者浏览器打不开,直接Ctrl+C掐掉这个进程,然后重新执行一次openclaw gateway start,通常第二次就正常了。
三条命令跑完,浏览器访问:
http://127.0.0.1:18789/chat?session=main能看到聊天界面,就说明装好了。你可以直接让它写点东西测试,比如「帮我写一首诗放到桌面」,它会调用模型生成并落盘。
那 TaoToken 的 Key 在哪里接进去?OpenClaw 的模型配置支持自定义 provider,你可以在配置目录里找到模型配置文件,把base_url指向 TaoToken 的 API 地址,api_key填你创建的那串 Key。配置骨架大概是这样:
{ "provider": "taotoken", "base_url": "https://taotoken.net/api", "api_key": "sk-你的Key", "model": "qwen-plus", "timeout": 60 }把这段填进 OpenClaw 的模型配置后,重启一次 gateway,OpenClaw 就会走 TaoToken 通道调用模型。如果你更习惯用命令行验证通道是否通,可以单独发一条测试请求:
curl https://taotoken.net/api/v1/models \ -H "Authorization: Bearer sk-你的Key"返回模型列表就说明 Key 和通道都没问题。这一步能帮你把「OpenClaw 配置问题」和「Key 问题」分开定位,省得混在一起排查。
4. 验证请求:确认 OpenClaw 真的能调用模型
装完不等于能用,必须做一次端到端验证。我一般分两步:先验证 TaoToken 通道本身通不通,再验证 OpenClaw 能不能通过这个通道拿到模型回复。
第一步就是上面那条curl,返回 JSON 里能看到data数组,里面是一堆模型 id,说明通道正常。如果返回 401,检查 Key 有没有复制全、有没有多余空格;如果返回 404,检查base_url是不是写成了https://taotoken.net/api/带了尾斜杠,去掉尾斜杠再试。
第二步在 OpenClaw 里发一条真实请求。打开http://127.0.0.1:18789/chat?session=main,输入「用一句话说明你现在用的是哪个模型」,如果它能正常回复,并且你在 gateway 那个终端窗口里能看到请求日志,就说明整条链路通了。
这里有个细节:OpenClaw 的会话是按session参数隔离的,session=main是默认主会话。如果你发现回复很慢,先看 gateway 窗口有没有报错,再看 TaoToken 控制台的调用记录,两边对照就能定位是网络慢还是模型本身慢。
验证通过后,你可以把常用模型设成默认,这样每次新建会话不用再选。配置里model字段填你常用的那个 id 就行。实测下来,把timeout设成 60 秒比较稳,太短容易在长回复时被掐断。
5. 本篇常见错误排查
错误一:openclaw gateway start卡住无响应。这是最高频的问题,原因通常是端口被占用或者上一次进程没退干净。解决办法:Ctrl+C终止当前命令,然后执行openclaw gateway stop清理残留,再重新start。如果还不行,重启虚拟机,第二次基本都能起来。
错误二:浏览器打不开127.0.0.1:18789。先确认openclaw dashboard那个终端还开着,它关了服务就没了。再确认你访问的是虚拟机内部的地址,如果你在宿主机浏览器访问,需要做端口转发,VMware 里把 18789 映射出来。最省事的做法是直接在虚拟机里用浏览器访问。
错误三:模型请求报 401 或 403。九成是 Key 问题。检查api_key有没有带sk-前缀、有没有换行符混进去。另外确认base_url是https://taotoken.net/api,不要写成别的路径。如果 Key 刚创建,等十几秒再试,有时候有短暂生效延迟。
错误四:导入镜像后第一次开机极卡。这是虚拟磁盘太大导致的,不是坏了。重启 VMware 或者重启宿主机,第二次打开就正常。别在第一次卡顿的时候强行关机,容易损坏虚拟磁盘。
错误五:openclaw models auth login没弹出浏览器。手动复制终端里打印的 URL,粘贴到虚拟机内的浏览器打开。如果虚拟机没装浏览器,先在虚拟机里装一个,或者把授权链接复制到宿主机完成登录,再把回调地址贴回终端。
错误六:磁盘空间不足导致导入失败。虚拟机文件解压后可能超过 60G,选保存文件夹的时候一定要确认所在磁盘有足够空间,别选到系统盘快满的分区。
6. 后续怎么用:把 OpenClaw 接进你的日常流程
装好只是起点。如果你打算长期用 OpenClaw 做编码辅助或者跑 Agent 任务,建议把模型通道固定成 TaoToken,这样换模型只改一个model字段,不用动 Key 和地址。需要长期编码或 Agent 场景的,可以看下 Coding Plan 的入口:
Coding Plan:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
如果你只是想先验证模型对话效果,直接用模型对话页面就行:
模型对话:https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
接入过程中遇到配置问题,对照接入文档查参数最准:
接入文档:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
最后给你一个实用技巧:把三条命令写成一个start.sh脚本放在桌面,每次开机双击就跑,省得一条条敲。脚本内容就是openclaw dashboard和openclaw gateway start两行,auth login只需要第一次跑。这样你每天打开虚拟机,几秒钟就能进入工作状态。