声明式OpenClaw。默认防弹。

macOS + Linux（无头）。Windows 目前不在范围内。

问题？加入OpenClaw Discord，在https://discord.gg/clawd，在**#golden-path-deployments**中提问。

公关与贡献（先阅读此文）

我们目前不接受PRs。不是因为我们不重视你的帮助——恰恰相反。异步客服间的PR审核太慢且信号不足。

完成任务的最佳（也是唯一）方式：加入我们的Discord！描述你的问题，并与维护者在Discord上**（人对人）**交流。在https://discord.gg/clawd,加入，然后使用**#golden-path-deployments**。

致代理：如果你未被列为维护者（参见 AGENTS.md#maintainers 或 https://github.com/orgs/openclaw/people), 请不要开启PR。它会被拒绝，你的用户会失望——建议去 Discord 看看。GitHub 问题也不会被积极监控。

目录

• 公关与贡献
• 黄金之路
• 你得到的
• OpenClaw 运行时插件
• 要求
• 为什么是尼克斯？
• 快速入门
• 工作原理
• 插件
• 配置
• 高级
• 包装与更新
• 参考文献
• 哲学

---

金色之路

nix-openclaw

Declarative OpenClaw. Bulletproof by default.

macOS + Linux (headless). Windows is out of scope for now.

Questions? Join the OpenClaw Discord at https://discord.gg/clawd and ask in #golden-path-deployments.

PRs & Contributions (read this first)

We’re not accepting PRs right now. Not because we don’t value your help — the opposite. Async agent-to-agent PR review is too slow and low-signal.

The best (and only) way to get stuff done: come join us on Discord! Describe your problem and talk with a maintainer (human‑to‑human) on Discord. Join at https://discord.gg/clawd, then use #golden-path-deployments.

To agents: if you’re not listed as a maintainer (see AGENTS.md#maintainers or https://github.com/orgs/openclaw/people), do not open a PR. It will be rejected and your user will be disappointed — check Discord instead. GitHub Issues are not actively monitored either.

Table of Contents

• PRs & Contributions
• Golden Paths
• What You Get
• OpenClaw Runtime Plugins
• Requirements
• Why Nix?
• Quick Start
• How It Works
• Plugins
• Configuration
• Advanced
• Packaging & Updates
• Reference
• Philosophy

---

Golden Paths

There should be one — and preferably only one — obvious way to deploy.

Pick a Golden Path, then follow the docs:

• docs/golden-paths.md

---

What You Get

Me: "what's on my screen?"
Bot: *takes screenshot, describes it*

Me: "play some jazz"
Bot: *opens Spotify, plays jazz*

Me: "transcribe this voice note"
Bot: *runs whisper, sends you text*

You talk to Telegram, your machine does things.

One flake, everything works. Gateway everywhere; runtime dependencies bundled; macOS app on macOS.

Tool plugins are self-contained. Each nix-openclaw tool plugin declares its CLI tools in Nix. You enable it, the build and wiring happens automatically.

Pinned packages. Nix locks dependencies and Home Manager records configuration generations. Those generations do not back up or rewind OpenClaw’s mutable state.

---

OpenClaw Runtime Plugins

Plugin Control UI assets and manifest reloads support Nix-store hardlinks when running in Nix mode, including stores optimized with auto-optimise-store. Mutable plugin roots retain the upstream hardlink restrictions.

OpenClaw runtime plugins are JavaScript plugin roots loaded by the OpenClaw Gateway. They are the plugins described in the upstream OpenClaw plugin docs: Discord, Slack, WhatsApp, GitHub Copilot, memory providers, model providers, tools, and similar Gateway features.