1. 为什么要在 Nix 环境里装 OpenClaw如果你用 macOS 做开发又恰好是那种「系统重装三次、每次都要花一晚上配环境」的人那 Nix 这套东西大概率已经在你的工具箱里了。OpenClaw 是一个把 AI 助手、消息网关、语音转写、插件系统打包在一起的运行时官方推荐在 macOS 上用 Nix 的 flake Home Manager 来管理它。原因很直接OpenClaw 依赖一堆外部工具whisper、ffmpeg、各种 provider 的 CLI手动装容易版本打架而 Nix 能把它们全部锁在一个不可变存储里home-manager switch --rollback一句话就能回滚到上一个可用状态。这篇要解决的核心问题就一个在 Nix 环境下把 OpenClaw 装起来并且把模型请求接到 TaoToken 上。适合谁看三类人一是已经装了 Determinate Nix、平时用 Home Manager 管 dotfiles 的二是想用 flake 把 OpenClaw 声明式管理、不想手动npm install -g的三是装完之后不知道 API Key 往哪填、Base URL 写哪儿的。我实测下来整个流程从零到能跑通对话大概 20 分钟其中 15 分钟在等 Nix 下载缓存。先说清楚 OpenClaw 在 Nix 下的运行逻辑。它有一个环境变量叫OPENCLAW_NIX_MODE当这个值为1时用 nix-openclaw 模块会自动设置OpenClaw 会进入确定性模式禁用所有自动安装和自我变更流程缺依赖时只给你提示不会偷偷去npm install。这个设计对 Nix 用户是好事因为 Nix 的哲学就是「所有东西都声明式、可复现」运行时乱装东西反而会破坏 store 的纯净性。但代价是你得自己把依赖和配置写进 flake。配置和状态路径这块要特别注意。OpenClaw 默认从OPENCLAW_CONFIG_PATH读 JSON5 配置默认值是$OPENCLAW_STATE_DIR/openclaw.json而OPENCLAW_STATE_DIR默认是~/.openclaw。在 Nix 模式下如果你不显式把这些路径指到 Nix 管理的目录运行时状态就会写到不可变存储区外面回滚的时候配置和状态对不上。所以下面我会把OPENCLAW_HOME、OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH三个都显式设好。还有一个 macOS 特有的坑GUI 应用不继承 shell 环境变量。也就是说你在终端里export OPENCLAW_NIX_MODE1点开 OpenClaw 的 mac 应用它还是不知道。得用defaults write ai.openclaw.mac openclaw.nixMode -bool true单独给 GUI 开。这个我踩过当时终端里跑得好好的一开 app 就提示找不到依赖查了半天才发现是环境变量没继承。2. TaoToken 前置准备拿 Key、选模型、定 Base URL在写 flake 之前先把 TaoToken 这边的准备工作做完不然配置写到一半发现没 Key 会很难受。TaoToken 的定位是 AI 模型 API 聚合网关你可以理解成「一个 Base URL 一个 Key就能调 Claude、GPT、Codex 这些模型」。对 OpenClaw 来说它就是一个 OpenAI 兼容的 provider所以配置里填的是base_url和api_key两个字段。官网是 https://taotoken.netAPI 端点统一是 https://taotoken.net/api。第一步拿 Key。访问 https://taotoken.net/api-keys登录后在控制台创建一个新的 API Key。建议按用途分开建比如「OpenClaw 本地开发」一个、「Coding Plan 长期跑」一个方便后面排查是哪个 Key 出的问题。创建完复制那串sk-开头的字符串先存到密码管理器里。第二步确认模型 ID。TaoToken 的模型列表在 https://taotoken.net/doc 里有常用的比如claude-sonnet-4-5、gpt-5、codex-mini这些。OpenClaw 的配置里要填具体的 model ID不能只写 provider 名。如果你不确定用哪个可以先在 https://taotoken.net/console 的模型对话页面试一下能正常返回再往 OpenClaw 里写。第三步想清楚你的接入方式。OpenClaw 支持两种一种是直接在openclaw.json里写 provider 配置适合快速验证另一种是通过 Home Manager 模块的services.openclaw.settings声明式注入适合长期管理。我建议先用第一种跑通确认能对话了再迁到第二种。因为 Nix 的home-manager switch每次都要重新构建调试阶段用直接写 JSON 的方式改起来快。这里有个细节要注意TaoToken 的 API 是 OpenAI 兼容格式但 OpenClaw 内部对 provider 的类型有区分。如果你填的是openai类型那base_url要写成https://taotoken.net/api/v1如果填的是anthropic类型就写https://taotoken.net/api。这个在文档里有说明但第一次配容易漏掉/v1后缀然后报 404。我建议统一用openai兼容模式省事。还有一点Key 不要硬编码在 flake.nix 里。Nix 的 flake 是可以被 git 追踪的硬编码等于把 Key 提交到仓库。正确做法是用~/.secrets/taotoken-api-key这种纯文本文件然后在 Home Manager 配置里用builtins.readFile读进来。下面第三节我会给完整写法。3. 可复制的 flake.nix 与 Home Manager 配置这一节是核心直接给能粘贴的配置。假设你的工作目录是~/code/openclaw-local先建目录mkdir -p ~/code/openclaw-local cd ~/code/openclaw-local然后创建flake.nix。这个 flake 引用了 nix-openclaw 模块并把 TaoToken 作为 provider 注入{ description OpenClaw with TaoToken on Nix; inputs { nixpkgs.url github:NixOS/nixpkgs/nixpkgs-unstable; home-manager { url github:nix-community/home-manager; inputs.nixpkgs.follows nixpkgs; }; nix-openclaw { url github:openclaw/nix-openclaw; inputs.nixpkgs.follows nixpkgs; }; }; outputs { self, nixpkgs, home-manager, nix-openclaw, ... }: let system aarch64-darwin; pkgs nixpkgs.legacyPackages.${system}; in { homeConfigurations.yourname home-manager.lib.homeManagerConfiguration { inherit pkgs; modules [ nix-openclaw.homeManagerModules.default { home.username yourname; home.homeDirectory /Users/yourname; home.stateVersion 24.11; services.openclaw { enable true; nixMode true; settings { providers { taotoken { type openai; base_url https://taotoken.net/api/v1; api_key_file ~/.secrets/taotoken-api-key; models [ claude-sonnet-4-5 gpt-5 codex-mini ]; }; }; default_provider taotoken; default_model claude-sonnet-4-5; }; environment { OPENCLAW_NIX_MODE 1; OPENCLAW_HOME /Users/yourname/.openclaw; OPENCLAW_STATE_DIR /Users/yourname/.openclaw/state; OPENCLAW_CONFIG_PATH /Users/yourname/.openclaw/openclaw.json; }; }; } ]; }; }; }几个关键点解释一下。base_url我写的是https://taotoken.net/api/v1因为type openai走的是 OpenAI 兼容协议需要/v1后缀。api_key_file指向~/.secrets/taotoken-api-key这个文件里只放 Key 本身不要有换行以外的任何东西。models数组里列的是你打算用的模型 IDOpenClaw 启动时会去校验这些 ID 是否可用。然后创建 secrets 文件mkdir -p ~/.secrets echo sk-你的TaoToken密钥 ~/.secrets/taotoken-api-key chmod 600 ~/.secrets/taotoken-api-keychmod 600是必须的不然 OpenClaw 启动时会警告权限过宽。接下来应用配置cd ~/code/openclaw-local home-manager switch --flake .#yourname第一次跑会下载一堆东西耐心等。如果卡在nix-openclaw的 fetch 阶段检查一下网络能不能访问 GitHub。跑完之后OpenClaw 的二进制应该在~/.nix-profile/bin/openclaw。如果你不想用 Home Manager只想快速试一下也可以用nix runnix run github:openclaw/nix-openclaw -- --version但这种方式不会帮你写配置只适合验证二进制能不能跑。还有一个可选步骤如果你用 Cline 或者 Claude Code 这类编辑器插件想把 OpenClaw 的网关也接进去可以在settings里加一段 MCP 配置。不过那是另一个话题了这篇先聚焦在 OpenClaw 本体。4. 验证请求从 openclaw chat 到成功返回配置应用完之后先别急着开 GUI用命令行验证最直接。第一步检查 OpenClaw 能不能识别到配置openclaw config show预期输出是一段 JSON5里面能看到providers.taotoken和default_model。如果报config not found说明OPENCLAW_CONFIG_PATH没指对回去检查 Home Manager 的environment段。第二步发一个测试请求openclaw chat --model claude-sonnet-4-5 --message 你好请回复 OK正常的话会返回类似[taotoken] claude-sonnet-4-5 OK如果返回 401说明 Key 不对或者没读到。先确认~/.secrets/taotoken-api-key里的内容没有多余空格cat ~/.secrets/taotoken-api-key | tr -d \n | wc -c正常应该是 40 多个字符。如果明显偏短说明复制的时候截断了。第三步验证流式输出。OpenClaw 默认走流式可以加--stream看效果openclaw chat --model gpt-5 --stream --message 用一句话解释 Nix预期是逐字返回。如果卡住不动多半是网络到taotoken.net的问题可以先curl一下curl -s -o /dev/null -w %{http_code} https://taotoken.net/api/v1/models \ -H Authorization: Bearer $(cat ~/.secrets/taotoken-api-key)返回 200 就说明网络和 Key 都没问题问题在 OpenClaw 配置。第四步验证 GUI。打开 OpenClaw 的 mac 应用如果之前用defaults write开了 Nix 模式应该能看到一个只读模式的横幅。然后在设置里选taotokenprovider模型选claude-sonnet-4-5发一条消息。GUI 和 CLI 走的是同一套配置CLI 通了 GUI 一般也通。第五步验证 launchd 服务。OpenClaw 在 macOS 上会注册一个 launchd 服务检查它有没有跑起来launchctl list | grep openclaw预期输出类似- 0 ai.openclaw.gateway中间那个0是退出码0 表示正常。如果是非 0用launchctl error code查原因。5. 常见报错排查401、local proxy failed、reading choices这一节列几个我实际踩过的报错对照着查。报错一401 Unauthorized最常见。原因通常是 Key 文件路径写错或者 Key 本身失效。先确认路径ls -la ~/.secrets/taotoken-api-key如果文件不存在说明api_key_file的路径没展开。Nix 的~在某些上下文里不会自动展开建议写成绝对路径/Users/yourname/.secrets/taotoken-api-key。如果文件存在但还是 401用 curl 直接测curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $(cat ~/.secrets/taotoken-api-key) \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-5,messages:[{role:user,content:hi}]}返回 401 就是 Key 的问题去 https://taotoken.net/api-keys 重新生成一个。报错二local proxy failed这个通常出现在你同时开了系统代理和 OpenClaw 的情况下。OpenClaw 会尝试走本地代理但 Nix 环境下的 launchd 服务不继承 shell 的代理设置导致连接失败。解决办法是显式在配置里禁用代理services.openclaw.settings.network { use_proxy false; };然后home-manager switch重新应用。报错三error reading choices这个报错一般出现在模型 ID 写错的时候。OpenClaw 启动时会去拉模型列表如果models数组里有一个不存在的 ID就会报reading choices失败。解决办法是先把models数组清空只留default_model跑通之后再逐个加回来。或者直接用 curl 拉一下可用模型curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $(cat ~/.secrets/taotoken-api-key) | jq .data[].id报错四OAuth token expired如果你之前用 OAuth 方式登录过 OpenClaw切到 TaoToken 之后旧的 OAuth token 可能还在缓存里。清一下rm -rf ~/.openclaw/state/oauth openclaw config reload报错五home-manager switch报 hash mismatch这个通常是nix-openclaw的 flake.lock 过期了。在项目目录里跑nix flake update nix-openclaw home-manager switch --flake .#yourname如果还不行检查flake.nix里nix-openclaw的inputs.nixpkgs.follows有没有写对。6. 长期跑把 OpenClaw 接进 Coding Plan跑通之后如果你打算长期用 OpenClaw 做编码助手建议把模型切到 Coding Plan 的专用端点。TaoToken 的 Coding Plan 在 https://taotoken.net/coding-plan 有说明它针对高频代码补全做了优化延迟比通用端点低。配置上只需要改base_urlservices.openclaw.settings.providers.taotoken.base_url https://taotoken.net/api/v1/coding;然后home-manager switch重新应用。验证方式和之前一样openclaw chat --model claude-sonnet-4-5看返回速度。如果你同时用 Claude Code 或者 Cline可以把 OpenClaw 的网关地址填到它们的 MCP 配置里。具体路径在 https://taotoken.net/doc 的「编辑器接入」章节有。不过要注意MCP 直连生产库这种事别干本地开发环境随便接。最后提醒一句home-manager switch --rollback是你的好朋友。每次改配置之前先确认当前 generation 是好的改崩了一句话回滚home-manager generations home-manager switch --rollback我一般会在改配置前先home-manager switch一次确保当前状态是干净的这样回滚点就是可用的。