Bien moi truong

OpenClaw lay bien moi truong tu nhieu nguon. Quy tac la khong bao gio ghi de gia tri da ton tai.

Thu tu uu tien (cao nhat den thap nhat)

Moi truong tien trinh (nhung gi tien trinh Gateway da co tu shell/daemon cha).
.env trong thu muc lam viec hien tai (mac dinh dotenv; khong ghi de).
.env toan cuc tai ~/.openclaw/.env (tuc $OPENCLAW_STATE_DIR/.env; khong ghi de).
Khoi env trong cau hinh tai ~/.openclaw/openclaw.json (chi ap dung khi thieu).
Nhap tu chon tu login shell (env.shellEnv.enabled hoac OPENCLAW_LOAD_SHELL_ENV=1), chi ap dung cho cac khoa du kien bi thieu.

Neu tep cau hinh hoan toan khong ton tai, buoc 4 bi bo qua; nhap shell van chay neu duoc bat.

Khoi `env` trong cau hinh

Hai cach tuong duong de dat bien moi truong noi tuyen (ca hai deu khong ghi de):

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

Nhap env tu shell

env.shellEnv chay login shell cua ban va chi nhap cac khoa du kien bi thieu:

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

Bien moi truong tuong duong:

OPENCLAW_LOAD_SHELL_ENV=1
OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

Bien moi truong duoc tiem vao luc chay

OpenClaw cung tiem cac danh dau ngu canh vao cac tien trinh con duoc tao:

OPENCLAW_SHELL=exec: dat cho cac lenh chay qua cong cu exec.
OPENCLAW_SHELL=acp: dat cho cac lan tao tien trinh backend ACP (vi du acpx).
OPENCLAW_SHELL=acp-client: dat cho openclaw acp client khi tao tien trinh cau noi ACP.
OPENCLAW_SHELL=tui-local: dat cho cac lenh shell cuc bo ! cua TUI.

Day la cac danh dau thoi gian chay (khong phai cau hinh nguoi dung bat buoc). Chung co the duoc su dung trong logic shell/profile de ap dung cac quy tac cu the theo ngu canh.

Bien moi truong UI

OPENCLAW_THEME=light: ep dung bang mau sang TUI khi terminal cua ban co nen sang.
OPENCLAW_THEME=dark: ep dung bang mau toi TUI.
COLORFGBG: neu terminal xuat gia tri nay, OpenClaw su dung goi y mau nen de tu dong chon bang mau TUI.

Thay the bien moi truong trong cau hinh

Ban co the tham chieu bien moi truong truc tiep trong cac gia tri chuoi cau hinh bang cu phap ${VAR_NAME}:

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

Xem Cau hinh: Thay the bien moi truong de biet chi tiet.

SecretRef vs chuoi `${ENV}`

OpenClaw ho tro hai kieu dua tren bien moi truong:

Thay the chuoi ${VAR} trong cac gia tri cau hinh.
Doi tuong SecretRef ({ source: "env", provider: "default", id: "VAR" }) cho cac truong ho tro tham chieu bi mat.

Ca hai deu duoc giai quyet tu moi truong tien trinh tai thoi diem kich hoat. Chi tiet SecretRef duoc ghi lai trong Quan ly bi mat.

Bien moi truong lien quan den duong dan

Bien	Muc dich
`OPENCLAW_HOME`	Ghi de thu muc chinh duoc su dung cho moi giai quyet duong dan noi bo (`~/.openclaw/`, thu muc dai ly, phien, thong tin xac thuc). Huu ich khi chay OpenClaw nhu nguoi dung dich vu chuyen dung.
`OPENCLAW_STATE_DIR`	Ghi de thu muc trang thai (mac dinh `~/.openclaw`).
`OPENCLAW_CONFIG_PATH`	Ghi de duong dan tep cau hinh (mac dinh `~/.openclaw/openclaw.json`).

Ghi log

Bien	Muc dich
`OPENCLAW_LOG_LEVEL`	Ghi de muc ghi log cho tep va console (vd. `debug`, `trace`). Uu tien hon `logging.level` va `logging.consoleLevel` trong cau hinh. Gia tri khong hop le bi bo qua voi canh bao.

`OPENCLAW_HOME`

Khi duoc dat, OPENCLAW_HOME thay the thu muc chinh cua he thong ($HOME / os.homedir()) cho moi giai quyet duong dan noi bo. Dieu nay cho phep cach ly hoan toan he thong tep cho cac tai khoan dich vu khong giao dien.

Thu tu uu tien: OPENCLAW_HOME > $HOME > USERPROFILE > os.homedir()

Vi du (macOS LaunchDaemon):

<key>EnvironmentVariables</key>
<dict>
  <key>OPENCLAW_HOME</key>
  <string>/Users/kira</string>
</dict>

OPENCLAW_HOME cung co the duoc dat thanh duong dan voi dau ngo (~) (vd. ~/svc), duoc mo rong bang $HOME truoc khi su dung.