1. 为什么要在 conda 里折腾 openclaw小龙虾openclaw小龙虾是一个本地优先的 Agent 运行框架能接本地模型、也能接云端模型跑起来之后你可以用命令行、也可以用浏览器面板跟它对话。它要求 Node.js ≥ 22而很多同学机器上同时装着好几个 Node 版本直接全局升级容易把别的项目搞崩。用 conda 单独开一个环境把 Node 22 关在里面是最省心的做法。真正让人头疼的不是装 openclaw而是装完之后 Key 的管理。openclaw 支持一堆模型通道每个通道都要填 base_url、api_key、model 名。你要是同时用三四个工具Key 就散落在各个配置文件里改一个忘一个排查起来非常痛苦。这篇的做法是conda 负责隔离运行环境TaoToken 负责把多个模型的 Key 收敛成一把统一 Key再用一份 config.toml 骨架把通道写清楚最后用 CC Switch 切换配置做连通性验证。适合谁看本地想跑 Agent 但被 Node 版本和 Key 管理劝退的人已经装了 openclaw 但通道配置一团乱的人想用一把 Key 同时喂给 openclaw、Claude Code、其他 CLI 工具的人。下面所有命令都可以直接复制Windows 用 Anaconda Prompt 或 PowerShellmacOS/Linux 用终端。2. 前置准备conda 环境与 TaoToken 统一 Key2.1 创建 openclaw 专用 conda 环境先确认 conda 可用然后建环境。环境名就叫 openclaw和工具同名后面激活不容易记混。conda create -n openclaw nodejs22 -c conda-forge conda activate openclaw node --version npm --versionnode --version应该输出 v22.xnpm --version输出对应版本号。如果 node 版本还是旧的说明环境没激活成功检查一下终端提示符前面有没有(openclaw)。Windows 上如果后面装原生模块比如 sharp报编译错误提前把构建工具和镜像配好能省很多时间npm install --global windows-build-tools npm config set registry https://registry.npmmirror.com npm config set sharp_binary_host https://npmmirror.com/mirrors/sharp npm config set sharp_libvips_binary_host https://npmmirror.com/mirrors/sharp-libvips2.2 安装 openclaw官方推荐 npm 全局装稳定版npm install -g openclawlatest openclaw --version能打印出版本号就说明装好了。如果权限报错加--unsafe-permWindows 原生环境一般不需要。2.3 拿到 TaoToken 统一 KeyTaoToken 的作用是把多个模型的调用收敛到一个入口你只需要维护一把 Key换模型时改配置里的 model 字段就行不用到处换 Key。注册和登录走官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后在控制台创建 API Key入口在这里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentKey 的管理页面在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完复制那串 Key先存到环境变量里别直接写死在配置文件里。conda 环境下环境变量继承自系统所以设一次就行# macOS / Linux export TAOTOKEN_API_KEY你的Key # Windows PowerShell $env:TAOTOKEN_API_KEY你的Key注意环境变量只在当前终端会话有效。想永久生效macOS/Linux 写进~/.bashrc或~/.zshrcWindows 用系统「环境变量」面板添加。API 的基础地址是https://taotoken.net/api这个地址在下面 config.toml 里会用到注意它不带任何查询参数。3. config.toml 骨架配置把通道写清楚3.1 配置文件放哪openclaw 的全局配置目录默认在用户主目录下的.openclaw。Windows 是C:\Users\你的用户名\.openclaw\macOS/Linux 是~/.openclaw/。我们要动的是config.toml如果目录里没有就自己建一个。先跑一次向导生成基础结构再改配置会省事openclaw onboard向导里遇到本地模型选项可以选 skip我们后面用 config.toml 手动写通道。跑完之后确认.openclaw目录已经生成。3.2 config.toml 骨架下面这份骨架把 TaoToken 作为统一通道写进去model 字段留成占位你按需替换。注意 api_key 用环境变量引用不要明文粘贴。# ~/.openclaw/config.toml [gateway] port 18789 host 127.0.0.1 # 统一模型通道所有请求走 TaoToken [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} # 按需替换成你要用的模型名 default_model claude-sonnet-4-5 [providers.taotoken.models] # 这里列出你常用的模型切换时改 agent 的 model 引用即可 chat claude-sonnet-4-5 fast claude-haiku-4-5 [agents.main] provider taotoken model claude-sonnet-4-5 system_prompt 你是一个本地运行的助手回答尽量简洁。 [agents.coder] provider taotoken model claude-sonnet-4-5 system_prompt 你是一个编码助手给出可直接运行的代码。几个关键点解释一下。type openai-compatible表示用 OpenAI 兼容协议去请求TaoToken 的/api入口支持这种调用方式。base_url只写到/api不要在后面拼/v1之类的路径具体路径由客户端补。api_key用${TAOTOKEN_API_KEY}引用环境变量openclaw 启动时会去读。提示如果你之前配过别的 provider先注释掉避免多个通道同时生效导致请求走错地方。排查问题时最怕的就是「以为走的是 A其实走的是 B」。3.3 用 CC Switch 切换配置CC Switch 是一个配置切换工具能在多套 config 之间快速切换特别适合「公司一套、家里一套」「测试一套、正式一套」的场景。装好之后把上面这份 config.toml 存成一个 profile比如叫taotoken-main再存一份备用 profile。切换之后不需要重启整个系统但 gateway 需要重新加载配置。最稳的做法是停掉 gateway 再起# CtrlC 停掉当前 gateway然后重新启动 openclaw gateway --port 18789 --verbose如果你用的是 CC Switch 的图形界面切换完它会提示你重启相关服务照着做就行。4. 启动 Gateway 并验证请求4.1 启动 gatewaygateway 是 openclaw 的控制平面必须保持运行。前台跑方便看日志openclaw gateway --port 18789 --verbose看到监听 18789 的日志就说明起来了。端口被占用就换一个比如--port 18888同时记得改 config.toml 里的 port。4.2 发一条测试消息新开一个终端同样激活 openclaw 环境然后发消息conda activate openclaw openclaw agent --agent main --message 你好请用一句话介绍你自己如果配置正确你会看到模型返回的内容。这一步能通说明 conda 环境、openclaw、TaoToken 通道、config.toml 四者都对上了。4.3 浏览器面板验证gateway 起来后会有一个带 token 的访问链接格式类似http://127.0.0.1:18789/#token你的tokentoken 有两个获取途径。一是直接看配置文件~/.openclaw/openclaw.json找token字段二是回看openclaw onboard时的终端输出里面会有完整链接。复制到浏览器打开能在面板里发消息并收到回复就完成了端到端验证。4.4 用 curl 直接验证 TaoToken 通道想单独确认 Key 和地址没问题可以绕过 openclaw 直接打一次接口curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }返回里有正常的choices结构说明 Key 有效、地址正确。这一步能把「openclaw 配置问题」和「Key/网络问题」分开排查时非常有用。5. 本篇常见错误排查5.1 sharp 模块安装失败这是 Windows 上最高频的问题。先按 2.1 配好镜像再重装。如果还失败装 Visual C 构建工具或者干脆换 WSL2。openclaw 官方也推荐 Windows 用户走 WSL2能避开路径分隔符、权限模型、守护进程这一堆坑。5.2 端口被占用报错里会写EADDRINUSE。先查谁占了# Windows netstat -ano | findstr :18789 # macOS / Linux lsof -i :18789要么杀掉那个进程要么换端口。换端口记得同步改 config.toml 的[gateway] port。5.3 Gateway 连不上 / 面板打不开先确认 gateway 进程还在前台跑着没被 CtrlC 掉。然后确认防火墙允许 Node 进程监听端口。如果是从别的机器访问需要额外做端口转发或隧道本地回环地址127.0.0.1只能本机访问。5.4 环境变量不生效${TAOTOKEN_API_KEY}解析成空字符串请求就会 401。检查方法在同一个终端里echo $TAOTOKEN_API_KEYWindows 用echo $env:TAOTOKEN_API_KEY能打印出 Key 才说明环境变量在这个会话里可见。conda 环境不会隔离环境变量所以问题通常出在「设在了另一个终端」或者「没写进 shell 配置文件」。5.5 请求走错通道如果你配了多个 provideragent 的provider字段必须和[providers.xxx]的键名完全一致。大小写、连字符都要对上。改完配置一定要重启 gateway热加载不一定覆盖所有字段。5.6 模型名写错default_model和 agent 里的model必须是 TaoToken 支持的模型名。写错了通常返回 404 或 model not found。拿不准就先跑 4.4 的 curl把 model 换成你要用的名字试一次确认可用再写进 config.toml。6. 后续怎么用把 Key 收敛成一把环境跑通之后日常使用其实就三件事激活 conda 环境、起 gateway、发消息。Key 的管理被收敛到 TaoToken 一处换模型只改 config.toml 里的 model 字段不用再去翻每个工具的配置。如果你后面要接 Claude Code 这类编码工具可以让它复用同一把 Key接入方式看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentClaude Code 相关的接入说明在这里https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想长期跑编码任务、Agent 任务用 Coding Plan 更划算入口https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先在网页里试试模型对话效果不用装任何东西https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后给一个我踩过的坑config.toml 改完一定要重启 gateway别指望它自动重载。我有一次改完 model 字段没重启排查了半小时以为是 Key 失效结果只是进程还在用旧配置。养成「改配置 → 重启 → 发一条测试消息」的习惯能省掉大部分莫名其妙的报错。