Minara 코어

`MINARA_API_KEY`

Minara 백엔드 API 자격 증명.

제어 대상: 에이전트가 Minara REST 인터페이스(portfolio, swap, perps, autopilot, workflow, analytics)로 수행하는 모든 호출.
사용처: src/app.ts 를 통해 src/minara/client.ts, src/minara/read-client.ts, src/minara/safe-trading-client.ts.
설정 시점: device-flow JWT 를 사용할 수 없는 비대화형 컨텍스트(CI, Docker, workflow 엔진)에서 실행하는 경우입니다.
미설정 시: 게이트웨이는 $MINARA_DATA_DIR/credentials.json (llm 슬롯)에서 저장된 device-flow JWT 를 찾습니다 (먼저 minara auth login minara 를 실행하세요). 둘 다 없으면 에이전트는 Minara 호출을 거부합니다.
형식: Minara 대시보드에서 발급하는 불투명 문자열.
설정 위치: 사용자 대상 설정 아님

`MINARA_BASE_URL`

Minara API 기본 URL 재정의.

제어 대상: 모든 Minara HTTP 클라이언트가 가리키는 origin 이며, OAuth /v1/oauth/authorize 리디렉션 대상도 포함합니다 (이는 다시 사용자를 동일 브랜드의 동의 페이지로 넘깁니다 — dev 백엔드를 가리키면 사용자는 dev 동의 UI 를 보게 됩니다).
사용처: apps/agent/src/gateway/server.ts, apps/agent/src/gateway/auth-cli.ts, apps/agent/src/minara/client.ts, apps/agent/src/app.ts.
설정 시점: 자체 호스팅 인스턴스, 스테이징 백엔드, 또는 로컬 mock(apps/agent/tests/fakes/mock-minara-server.ts 참조)을 가리키는 경우입니다.
미설정 시: 기본값은 prod origin https://api.minara.ai 입니다 (CLI 의 DEFAULT_MINARA_BASE_URL 상수와 일치).
형식: 절대 URL, 끝에 슬래시 없음.
설정 위치: 사용자 대상 설정 아님

`MINARA_FRONTEND_BASE_URL`

Minara 웹 프론트엔드 기본 URL.

제어 대상: 터미널 OSC 8 하이퍼링크와 deep-research HTML 보고서에서
token:// / address:// 커스텀 URI 스킴이 해석되는 URL 입니다.
데스크톱 OAuth 성공 페이지 주소에도 사용되며,
해당 경로는 /oauth/desktop/success 입니다. 또한 향후
minara_open_pricing_page / _topup_page / _subscription_page 도구에도 공급됩니다.
사용처: apps/agent/src/config/frontend-url.ts (apps/agent/src/gateway/api.ts, apps/agent/src/gateway/render/uri-rewrite.ts 및 apps/agent/src/deep-research/report-renderer.ts 에서 읽음).
설정 시점: prod(https://minara.ai)로 배포하거나 로컬 Next.js dev 서버를 대상으로 실행하는 경우입니다.
미설정 시: 기본값은 https://minara.ai 입니다.
형식: 절대 URL, 끝에 슬래시 없음.
설정 위치: 사용자 대상 설정 아님

`MINARA_DATA_DIR`

영속 상태 디렉터리.

제어 대상: SQLite 데이터베이스, 샌드박스 파일 감옥, auth 프로필, 감사 로그, 생성된 문서가 저장되는 위치입니다.
사용처: apps/agent/src/gateway/cli.ts, apps/agent/src/app.ts, apps/agent/src/tools/_shared/sandbox.ts.
설정 시점: ~ 가 비영속 경로로 매핑되는 Docker / systemd 에서 실행하거나, 여러 에이전트 프로필을 나란히 유지하려는 경우입니다.
미설정 시: 기본값은 ~/.minara 입니다.
형식: 절대 파일시스템 경로. 없으면 첫 부팅 시 생성됩니다.
설정 위치: 사용자 대상 설정 아님

`MINARA_TERMINAL_CWD`

에이전트 작업 디렉터리 재정의.

제어 대상: 에이전트가 사용자 파일을 읽고/쓰며 셸 명령을 실행하는 cwd 입니다. 해석 순서: 세션별 재정의(런타임에 /cwd 로 설정) → 이 변수 → process.cwd().
사용처: apps/agent/src/agent/runtime-cwd.ts (resolveAgentCwd).
설정 시점: 실행 디렉터리가 의도한 작업 디렉터리가 아니라 설치 디렉터리인 gateway/cron 진입점입니다. 로컬 CLI 는 보통 이를 설정하지 않고 셸 cwd 로 폴백합니다.
미설정 시: process.cwd()(에이전트 프로세스가 실행된 디렉터리)로 폴백합니다.
형식: 실제 디렉터리의 절대 경로. 존재하지 않는 경로는 무시되고 해석은 process.cwd() 로 넘어갑니다.
설정 위치: 사용자 대상 설정 아님

`MINARA_BACKGROUND_MODELS_ENABLED`

MINARA_BACKGROUND_MODELS_ENABLED: 백그라운드 작업 모델의 기본 상태.

제어 대상: 제목, 압축, 무인 작업이 설정에서 지정한 모델을 사용할지 제어합니다. 채팅은 선택한 모델을 유지합니다.
사용처: apps/agent/src/config/preferences/schema.ts 및 apps/agent/src/llm/model-routing-service.ts.
설정 시점: 배포에서 백그라운드 작업 모델을 기본으로 켜거나 끄려는 경우입니다. 저장된 사용자 설정이 우선합니다.
미설정 시: 기본으로 활성화됩니다. Minara 제공자가 활성 상태일 때만 적용됩니다.
형식: 불리언 값입니다. 참은 1, true, yes, on, 거짓은 0, false, no, off를 허용합니다.
설정 위치: 설정 → 환경설정 (schema 키)

`MINARA_FINANCIAL_SAFETY_ENABLED`

MINARA_FINANCIAL_SAFETY_ENABLED: 금융 안전 알림의 기본 상태.

제어 대상: 사용자가 시작한 Chat Agent Loop에 고위험 지출, 거래 위험 확대, 사기, 강요 및 신체 안전 위기를 다루는 금융 안전 스킬을 등록할지 제어합니다. 백그라운드 자동화와 Subagent에는 주입되지 않습니다.
사용처: apps/agent/src/config/preferences/schema.ts, apps/agent/src/guardrail/service.ts 및 apps/agent/src/app.ts.
설정 시점: 배포에서 금융 안전을 기본으로 끄려면 false로 설정합니다. Personalization에 저장된 사용자 선택이 우선합니다.
미설정 시: 기본값은 켜짐입니다. Personalization → 금융 안전에서 끌 수 있습니다.
형식: 불리언 값입니다. 참은 1, true, yes, on, 거짓은 0, false, no, off를 허용합니다.
설정 위치: 설정 → 환경설정 (schema 키)

`MINARA_AUTO_MODEL_STRATEGY`

MINARA_AUTO_MODEL_STRATEGY: 대화 Auto의 기본 매핑.

제어 대상: Auto를 골랐을 때 메시지 난이도 구간을 고정 Minara 카탈로그 모델에 맞춥니다. SIMPLE/MEDIUM은 DeepSeek V4 Flash 0731(비전/PDF가 필요하면 Sonnet 5). economy COMPLEX는 GLM 5.2, REASONING은 Kimi K3. balanced COMPLEX는 GPT-5.6 Terra, REASONING은 GPT-5.6 Sol. quality SIMPLE/MEDIUM은 Sonnet 5, COMPLEX는 GPT-5.6 Sol, REASONING은 Opus 5. custom은 quality를 기본값으로 사용하고 변경한 매핑을 저장합니다. 백그라운드 작업 모델은 바뀌지 않습니다.
사용처: apps/agent/src/config/preferences/schema.ts 및 apps/agent/src/llm/auto-model.ts.
설정 시점: Auto를 기본적으로 더 아끼거나 더 강하게 쓰고 싶을 때입니다. 저장된 사용자 설정이 우선합니다. 이 줄은 Auto를 고른 뒤에만 나타납니다.
미설정 시: 기본값은 balanced입니다.
형식: economy, balanced, quality 또는 custom. custom은 quality에서 시작하며 변경한 매핑은 설정에 저장됩니다.
설정 위치: 설정 → 환경설정 (schema 키)

`MINARA_DEFAULT_MODEL`

초기 에이전트 모델 id.

제어 대상: 대화형 채팅에 사용하는 기본 모델 id입니다. 백그라운드 작업 모델이 켜져 있으면 제목, 압축, 무인 작업은 설정에서 지정한 모델을 사용할 수 있으며 채팅은 이 모델을 유지합니다.
사용처: apps/agent/src/app.ts (createApp 모델 해석 체인).
설정 시점: ~/.minara/settings.json 에 저장된 모델 pin 이 활성 제공자에 대해 잘못된 경우입니다 — 예를 들어 OPENROUTER_API_KEY 만 구성되어 있는데 저장된 id 가 Anthropic 네이티브 claude-sonnet-4-6 이고, OpenRouter 는 이를 400 으로 거부하는 경우입니다 (OpenRouter 명명은 anthropic/claude-sonnet-4.5). 웹 UI 의 Settings → Model 선택기가 장기적인 해답이며, 이 환경 노브는 프로세스 수명 동안의 재정의입니다.
미설정 시: 저장된 defaultModel.model, 그다음 하드코딩된 claude-sonnet-4-6 으로 넘어갑니다.
형식: 모델 id 문자열. OpenRouter 의 경우 접두사가 붙은 이름(anthropic/claude-sonnet-4.5, openai/gpt-5, google/gemini-2.5-pro 등)을 사용합니다. Anthropic 네이티브의 경우 접두사 없는 id(claude-sonnet-4-6, claude-opus-4-7, claude-haiku-4-5-20251001)를 사용합니다. 해석 순서(먼저 비어 있지 않은 값이 이김): config.model(프로그래밍 방식) > MINARA_DEFAULT_MODEL(이 변수) > 저장된 선택 > 하드코딩된 기본값.
설정 위치: 사용자 대상 설정 아님

`AGENT_MAX_ITERATIONS`

턴당 최대 도구 호출 루프 반복 횟수.

제어 대상: 에이전트 루프가 MaxIterationsError 를 던지기 전에 실행하는 LLM→tool→LLM 사이클의 상한입니다. 3단계 루프의 Phase 2(데이터 수집) 부분에 적용됩니다.
사용처: src/app.ts → AgentConfig.maxIterations.
설정 시점: 더 엄격한 비용 제어(낮은 값)를 원하거나 복잡한 다중 도구 쿼리에 더 많은 반복(높은 값)이 필요한 경우입니다.
미설정 시: 기본값은 30 입니다.
형식: 양의 정수.
설정 위치: 사용자 대상 설정 아님

`AGENT_MAX_TOKENS`

에이전트 루프의 도구 호출 사이클 내부의 모든 LLM 호출에 대해 max_tokens 상한을 고정합니다. 선택적 재정의.

제어 대상: 설정되면 그 값이 모든 messages.create 호출에 max_tokens 인수로 그대로 전달됩니다. 설정되지 않으면 에이전트는 src/llm/model-output-limits.ts 에서 세 단계 순서로 활성 모델 자체에서 상한을 도출합니다: 먼저 live provider listing (Anthropic /v1/models 의 max_tokens), 그다음 OpenRouter 카탈로그가 공개한 상한, 둘 다 없을 때만 32K 폴백으로 내려가며 모델 이름을 담은 경고를 남깁니다. 모델에서 도출하는 경로가 기본값이자 권장 태세입니다: "인위적 상한 없음"으로 해야 긴 institution 보고서 / deep-research 표 / 채팅 요약이 잘림 없이 완료됩니다. 실제로 상한에 도달한 turn 은 잘린 답변을 성공으로 반환하는 대신 명시적으로 실패합니다.
사용처: src/app.ts → AgentLoop.maxTokens.
설정 시점: 모델의 네이티브 상한과 다른 값을 원할 때만 — 단순 쿼리에서 엄격한 비용 제어, 또는 예측 가능한 턴당 과금을 위해 더 작은 값으로 고정하는 경우입니다.
미설정 시: 에이전트는 모델의 전체 출력 윈도를 사용합니다 (권장).
형식: 양의 정수.
설정 위치: 사용자 대상 설정 아님

`GATEWAY_HOST`

HTTP 게이트웨이 바인드 인터페이스.

제어 대상: npm run serve (src/gateway/server.ts) 가 바인딩하는 네트워크 인터페이스입니다. 127.0.0.1 / localhost = 로컬 전용; 0.0.0.0 = 모든 인터페이스(이 호스트 외부에서 접근 가능).
사용처: src/gateway/serve-cli.ts (decideBind 가드).
설정 시점: 게이트웨이를 localhost 너머(LAN 호스트, Docker 브리지)로 노출하는 경우입니다. 비루프백 바인드는 인증을 요구합니다 — GATEWAY_AUTH_TOKEN 을 설정하거나, 비대화형 컨텍스트에서는 게이트웨이가 하나를 자동 생성하고 대화형에서는 시작을 거부합니다.
미설정 시: 기본값은 127.0.0.1(로컬 전용)입니다.
형식: 바인딩할 IP 또는 호스트명.
설정 위치: 사용자 대상 설정 아님

`GATEWAY_PORT`

HTTP 게이트웨이 포트.

제어 대상: npm run serve (src/gateway/server.ts) 가 REST/SSE API 를 위해 바인딩하는 포트입니다.
사용처: src/gateway/server.ts.
설정 시점: 대화형 REPL 에 더해 — 또는 대신 — HTTP 게이트웨이를 실행하는 경우입니다. npm run dev 는 이를 무시합니다.
미설정 시: 기본값은 8080 입니다.
형식: 1-65535 사이의 정수.
설정 위치: 사용자 대상 설정 아님

`GATEWAY_AUTH_TOKEN`

HTTP 게이트웨이 bearer 토큰.

제어 대상: HTTP 게이트웨이로 들어오는 모든 요청에 필요한 Authorization: Bearer <token> 입니다.
사용처: src/gateway/server.ts (src/gateway/api.ts 를 통해).
설정 시점: 게이트웨이를 임의의 네트워크 인터페이스에 노출하는 경우입니다. 토큰은 상수 시간 동등성으로 비교됩니다.
설정되지 않고 루프백(127.0.0.1)에 바인딩할 때: 인증이 비활성화되고 모든 요청이 수락됩니다 — 이 호스트 외부에서 접근할 수 없기 때문에만 안전합니다. 설정되지 않고 비루프백 인터페이스에 바인딩할 때는, 게이트웨이가 비대화형 컨텍스트(Docker/CI, <dataDir>/gateway-token 에 기록)에서 토큰을 자동 생성하거나 대화형에서는 시작을 거부합니다. 인증 없는 공개 바인드를 강제하려면 MINARA_ALLOW_INSECURE_BIND=1 을 설정하세요 (권장하지 않음).
형식: 불투명한 고엔트로피 문자열. openssl rand -hex 32 로 생성하세요.
설정 위치: 사용자 대상 설정 아님

`GATEWAY_CORS_ORIGINS`

브라우저 교차 출처 허용 목록.

제어 대상: 브라우저가 교차 출처로 읽을 수 있는 web 출처(Access-Control-Allow-Origin 응답 헤더 + OPTIONS 프리플라이트). 브라우저가 아닌 호출자(curl, 데스크톱 셸, 다른 서버)는 bearer 토큰으로 인증하므로 영향을 받지 않습니다.
사용처: src/gateway/serve-cli.ts (resolveCorsOrigins), src/gateway/api.ts 를 통해.
설정 시점: 비루프백 바인딩에서 게이트웨이와 다른 출처로 web UI 를 제공하는 경우 — 예를 들어 UI 가 https://app.example.com 에서 https://api.example.com 의 게이트웨이를 호출하는 경우. 모든 브라우저 출처를 나열하세요.
미설정 시: 루프백 바인딩은 모든 출처를 허용합니다(*, 로컬 개발은 변경 없음). 비루프백 바인딩은 기본적으로 모든 교차 출처 브라우저 읽기를 거부합니다 — 동일 출처 UI(WEB_UI_DIST_DIR)와 토큰 인증 API 클라이언트는 계속 작동합니다.
형식: 쉼표로 구분된 출처(scheme://host[:port]), 또는 임의를 의미하는 *.
설정 위치: 사용자 대상 설정 아님

`MINARA_ALLOW_INSECURE_BIND`

보안 바인드 가드 우회.

제어 대상: 설정되면 게이트웨이는 시작을 거부하거나 토큰을 자동 생성하는 대신 인증 없이 비루프백 인터페이스에서 서비스합니다. 자금 이동 엔드포인트를 포함한 모든 요청이 포트에 도달할 수 있는 누구에게서든 수락됩니다.
사용처: src/gateway/bind-security.ts (isInsecureBindAllowed).
설정 시점: 위험을 감수하는 완전히 신뢰되고 방화벽으로 보호된 단일 호스트 네트워크에서의 최후 수단입니다. 공용 인터넷이나 공유 네트워크에서는 절대 사용하지 마세요.
미설정 시: 보안 바인드 가드가 활성화됩니다 (기본값, 권장).
형식: 활성화하려면 1/true/yes/on.
설정 위치: 사용자 대상 설정 아님

`WEB_UI_DIST_DIR`

동일 origin web-ui 정적 루트.

제어 대상: 빌드된 web-ui dist/ 디렉터리로 설정되면, HTTP 게이트웨이는 API 와 동일한 origin 에서 해당 SPA 를 /(에셋 + index.html 로의 클라이언트 사이드 내비게이션 폴백)에 서비스합니다 — 따라서 데스크톱 셸이나 단일 origin 배포는 별도의 정적 호스트나 CORS 가 필요 없습니다. API(/v1/*)는 bearer 게이트가 유지되며, 정적 셸과 /assets/* 만 공개됩니다.
사용처: src/gateway/static-spa.ts (src/gateway/api.ts 를 통해).
설정 시점: 데스크톱 앱을 패키징하거나, UI + API 를 하나의 포트에서 서비스하는 경우입니다.
미설정 시: 정적 UI 가 서비스되지 않으며 — 게이트웨이는 순수 API 서버로 동작합니다 (Docker / CLI 의 기본값).
형식: index.html 을 포함하는 기존 디렉터리의 절대 경로.
설정 위치: 사용자 대상 설정 아님

`WEBHOOK_PORT`

웹훅 게이트웨이 포트.

제어 대상: 선택적 웹훅 리스너가 인바운드 이벤트(TradingView 알림, Minara 푸시 이벤트, src/workflow/triggers.ts 에 공급되는 가격 알림 트리거)를 위해 바인딩하는 포트입니다.
사용처: src/gateway/server.ts.
설정 시점: 외부 웹훅 소스를 workflow 엔진에 연결하는 경우입니다. GATEWAY_PORT 와 달라야 합니다.
미설정 시: 웹훅 리스너가 시작되지 않으며 — 예약된 cron 트리거만 자율 턴을 발생시킵니다.
형식: 1-65535 사이의 정수.
설정 위치: 사용자 대상 설정 아님

`FILES_URL_BASE`

샌드박스 파일 다운로드용 URL 접두사.

제어 대상: 클라이언트에 파일을 반환할 때 에이전트가 로컬 샌드박스 경로를 다시 쓰는 공개 접두사입니다.
사용처: src/app.ts.
설정 시점: HTTP 게이트웨이가 리버스 프록시 뒤에서 서비스되고 호출자가 절대 URL(https://agent.example.com/v1/files)을 필요로 하는 경우입니다.
미설정 시: 기본값은 상대 경로 /v1/files 입니다.
형식: 절대 URL 또는 상대 경로 접두사, 끝에 슬래시 없음.
설정 위치: 사용자 대상 설정 아님

`OFFLINE_MODE`

아웃바운드 HTTP 킬 스위치.

제어 대상: src/tools/_shared/fetch-timeout.ts 를 통한 모든 아웃바운드 fetch 가 차단 오류로 단락됩니다. 모든 도구 네트워크 호출이 거부됩니다.
사용처: src/tools/_shared/fetch-timeout.ts.
설정 시점: 임의의 아웃바운드 호출이 버그가 되는 결정론적 테스트나 에어갭 데모를 실행하는 경우입니다.
미설정 시: 네트워크 호출이 정상적으로 동작합니다.
형식: 활성화하려면 1 / true / yes / on. 그 외는 모두 off.
설정 위치: 설정 → 환경설정 (schema 키)

`HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY` / `NO_PROXY`

아웃바운드 프록시.

제어 대상: Minara 소유 전송(모델 호출, 마켓 데이터 및 프로바이더 페치, MCP 서버, 헤드리스 브라우저)이 사용하는 포워드 프록시입니다. 설정 > 환경설정 > 안전 > 로컬 명령에 프록시 설정 전달이 켜져 있으면 python / node / 셸 자식 프로세스에도 프록시 환경 변수를 전달합니다. HTTPS_PROXY, HTTP_PROXY, ALL_PROXY 순서로 확인하며 먼저 설정된 것이 적용됩니다. 대문자와 소문자 변수 이름을 모두 읽습니다.
사용처: src/config/egress/resolve.ts 가 시작 시 환경 변수를 한 번 파싱한 뒤 트랜스포트별 어댑터에 전달합니다. Desktop 이 실행 중 교체할 수 있는 것은 Desktop 이 관리하는 OS 프록시 경로뿐이며, 그 외 어디에서도 이 변수를 읽지 않습니다.
설정 시점: 머신이 프록시를 통해서만 인터넷에 도달할 수 있는 경우입니다. Minara Desktop 은 OS 프록시를 자동으로 감지해 주입하며, OS HTTP 프록시와 PAC 변경은 재시작 없이 새 요청, 재연결, 새 브라우저 실행 및 자식 프로세스에 적용됩니다. 환경 변수를 직접 설정하는 것은 CLI, gateway, Docker 를 위한 시작 시 설정이며 변경하려면 재시작해야 합니다.
미설정 시: Minara 소유 연결은 직접 나가며 자식 프로세스에는 프록시 변수를 전달하지 않습니다. 다만 TUN 모드 같은 시스템 전체 라우팅이 자식 프로세스 트래픽을 계속 전달할 수 있습니다.
형식: http:// 또는 https:// URL 이며 자격 증명을 포함할 수 있습니다(http://user:pass@proxy:3128). SOCKS URL 은 로그를 남기고 무시됩니다 — 프록시는 HTTP CONNECT 를 지원해야 합니다. NO_PROXY 는 쉼표로 구분된 호스트 목록입니다(CIDR 범위는 자식 프로세스와 브라우저에서는 적용되지만 agent 프로세스 자체에는 적용되지 않습니다). 루프백과 사설 대역은 목록에 있든 없든 항상 우회합니다.
Note: 자식 프로세스 프록시 상속이 켜져 있으면 자격 증명이 포함된 URL 을 모델이 작성한 로컬 코드에서 볼 수 있습니다. 이때 Minara 는 프로세스마다 한 번 경고합니다. 위 안전 설정을 끄면 환경 변수 전달은 중지되지만 직접 연결이나 TUN 라우팅 네트워크에서 자식 프로세스를 격리하지는 않습니다.
설정 위치: 사용자 대상 설정 아님

`CLOUD_SYNC_AUTO`

백그라운드에서 Minara 계정과 동기화.

제어 대상: 이 기기가 사용자의 조작 없이 Minara 계정과 서로 동기화할지 여부(약 5분 간격). 수동 동기화는 항상 가능하며 이 설정과 무관합니다. 이 스위치는 사용자가 직접 요청하지 않은 동기화만 제어합니다.
사용처: 런타임 Preferences 의 cloudSync.auto 와 src/app/sync.ts. 어떤 데이터를 포함할지는 CLOUD_SYNC_CHAT 과 CLOUD_SYNC_PERSONALIZATION 에서 따로 정합니다.
설정 시점: 여러 기기에서 Minara 를 쓰면서 별도 요청 없이 맞추고 싶을 때.
미설정 시: 누군가 수동으로 동기화하기 전까지는 아무것도 전송하지 않습니다. 대화에는 로컬 경로와 비공개 맥락이 담기므로 무인 동기화는 기본적으로 off 입니다.
형식: 1 / true / yes / on 으로 활성화. 그 외의 값 = off.
설정 위치: 설정 → 환경설정 (schema 키)

`CLOUD_SYNC_CHAT`

동기화 대상에 대화 포함.

제어 대상: 대화를 동기화 대상에 포함할지 여부. 전송되는 것은 사용자와 에이전트가 말한 내용뿐이며 도구 호출, 도구 결과, 추론은 이 기기에 남습니다.
사용처: 런타임 Preferences 의 cloudSync.chat.
설정 시점: false 로 두면 다른 데이터는 계속 동기화하면서 대화 본문만 이 기기에 남길 수 있습니다.
미설정 시: 대화를 포함하지만 이 기기가 동기화할 때만 실제로 동작합니다.
형식: 0 / false / no / off 는 제외. 그 외의 값 = 포함.
설정 위치: 설정 → 환경설정 (schema 키)

`CLOUD_SYNC_PERSONALIZATION`

동기화 대상에 Minara 가 기억하는 것 포함.

제어 대상: Minara 가 기억하는 짧은 사실을 동기화 대상에 포함할지 여부. 전체 대화가 아니라 한 문장짜리 메모입니다.
사용처: 런타임 Preferences 의 cloudSync.personalization.
설정 시점: false 로 두면 대화만 동기화하고 도출된 메모는 공유하지 않습니다.
미설정 시: 메모를 포함하지만 이 기기가 동기화할 때만 실제로 동작합니다.
형식: 0 / false / no / off 는 제외. 그 외의 값 = 포함.
설정 위치: 설정 → 환경설정 (schema 키)

`CLOUD_SYNC_USER_TAGS`

투자 성향 답변을 동기화에 포함할지 여부.

제어 대상: 자신에 대해 답한 항목(위험 성향, 보유 기간, 관심 시장 등)을 동기화 대상에 포함할지 여부입니다.
사용처: 런타임 Preferences의 cloudSync.user-tags.
설정 시점: false로 두면 해당 답변은 이 기기에만 남기고 나머지는 계속 동기화합니다.
미설정 시: 포함되지만, 이 기기가 동기화할 때에만 실제로 적용됩니다.
형식: 0 / false / no / off는 제외. 그 외 값 = 포함.
설정 위치: 설정 → 환경설정 (schema 키)

`CLOUD_SYNC_PROFILE`

직접 설정한 지침과 관심목록을 동기화에 포함할지 여부.

제어 대상: 직접 설정한 항목을 동기화할지 여부입니다 — 사용자 지침, Minara가 답변에 가져올 수 있는 범위, 지켜보는 지갑, 관심목록. 거래에서 도출된 요약은 그것을 만든 기기에 남습니다.
사용처: 런타임 Preferences의 cloudSync.profile.
설정 시점: false로 두면 이 설정들을 기기별로 유지합니다.
미설정 시: 포함되지만, 이 기기가 동기화할 때에만 실제로 적용됩니다.
형식: 0 / false / no / off는 제외. 그 외 값 = 포함.
설정 위치: 설정 → 환경설정 (schema 키)

`CLOUD_SYNC_WORKFLOW`

자동화와 클라우드 워크플로를 동기화에 포함할지 여부.

제어 대상: 자동화와 클라우드 워크플로를 동기화할지 여부입니다. 처음에는 시간이 걸릴 수 있습니다. 양쪽 구현이 달라 이 기기에서 열 수 없는 항목이 있습니다. 그런 항목은 계정에 남고, 동기화 실패가 아니라 이 기기에서 열 수 없는 건수로 표시됩니다.
사용처: 런타임 Preferences의 cloudSync.workflow.
설정 시점: true로 두면 대화와 기억과 함께 자동화도 동기화합니다.
미설정 시: 동기화 설정에서 켜기 전까지 자동화는 포함되지 않습니다. 이 기기에서 클라우드 워크플로를 다시 만드는 것은 선택 사항입니다.
형식: 1 / true / yes / on 으로 활성화. 그 외의 값 = off.
설정 위치: 설정 → 환경설정 (schema 키)

`LOG_LEVEL`

로거 상세도.

제어 대상: src/core/logger.ts 가 방출하는 최소 레벨입니다. 이보다 낮은 메시지는 버려집니다.
사용처: src/core/logger.ts.
설정 시점: 새 도구 / 스킬을 개발할 때는 debug, 조용한 프로덕션 배포에는 warn 또는 error.
미설정 시: 기본값은 warn 입니다.
형식: debug | info | warn | error 중 하나.
설정 위치: 사용자 대상 설정 아님

목차