Đỗ Khắc Gia Khoa 08fd75d692 docs: hoàn thành dịch thuật toàn bộ tài liệu sang tiếng Việt

2026-01-29 03:16:42 +07:00

summary
Nơi Moltbot tải các biến môi trường và thứ tự ưu tiên của chúng

Biến môi trường (Environment variables)

Moltbot lấy các biến môi trường từ nhiều nguồn khác nhau. Quy tắc chung là không bao giờ ghi đè các giá trị hiện có.

Thứ tự ưu tiên (Cao nhất → Thấp nhất)

Tiền trình hiện tại (Process environment): Các biến mà tiến trình Gateway đã có sẵn từ bảng điều khiển (shell) hoặc dịch vụ chạy ngầm (daemon).
Tệp .env trong thư mục làm việc hiện tại: Tải mặc định qua dotenv; không ghi đè giá trị đã có.
Tệp .env toàn cục: Tại đường dẫn ~/.clawdbot/.env (hoặc $CLAWDBOT_STATE_DIR/.env); không ghi đè giá trị đã có.
Khối cấu hình env trong tệp ~/.clawdbot/moltbot.json: Chỉ áp dụng nếu biến đó chưa có giá trị.
Nhập từ bảng điều khiển đăng nhập (Shell import): (Nếu bật CLAWDBOT_LOAD_SHELL_ENV=1), chỉ áp dụng cho các khóa còn thiếu.

Có hai cách tương đương để đặt các biến môi trường ngay trong tệp cấu hình:

{
  "env": {
    "OPENROUTER_API_KEY": "sk-or-...",
    "vars": {
      "GROQ_API_KEY": "gsk-..."
    }
  }
}

Khi chế độ env.shellEnv được bật, hệ thống sẽ chạy bảng điều khiển (shell) của bạn và chỉ nhập các khóa còn thiếu:

{
  "env": {
    "shellEnv": {
      "enabled": true,
      "timeoutMs": 15000
    }
  }
}

Bạn có thể tham chiếu trực tiếp các biến môi trường trong các giá trị chuỗi của tệp cấu hình bằng cú pháp ${TÊN_BIẾN}:

{
  "models": {
    "providers": {
      "vercel-gateway": {
        "apiKey": "${VERCEL_GATEWAY_API_KEY}"
      }
    }
  }
}