openclaw-mission-control/backend/app/core/config.py

from __future__ import annotations

from pathlib import Path
from typing import Self

from pydantic import model_validator
from pydantic_settings import BaseSettings, SettingsConfigDict

BACKEND_ROOT = Path(__file__).resolve().parents[2]
DEFAULT_ENV_FILE = BACKEND_ROOT / ".env"


class Settings(BaseSettings):
    model_config = SettingsConfigDict(
        # Load `backend/.env` regardless of current working directory.
        # (Important when running uvicorn from repo root or via a process manager.)
        env_file=[DEFAULT_ENV_FILE, ".env"],
        env_file_encoding="utf-8",
        extra="ignore",
    )

    environment: str = "dev"
    database_url: str = "postgresql+psycopg://postgres:postgres@localhost:5432/openclaw_agency"
    redis_url: str = "redis://localhost:6379/0"

    # Clerk auth (auth only; roles stored in DB)
    clerk_jwks_url: str = ""
    clerk_verify_iat: bool = True
    clerk_leeway: float = 10.0

    cors_origins: str = ""
    base_url: str = ""

    # Optional: local directory where the backend is allowed to write "preserved" agent
    # workspace files (e.g. USER.md/SELF.md/MEMORY.md). If empty, local writes are disabled
    # and provisioning relies on the gateway API.
    #
    # Security note: do NOT point this at arbitrary system paths in production.
    local_agent_workspace_root: str = ""

    # Database lifecycle
    db_auto_migrate: bool = False

    # Logging
    log_level: str = "INFO"
    log_format: str = "text"
    log_use_utc: bool = False

    @model_validator(mode="after")
    def _defaults(self) -> Self:
        # In dev, default to applying Alembic migrations at startup to avoid schema drift
        # (e.g. missing newly-added columns).
        if "db_auto_migrate" not in self.model_fields_set and self.environment == "dev":
            self.db_auto_migrate = True
        return self


settings = Settings()