Nix 설치에 관한 기준 정보는 nix-openclaw 저장소에서 확인할 수 있습니다. 이 페이지에서는 이를 간략히 살펴봅니다.
제공되는 기능
- 모두 버전이 고정된 Gateway, macOS 앱 및 도구(whisper, spotify, 카메라)
- 재부팅 후에도 유지되는 launchd 서비스
- 선언적 구성을 지원하는 Plugin 시스템
- 즉시 롤백:
home-manager switch --rollback
빠른 시작
1
Determinate Nix 설치
Nix가 아직 설치되어 있지 않다면 Determinate Nix 설치 프로그램의 안내를 따르세요.
2
로컬 flake 생성
nix-openclaw 저장소의 에이전트 우선 템플릿을 사용하세요.
3
보안 정보 구성
메시징 봇 토큰과 모델 제공업체 API 키를 설정하세요.
~/.secrets/의 일반 파일을 사용해도 됩니다.4
템플릿 자리표시자를 채우고 전환
5
확인
launchd 서비스가 실행 중이고 봇이 메시지에 응답하는지 확인하세요.
Nix 모드 런타임 동작
OPENCLAW_NIX_MODE=1이 설정되면(nix-openclaw에서는 자동 설정) OpenClaw가 Nix 관리형 설치를 위한 결정적 모드로 전환됩니다. 다른 Nix 패키지도 동일한 모드를 설정할 수 있으며, nix-openclaw가 공식 참조 구현입니다.
직접 설정할 수도 있습니다.
defaults를 통해 Nix 모드를 활성화하세요.
Nix 모드에서 변경되는 사항
- 자동 설치 및 자체 변경 흐름이 비활성화됩니다.
openclaw.json은 변경할 수 없는 파일로 취급됩니다. 시작 시 파생되는 기본값은 런타임에만 유지되며, 구성 작성 기능(설정, 온보딩, 구성을 변경하는openclaw update, Plugin 설치/업데이트/제거/활성화,doctor --fix,doctor --generate-gateway-token, `openclaw config set)은 이 파일의 편집을 거부합니다.- 대신 Nix 소스를 편집하세요. nix-openclaw에서는 에이전트 우선 빠른 시작을 따르고
programs.openclaw.config또는instances.<name>.config아래에서 구성을 설정하세요. - 종속성이 누락되면 Nix 전용 해결 안내 메시지가 표시됩니다.
- UI에 읽기 전용 Nix 모드 배너가 표시됩니다.
구성 및 상태 경로
OpenClaw는OPENCLAW_CONFIG_PATH에서 JSON5 구성을 읽고 변경 가능한 데이터를 OPENCLAW_STATE_DIR에 저장합니다. Nix에서는 런타임 상태와 구성이 변경 불가능한 저장소에 들어가지 않도록 Nix 관리형 위치를 명시적으로 설정하세요.
서비스 PATH 검색
launchd/systemd Gateway 서비스는 Nix 프로필 바이너리를 자동으로 검색하므로 Plugin과 도구에서nix로 설치된 실행 파일을 호출할 때 PATH를 직접 설정할 필요가 없습니다.
NIX_PROFILES가 설정되어 있으면 모든 항목이 오른쪽에서 왼쪽으로 우선순위를 적용해 서비스 PATH에 추가됩니다(Nix 셸 우선순위와 동일하게 가장 오른쪽 항목이 우선합니다).NIX_PROFILES가 설정되어 있지 않으면 대체 경로로~/.nix-profile/bin이 추가됩니다.
관련 항목
nix-openclaw
기준 정보인 Home Manager 모듈과 전체 설정 가이드입니다.
설정 마법사
Nix를 사용하지 않는 CLI 설정 절차입니다.
Docker
Nix를 사용하지 않는 대안인 컨테이너 기반 설정입니다.
업데이트
패키지와 함께 Home Manager 관리형 설치를 업데이트하는 방법입니다.