Chuyển đến nội dung chính

Cài đặt Nix

Cài đặt OpenClaw một cách khai báo với nix-openclaw — một module Home Manager đầy đủ tính năng.
Kho nix-openclaw là nguồn thông tin chính xác cho việc cài đặt Nix. Trang này chỉ là một cái nhìn tổng quan nhanh.

Những gì bạn nhận được

  • Gateway + ứng dụng macOS + công cụ (whisper, spotify, cameras) — tất cả đều được cố định
  • Dịch vụ Launchd tồn tại qua các lần khởi động lại
  • Hệ thống plugin với cấu hình khai báo
  • Khả năng quay lại ngay lập tức: home-manager switch --rollback

Bắt đầu nhanh

1

Cài đặt Determinate Nix

Nếu Nix chưa được cài đặt, hãy làm theo hướng dẫn của Determinate Nix installer.
2

Tạo một flake cục bộ

Sử dụng mẫu agent-first từ kho nix-openclaw:
mkdir -p ~/code/openclaw-local
# Sao chép templates/agent-first/flake.nix từ kho nix-openclaw
3

Cấu hình secrets

Thiết lập token bot nhắn tin và khóa API của nhà cung cấp mô hình. Các file đơn giản tại ~/.secrets/ là đủ.
4

Điền vào các chỗ trống trong mẫu và chuyển đổi

home-manager switch
5

Xác minh

Xác nhận dịch vụ launchd đang chạy và bot của bạn phản hồi tin nhắn.
Xem README của nix-openclaw để biết đầy đủ các tùy chọn module và ví dụ.

Hành vi thời gian chạy của Nix Mode

Khi OPENCLAW_NIX_MODE=1 được thiết lập (tự động với nix-openclaw), OpenClaw sẽ vào chế độ xác định, vô hiệu hóa các luồng cài đặt tự động. Bạn cũng có thể thiết lập thủ công:
export OPENCLAW_NIX_MODE=1
Trên macOS, ứng dụng GUI không tự động thừa hưởng các biến môi trường shell. Thay vào đó, kích hoạt chế độ Nix qua defaults:
defaults write ai.openclaw.mac openclaw.nixMode -bool true

Những thay đổi trong chế độ Nix

  • Các luồng cài đặt tự động và tự biến đổi bị vô hiệu hóa
  • Các phụ thuộc thiếu sẽ hiển thị thông báo khắc phục cụ thể cho Nix
  • Giao diện hiển thị một biểu ngữ chế độ Nix chỉ đọc

Đường dẫn cấu hình và trạng thái

OpenClaw đọc cấu hình JSON5 từ OPENCLAW_CONFIG_PATH và lưu trữ dữ liệu có thể thay đổi trong OPENCLAW_STATE_DIR. Khi chạy dưới Nix, hãy thiết lập rõ ràng các đường dẫn này đến các vị trí được Nix quản lý để trạng thái và cấu hình thời gian chạy không nằm trong kho lưu trữ không thể thay đổi.
BiếnMặc định
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

Liên quan

  • nix-openclaw — hướng dẫn thiết lập đầy đủ
  • Wizard — thiết lập CLI không dùng Nix
  • Docker — thiết lập dạng container
Last modified on March 22, 2026