人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载本文围绕 openclaw-cn 的 Nix 安装方案展开以 Home Manager 模块 nix-openclaw 为推荐入口完成 Gateway、macOS 应用与工具链的整体钉版安装并通过OPENCLAW_NIX_MODE1让运行期完全确定化禁用自动安装与自变更。读完本文你将掌握 nix-openclaw 的快速接入流程、Nix 模式三大环境变量的路径治理规则以及它在源码层面如何落地只读配置、跳过更新检查、禁用卸载等并能用home-manager switch --rollback一键回滚。为什么用 Nix 安装 OpenClaw对于已经使用 Nix / NixOS / Home Manager 的用户OpenClaw 官方推荐通过nix-openclaw位于 openclaw 组织下这一开箱即用batteries-included的 Home Manager 模块进行安装。与普通安装脚本相比Nix 路线的核心价值在于可复现Gateway、macOS 应用、工具whisper、spotify、cameras 等全部以 Nix 钉版pinned管理环境一致、版本可锁定可回滚声明式变更出错时一条home-manager switch --rollback即可回到上一个可用状态声明式管理插件、配置、系统服务全部纳入 Home Manager 的声明式配置不再依赖交互式向导的隐式状态。nix-openclaw 仓库是 Nix 安装的权威来源本文是它的快速总览同时结合 openclaw-cn 仓库源码进一步讲解其背后的 Nix 模式运行时行为。快速开始把安装任务交给 AI Agentnix-openclaw 的设计目标之一是让 AI 帮你装。把下面这段提示词直接粘贴给 Claude、Cursor 等 AI Agent即可完成从检测环境到验证上线的全流程I want to set up nix-openclaw on my Mac. Repository: github:openclaw/nix-openclaw What I need you to do: 1. Check if Determinate Nix is installed (if not, install it) 2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix 3. Help me create a Telegram bot (BotFather) and get my chat ID (userinfobot) 4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine 5. Fill in the template placeholders and run home-manager switch 6. Verify: launchd running, bot responds to messages Reference the nix-openclaw README for module options.这段流程覆盖了 Nix 安装的核心闭环环境检查Determinate Nix→ 基于templates/agent-first/flake.nix模板生成本地 flake → 准备 Telegram 机器人与密钥文件 → 回填模板占位符并执行home-manager switch→ 验证 launchd 常驻服务与机器人消息响应。安装完成后你会得到什么Gateway macOS 应用 工具whisper、spotify、cameras全部由 Nix 钉版管理Launchd 服务常驻运行重启后自动恢复survives reboots声明式插件系统插件加载与配置纳入 Home Manager 管理即时回滚home-manager switch --rollback。深入 Nix 模式OPENCLAW_NIX_MODE与运行期确定化当通过 nix-openclaw 安装时OpenClaw 会自动以Nix 模式运行。Nix 模式的核心目标有两个让配置变得确定deterministic并禁用自动安装流程auto-install flows。开启方式是在环境中导出环境变量OPENCLAW_NIX_MODE1在 macOS 上GUI 应用默认不会继承 shell 环境变量因此还需要通过defaults写入同样的开关defaults write bot.molt.mac openclaw.nixMode -bool true源码层面的判定逻辑Nix 模式的判定在 src/config/paths.ts 中实现逻辑非常严格——只有精确等于字符串1才视为开启export function resolveIsNixMode(env: NodeJS.ProcessEnv process.env): boolean { return env.OPENCLAW_NIX_MODE 1; }该行为的正确性由集成测试 src/config/config.nix-integration-u3-u5-u9.test.ts 专门守护用例 U3未设置、空字符串、true等取值都判定为false只有1判定为true。也就是说配置 Nix 模式时必须使用字面量1不要写成true。值得注意的另一点是守护进程的环境传递在 src/cli/daemon-cli/shared.ts 中OPENCLAW_NIX_MODE与OPENCLAW_PROFILE、OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH、OPENCLAW_GATEWAY_PORT一起被列入SAFE_DAEMON_ENV_KEYS作为守护进程启动时被安全透传的环境变量白名单。这意味着通过 nix-openclaw 拉起 Gateway 守护进程时Nix 模式标记会原样传递到子进程中。Nix 模式下的运行时行为清单开启OPENCLAW_NIX_MODE1后源码中可观察到的行为包括自动安装与自变更流程被禁用例如uninstall命令在 Nix 模式下直接拒绝卸载服务src/commands/uninstall.ts 输出Nix mode detected; service uninstall is disabled.reset命令在 Nix 模式下跳过停止 Gateway 服务步骤src/commands/reset.ts因为服务生命周期由 Nix 管理CLI 不应触碰启动时的更新检查被跳过runGatewayUpdateCheck在isNixMode为真时直接返回src/infra/update-startup.ts版本升级统一交给 Nix flake 更新而不是由运行时自更新缺失依赖给出 Nix 化提示依赖问题不再触发下载/安装而是输出可操作的 Nix 专属修复指引UI 显示只读横幅Gateway 启动日志在 Nix 模式下额外输出gateway: running in Nix mode (config managed externally)提示src/gateway/server-startup-log.ts明确告知用户配置由外部Nix管理、当前处于只读视角。配置与状态路径治理三大环境变量OpenClaw 通过三个环境变量划分配置、可变状态、基础主目录三类路径Nix 安装下需要显式设置让运行期数据始终落在 Nix 管理的可写位置之外避免写入 immutable store环境变量作用默认值OPENCLAW_HOME控制内部路径解析所依据的基础主目录按优先级取HOME/USERPROFILE/os.homedir()OPENCLAW_STATE_DIR存放可变数据会话、日志、缓存等~/.openclawOPENCLAW_CONFIG_PATHJSON5 格式配置文件路径$OPENCLAW_STATE_DIR/openclaw.json源码实现细节这些默认值并非文档约定而是实打实的源码行为见 src/config/paths.ts状态目录解析resolveStateDirL59-L85优先读取OPENCLAW_STATE_DIR兼容旧名CLAWDBOT_STATE_DIR未设置时默认~/.openclaw同时兼容历史上.clawdbot、.moltbot、.moldbot等旧状态目录的自动发现迁移配置路径解析resolveCanonicalConfigPathL114-L123优先读取OPENCLAW_CONFIG_PATH兼容CLAWDBOT_CONFIG_PATH否则落在$STATE_DIR/openclaw.json路径中的~前缀会被展开为OPENCLAW_HOME解析出的主目录resolveUserPathL87-L105因此OPENCLAW_HOME会影响所有基于主目录推导的内部路径agent 工作区、agentDir、sandbox 根等。这些规则由测试用例 U5 系列覆盖src/config/config.nix-integration-u3-u5-u9.test.ts例如设置OPENCLAW_HOME/custom/home且不覆盖状态目录时STATE_DIR解析为/custom/home/.openclaw、CONFIG_PATH解析为/custom/home/.openclaw/openclaw.json将OPENCLAW_CONFIG_PATH指向/nix/store/abc/openclaw.json时配置路径直接使用该不可变存储位置——这正是 Nix 场景下的典型用法。Nix 场景下的推荐设置在 nix-openclaw 的 flake 中建议把三者显式指到 Nix 管理的位置例如# 示意在 nix-openclaw 模块中为 Gateway 服务注入环境 environment { OPENCLAW_NIX_MODE 1; OPENCLAW_STATE_DIR /var/lib/openclaw; # 可变状态放到系统可写目录 OPENCLAW_CONFIG_PATH /etc/openclaw/openclaw.json; # 配置由 Nix 渲染生成 };这样配置文件由 Nix 生成并保持只读视角运行时产生的会话、日志、缓存则写入独立的状态目录二者互不污染也便于整体随 Nix 回滚。macOS 打包Info.plist 的确定性来源Nix 构建不依赖完整 Xcode 工具链能够产出确定性 macOS 应用包关键在于稳定的 Info.plist 模板。相关打包说明见原文档而在当前仓库 openclaw-cn 中模板实际位于 apps/macos/Sources/Clawdbot/Resources/Info.plist原文档中写的Sources/OpenClaw/Resources/Info.plist对应上游 OpenClaw 的命名openclaw-cn 中文社区版重命名后为Clawdbot打包脚本引用同一路径scripts/package-mac-app.sh 将该模板复制进 app bundle 的Contents/Info.plist并用PlistBuddy动态补齐字段CFBundleIdentifierbundle ID、CFBundleShortVersionString版本、CFBundleVersion构建号、ClawdbotBuildTimestamp构建时间戳、ClawdbotGitCommitGit SHA以及 Sparkle 更新用的SUFeedURL、SUPublicEDKey等。这种做法让 plist 对 SwiftPM 打包和 Nix 构建保持确定性——同一份模板加显式字段注入不依赖 Xcode 的隐式生成从而支撑可复现构建与多机一致部署。与其他安装方式的关系Nix 安装是 openclaw-cn 多条安装路线之一各有适用场景Nix / nix-openclaw面向 Nix/NixOS/Home Manager 用户追求可复现与回滚本文主题Wizard 向导安装docs/start/wizard.md 提供非 Nix 的交互式 CLI 引导安装适合日常快速上手Docker 容器化docs/install/docker.md 提供容器化部署适合隔离运行环境。总结Nix 路线给 OpenClawopenclaw-cn带来的不仅是装上就能用更是一整套确定化运行契约OPENCLAW_NIX_MODE1在源码层面关闭自安装、自更新、自卸载等易变行为src/config/paths.ts、src/commands/uninstall.ts、src/infra/update-startup.ts配合OPENCLAW_HOME/OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH三变量的显式路径治理让配置进入 Nix store 的只读视角、可变状态落在独立目录最终通过home-manager switch --rollback获得即时回滚能力。对追求声明式、可复现、可回滚的开发者而言这是一条值得优先考虑的安装路径。赞分享人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载相关推荐OpenClaw 的 Nix 声明式安装nix-openclaw 模块与 Nix 模式运行时行为全解析OpenClaw 的 Nix 声明式安装nix openclaw 模块与 Nix 模式运行时行为全解析 OpenClawThe AI that reallyAI 应用AI Agent交互助手后端即时通讯网关OpenClaw Nix 安装路径能力面全解claw-score Completeness 评估框架与 Nix 模式行为边界OpenClaw Nix 安装路径能力面全解claw score Completeness 评估框架与 Nix 模式行为边界 OpenClawThe AIAI 应用AI Agent交互助手后端即时通讯网关Nix-Flatpak: 扁平化应用的声明式安装指南Nix Flatpak: 扁平化应用的声明式安装指南 项目介绍 Nix Flatpak 是一个开源项目旨在通过 Nix 构建系统以声明性的方式管理 Flatp上一篇智能化一键下载国家中小学智慧教育平台电子课本高效获取方案下一篇PingFangSC字体免费开源的中文Web排版终极解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考