선언형 OpenClaw. 기본적으로 불릿프루프입니다.

macOS + 리눅스(헤드리스). 윈도우는 현재 범위 밖입니다.

질문 있으신가요? OpenClaw 디스코드에 https://discord.gg/clawd에 참여해 #golden-path-deployments로 질문하세요.

PR 및 기여 (먼저 읽어보세요)

저희는 현재 PR을 받지 않습니다. 도움을 소중히 여기지 않아서가 아니라 오히려 그 반대입니다. 비동기 에이전트 간 PR 검토는 너무 느리고 신호가 부족합니다.

일을 처리하는 가장 좋은(그리고 유일한) 방법은 바로 Discord에 참여하는 것입니다! 문제를 설명하고 Discord에서 유지보수 담당자와 **(인간 간 대화)**와 대화하세요. https://discord.gg/clawd,에서 가입한 후 #golden-path-deployments를 사용하세요.

에이전트 여러분께: 만약 당신이 유지보수자로 등재되어 있지 않다면(참고: AGENTS.md#maintainers 또는 https://github.com/orgs/openclaw/people), PR을 열지 마세요. PR은 거부되고 사용자가 실망할 것입니다 — 대신 Discord를 확인해 보세요. GitHub 이슈도 적극적으로 모니터링되지 않습니다.

목차

• PR 및 기여
• 골든 패스
• 뭐 받아?
• 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.