Nix로 OpenClaw 설치하기

새로운 도구를 설치할 때마다 환경 설정이 꼬여서 고생한 적 많으시죠? 분명 어제는 잘 작동했는데, 라이브러리 하나 업데이트했다고 전체 시스템이 멈춰버리면 정말 답답해요. 특히 여러 도구와 서비스가 복잡하게 얽혀 있는 프로젝트일수록 이런 설정 지옥에서 벗어나기가 쉽지 않습니다.

Nix를 사용하면 이런 문제를 깔끔하게 해결할 수 있습니다. OpenClaw를 Nix 환경에서 실행하는 가장 좋은 방법인 **nix-openclaw**를 소개할게요.

필요한 것

• Determinate Nix
• macOS (GUI 앱 및 패키징 사용 시)
• nix-openclaw 저장소 접근 권한

빠른 시작

가장 빠른 방법은 AI 에이전트(Claude, Cursor 등)에게 아래 프롬프트를 복사해서 전달하는 거예요. 5분 안에 설정을 마칠 수 있습니다.

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-openclaw를 사용하면 Gateway, macOS app, 그리고 Whisper나 Spotify 같은 각종 tools가 모두 고정된 버전으로 설치됩니다. 재부팅해도 살아남는 launchd 서비스와 home-manager switch --rollback을 통한 즉각적인 복구 기능도 누릴 수 있어요.

Nix Mode 설정하기

OPENCLAW_NIX_MODE=1이 설정되면 OpenClaw는 설정을 고정(deterministic)하고 자동 설치 로직을 비활성화하는 Nix 모드로 동작합니다. nix-openclaw를 쓰면 자동으로 설정되지만, 수동으로 설정하려면 환경 변수를 내보내면 됩니다.

export OPENCLAW_NIX_MODE=1

macOS GUI 앱은 쉘 환경 변수를 자동으로 상속받지 않기 때문에, 아래 명령어를 통해 Nix 모드를 활성화해야 합니다.

defaults write bot.molt.mac openclaw.nixMode -bool true

경로 설정

Nix 환경에서는 실행 시점의 상태나 설정이 불변(immutable) 스토어에 들어가지 않도록 명시적인 경로 설정이 필요합니다.

• OPENCLAW_HOME: 내부 경로 해결을 위한 기본 디렉토리
• OPENCLAW_STATE_DIR: 데이터 저장 위치 (기본값: ~/.openclaw)
• OPENCLAW_CONFIG_PATH: JSON5 설정 파일 위치 (기본값: $OPENCLAW_STATE_DIR/openclaw.json)

문제 해결

• 의존성 문제: 의존성이 누락된 경우, Nix 모드에서는 Nix 전용 해결 방법이 담긴 메시지가 표시됩니다.
• 기능 제한: Nix 모드에서는 자동 설치 및 자체 수정(self-mutation) 흐름이 작동하지 않습니다.
• UI 표시: Nix 모드가 활성화되면 UI에 읽기 전용(read-only) 배너가 나타납니다.

궁금한 점이 있나요? AI Setup Assistant에게 바로 물어보세요.

다음 단계

• nix-openclaw — 전체 설치 가이드 확인하기
• Wizard — Nix를 사용하지 않는 CLI 설정 방법
• Docker — 컨테이너 환경 설정 방법