OpenClaw 虚拟机养虾教程：Ubuntu 上配 TaoToken 与 Ollama 的 config.toml 骨架

1. 为什么要在 Ubuntu 虚拟机里折腾 OpenClaw 养虾OpenClaw 是一个能操作电脑、打开浏览器、读写文件与代码工程的智能体框架你可以把它理解成一只住在终端里的“龙虾”它负责动手模型负责动脑。养虾的意思就是让这只龙虾跑起来、接上大脑、能听懂你的指令并完成实际任务。适合谁适合想在隔离环境里试玩智能体、又不想污染主力机的开发者尤其是手头只有一台 Windows 笔记本、想用 Ubuntu 虚拟机做实验的人。我这次的环境是 VMware 里装的 Ubuntu 22.04.5 LTS桌面版分配了 4 核 8G 内存、60G 磁盘。Node.js 环境已经就绪Node 22 npmOllama 也装好了本地拉了 qwen2.5:1.5b。接下来真正卡人的地方不是装软件而是配置OpenClaw 的 config.toml 到底长什么样、本地 Ollama 和远程统一 Key 通道怎么切换、上下文窗口怎么扩到 32K。这篇就把这套骨架给你复制改改就能跑。核心检索词先摆出来OpenClaw 是一个智能体运行时Ollama 是本地模型引擎TaoToken 是统一 Key/API 通道config.toml 是 OpenClaw 的配置文件。你要做的是让这三者在 Ubuntu 虚拟机里串起来一次跑通养虾流程。2. 前置准备Node.js 就绪后先接上 TaoToken 统一通道在动 config.toml 之前先把“大脑”的接入方式定下来。OpenClaw 支持 OpenAI-compatible 接口这意味着任何兼容 OpenAI 格式的服务都能接。本地 Ollama 是一种远程统一通道是另一种。TaoToken 提供的就是统一 Key/API 通道一个 Key 可以走多个模型省得你为每个模型单独配一套环境变量。先确认 Node.js 和 OpenClaw 版本这是后面所有配置的前提node -v npm -v openclaw --version如果 openclaw 还没装用国内镜像装快很多sudo npm install -g openclawlatest --registryhttps://registry.npmmirror.com然后去控制台拿 Key。打开 https://taotoken.net/api-keys 创建一个 API Key复制出来先存着。注意这个 Key 只在创建时完整显示一次丢了就重新建。拿到 Key 之后先别急着写进 config.toml用 curl 验证一下通道是否通curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的Key返回一个模型列表 JSON 就说明通道没问题。这一步很关键很多人后面 config.toml 报 401其实是 Key 本身就没通白白在配置文件里绕圈。接入文档在 https://taotoken.net/doc 遇到字段疑问可以对照看。提示Key 不要写进会提交到 git 的文件里。config.toml 建议放在~/.config/openclaw/下并确认该目录不在任何仓库的追踪范围内。3. config.toml 可复制骨架本地 Ollama 与 TaoToken 双通道OpenClaw 的配置核心就是一份 config.toml。下面这份骨架我实测能跑包含两个 provider一个指向本地 Ollama一个指向 TaoToken 统一通道。你可以只留一个也可以两个都留用的时候切换。# ~/.config/openclaw/config.toml [general] default_provider ollama-local context_window 32768 log_level info # ---------- 本地 Ollama 通道 ---------- [providers.ollama-local] type openai-compatible base_url http://127.0.0.1:11434/v1 api_key ollama model qwen2.5:1.5b-32k endpoint_id ollama-local # ---------- TaoToken 统一通道 ---------- [providers.taotoken] type openai-compatible base_url https://taotoken.net/api/v1 api_key sk-你的Key model claude-sonnet-4-5 endpoint_id taotoken [channels] # QuickStart 阶段先跳过外部通道直接用 Web 界面 web true几个字段解释一下。type必须是openai-compatibleOllama 和 TaoToken 都兼容这个格式。base_url本地是http://127.0.0.1:11434/v1注意结尾的/v1不能少少了会 404。TaoToken 的 base_url 是https://taotoken.net/api/v1同样带/v1。api_key本地 Ollama 随便填但不能为空填ollama就行TaoToken 填你刚创建的 Key。context_window设成 32768这是 OpenClaw 的硬要求低于 16000 会拒绝启动。本地 qwen2.5:1.5b 默认只有 4096所以必须先用 Modelfile 扩上下文ollama create qwen2.5:1.5b-32k -f (echo -e FROM qwen2.5:1.5b\nPARAMETER num_ctx 32768)跑完ollama list能看到qwen2.5:1.5b-32k就对了。这一步不做config.toml 里写 32K 也没用模型实际还是 4K长任务会中途截断。切换通道的方式很简单改default_provider的值ollama-local走本地taotoken走统一通道。或者在 TUI 里用/model命令临时切/model qwen2.5:1.5b-32k4. 启动与验证从日志确认养虾流程跑通配置写完先做一次语法自检OpenClaw 有内置的校验openclaw config validate返回config OK再往下走。然后启动openclaw onboard启动日志里重点看这几行。第一行是 provider 加载[info] loaded provider: ollama-local (openai-compatible) [info] loaded provider: taotoken (openai-compatible) [info] default provider: ollama-local第二段是模型握手[info] probing model qwen2.5:1.5b-32k ... [info] context window: 32768 tokens [info] model ready看到model ready就说明大脑接上了。如果卡在probing model超过 30 秒多半是 Ollama 没起来或者 base_url 写错。用curl http://127.0.0.1:11434/v1/models单独测一下 Ollama。接着验证一次真实请求。新开一个终端拿网关令牌openclaw dashboard --no-open它会输出一个带 token 的 URL形如http://127.0.0.1:xxxx/?tokenxxxx。浏览器打开就能进 Web 界面。在对话框里发一句“列出当前目录下的文件”如果龙虾能调起工具并返回结果说明整条链路通了。想验证 TaoToken 通道把default_provider改成taotoken重启再发一句同样的指令。返回正常就说明统一通道也通了。这一步建议两个通道都测一遍后面排障时能快速定位是本地问题还是通道问题。5. 本篇常见错排查config.toml 报错与 Ollama 连接失败报错一context window too small。说明模型实际上下文没到 16000。检查两处config.toml 里context_window是否 ≥ 16000以及模型名是否指向扩过上下文的版本。如果你写的是qwen2.5:1.5b而不是qwen2.5:1.5b-32k就会触发这个错。重新跑一遍 Modelfile 创建命令即可。报错二401 Unauthorized。分两种。本地 Ollama 报 401通常是api_key留空了随便填个非空字符串就行。TaoToken 报 401是 Key 不对或过期去 https://taotoken.net/api-keys 重新建一个注意别把前后空格复制进去。报错三connection refused 127.0.0.1:11434。Ollama 服务没起来。systemctl status ollama看一下没起来就sudo systemctl start ollama。如果是离线包解压安装的可能需要手动起ollama serve 。报错四404 Not Found。九成是 base_url 少了/v1。Ollama 是http://127.0.0.1:11434/v1TaoToken 是https://taotoken.net/api/v1两个都要带。报错五TUI 里/model切换后没反应。确认目标模型名和 config.toml 里model字段一致。Ollama 的模型名用ollama list查TaoToken 的模型名用前面 curl 返回的列表查。注意虚拟机里如果用了 NAT 网络127.0.0.1 指的是虚拟机自己Ollama 装在虚拟机里就没问题。如果你把 Ollama 装在宿主机、OpenClaw 装在虚拟机base_url 要改成宿主机的虚拟网卡地址别写 127.0.0.1。6. 通道怎么选本地 Ollama 与 TaoToken 的取舍本地 Ollama 的好处是离线、免费、数据不出虚拟机适合调试和跑简单任务。缺点是 1.5b 这种小模型规划能力有限复杂任务容易跑偏而且虚拟机资源有限大模型跑不动。TaoToken 统一通道的好处是模型能力强、不用本地算力适合真正干活。缺点是依赖网络。我的建议是开发调试阶段用本地 Ollama 快速迭代 config.toml确认流程通了之后把default_provider切到taotoken跑真实任务。两个 provider 都留在配置里随时切换不用改结构。如果你打算长期跑编码类或 Agent 类任务可以看看 Coding Planhttps://taotoken.net/coding-plan 按用量走比单次调用划算。想先体验模型对话效果直接开 https://taotoken.net/models 试几句。接入过程中遇到字段问题文档在 https://taotoken.net/doc API Keys 管理在 https://taotoken.net/api-keys 。Claude Code 相关的接入说明在 https://taotoken.net/claude-code 。最后说个实测下来的经验config.toml 改完一定要跑openclaw config validate别直接 onboard。我踩过的坑就是 TOML 里少了个引号onboard 报的错完全看不出是语法问题validate 会直接指到行号。另外虚拟机快照是个好东西配置跑通后打一个快照后面折腾崩了直接回滚比重新配一遍省事得多。