Minara コア

`MINARA_API_KEY`

Minara バックエンド API 認証情報。

制御対象: Agent が Minara REST インターフェース（portfolio、swap、perps、autopilot、workflow、analytics）に対して行うすべての呼び出し。
使用箇所: src/minara/client.ts、src/minara/read-client.ts、src/minara/safe-trading-client.ts（src/app.ts 経由）。
設定するタイミング: device-flow JWT が利用できない非対話的な環境（CI、Docker、workflow エンジン）で実行する場合。
未設定時: gateway は $MINARA_DATA_DIR/credentials.json（llm slot）に保存された device-flow JWT を探します（先に minara auth login minara を実行してください）。どちらも存在しない場合、Agent は 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 web フロントエンドのベース URL。

制御対象: token:// / address:// のカスタム URI スキームが、
ターミナルの OSC 8 ハイパーリンクや
ディープリサーチの HTML レポートで解決される URL と、
デスクトップ OAuth 成功ページ /oauth/desktop/success の URL。
今後追加される 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 データベース、サンドボックスのファイル jail、auth プロファイル、監査ログ、生成されたドキュメントが置かれる場所。
使用箇所: apps/agent/src/gateway/cli.ts、apps/agent/src/app.ts、apps/agent/src/tools/_shared/sandbox.ts。
設定するタイミング: ~ が非永続パスにマップされる Docker / systemd 下で実行する場合、または複数の Agent プロファイルを並存させたい場合。
未設定時: 既定では ~/.minara。
形式: 絶対ファイルシステムパス。存在しない場合は初回起動時に作成されます。
設定の所在: ユーザー向け設定ではありません

`MINARA_TERMINAL_CWD`

Agent 作業ディレクトリのオーバーライド。

制御対象: Agent がユーザーファイルを読み書きし、shell コマンドを実行する cwd。解決順序: セッション単位のオーバーライド（実行時に /cwd で設定）→ この変数 → process.cwd()。
使用箇所: apps/agent/src/agent/runtime-cwd.ts（resolveAgentCwd）。
設定するタイミング: gateway / cron のエントリーポイントで、起動ディレクトリが意図した作業ディレクトリではなくインストールディレクトリになっている場合。ローカル CLI では通常これを未設定のままにし、shell の cwd にフォールバックします。
未設定時: process.cwd()（Agent プロセスが起動されたディレクトリ）にフォールバックします。
形式: 実在するディレクトリへの絶対パス。存在しないパスは無視され、解決は 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 プロバイダーが有効な場合にのみ動作します。
形式: 真偽値。true は 1、true、yes、on、false は 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 → 金融安全で無効にできます。
形式: 真偽値。true は 1、true、yes、on、false は 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`

Agent の初期モデル id。

制御対象: 対話型チャットで使う既定のモデル id。バックグラウンド作業のモデルが有効な場合、タイトル、圧縮、無人の作業は設定で指定したモデルを使えますが、チャットはこのモデルを維持します。
使用箇所: apps/agent/src/app.ts（createApp のモデル解決チェーン）。
設定するタイミング: ~/.minara/settings.json に永続化されたモデル pin が、現在有効なプロバイダーに対して正しくない場合。例えば OPENROUTER_API_KEY のみを構成しているのに、永続化された id が Anthropic ネイティブの claude-sonnet-4-6 で、OpenRouter がこれを 400 で拒否する（その命名は anthropic/claude-sonnet-4.5）ケース。web UI の Settings → Model ピッカーが長期的な解決策で、この env の調整はプロセス存続期間のオーバーライドです。
未設定時: 永続化された 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`

ターンあたりのツール呼び出しループの最大反復回数。

制御対象: Agent ループが MaxIterationsError を投げるまでに実行する LLM→ツール→LLM サイクルの回数の上限。3 フェーズループの Phase 2（データ収集）部分に適用されます。
使用箇所: src/app.ts → AgentConfig.maxIterations。
設定するタイミング: コストをより厳しく制御したい場合（値を下げる）、または複雑なマルチツールクエリでより多くの反復が必要な場合（値を上げる）。
未設定時: 既定では 30。
形式: 正の整数。
設定の所在: ユーザー向け設定ではありません

`AGENT_MAX_TOKENS`

Agent ループのツール呼び出しサイクル内のすべての LLM 呼び出しに対して max_tokens の上限を固定します。任意のオーバーライド。

制御対象: 設定すると、その値が max_tokens 引数としてすべての messages.create 呼び出しにそのまま転送されます。未設定の場合、Agent は src/llm/model-output-limits.ts で三段階の順に有効なモデル自体から上限を導出します。まず live のプロバイダ listing（Anthropic /v1/models の max_tokens）、次に OpenRouter カタログが公開する上限、どちらにも無い場合のみ 32K のフォールバックに落ちてモデル名付きの警告を出します。モデル導出のパスが既定であり推奨される姿勢です。「人為的な上限を設けない」ことで、長い機関投資家レポート / deep-research のテーブル / チャット要約が切り詰められずに完了します。実際に上限に達した turn は、切り詰められた回答を成功として返す代わりに明示的に失敗します。
使用箇所: src/app.ts → AgentLoop.maxTokens。
設定するタイミング: モデルのネイティブ上限と異なる値が必要な場合のみ。単純なクエリでコストを厳しく制御する、または予測可能なターンごとの課金のために小さい値に固定する場合など。
未設定時: Agent はモデルの完全な出力ウィンドウを使います（推奨）。
形式: 正の整数。
設定の所在: ユーザー向け設定ではありません

`GATEWAY_HOST`

HTTP gateway のバインドインターフェース。

制御対象: npm run serve（src/gateway/server.ts）がバインドするネットワークインターフェース。127.0.0.1 / localhost = ローカルのみ。0.0.0.0 = すべてのインターフェース（このホストの外部から到達可能）。
使用箇所: src/gateway/serve-cli.ts（decideBind ガード）。
設定するタイミング: gateway を localhost の外部（LAN ホスト、Docker ブリッジ）に公開する場合。非 loopback バインドには認証が必須です。GATEWAY_AUTH_TOKEN を設定するか、gateway が非対話的な環境で自動生成し、対話的な環境では起動を拒否します。
未設定時: 既定では 127.0.0.1（ローカルのみ）。
形式: バインドする IP またはホスト名。
設定の所在: ユーザー向け設定ではありません

`GATEWAY_PORT`

HTTP gateway ポート。

制御対象: npm run serve（src/gateway/server.ts）が REST/SSE API 用にバインドするポート。
使用箇所: src/gateway/server.ts。
設定するタイミング: 対話的な REPL に加えて、またはその代わりに HTTP gateway を実行する場合。npm run dev では無視されます。
未設定時: 既定では 8080。
形式: 1〜65535 の整数。
設定の所在: ユーザー向け設定ではありません

`GATEWAY_AUTH_TOKEN`

HTTP gateway の bearer トークン。

制御対象: HTTP gateway へのすべての受信リクエストに Authorization: Bearer <token> を要求します。
使用箇所: src/gateway/server.ts（src/gateway/api.ts 経由）。
設定するタイミング: 任意のネットワークインターフェースで gateway を公開する場合。トークンは定数時間の等価比較で照合されます。
未設定かつ loopback（127.0.0.1）にバインドする場合: 認証は無効化され、すべてのリクエストが受け入れられます。これが安全なのは、このホストの外部から到達できないからにすぎません。未設定かつ非 loopback インターフェースにバインドする場合、gateway は非対話的な環境（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 経由。
設定するタイミング: 非 loopback バインドで、gateway とは異なるオリジンから web UI を提供する場合 —— 例えば UI が https://app.example.com にあり、https://api.example.com の gateway を呼び出す場合。すべてのブラウザオリジンを列挙します。
未設定時: loopback バインドはすべてのオリジンを許可します（*、ローカル開発は変更なし）。非 loopback バインドは既定ですべてのクロスオリジンのブラウザ読み取りを拒否します —— 同一オリジンの UI（WEB_UI_DIST_DIR）とトークン認証の API クライアントは引き続き動作します。
形式: カンマ区切りのオリジン（scheme://host[:port]）、または任意を表す *。
設定の所在: ユーザー向け設定ではありません

`MINARA_ALLOW_INSECURE_BIND`

セキュアバインドガードをバイパスします。

制御対象: 設定すると、gateway は起動を拒否したりトークンを自動生成したりする代わりに、認証なしで非 loopback インターフェース上で提供します。資金移動エンドポイントを含むすべてのリクエストが、そのポートに到達できる誰からでも受け入れられます。
使用箇所: src/gateway/bind-security.ts（isInsecureBindAllowed）。
設定するタイミング: リスクを受け入れる、完全に信頼された、ファイアウォール保護された単一ホストネットワークでの最終手段として。公衆インターネットや共有ネットワークでは決して使わないでください。
未設定時: セキュアバインドガードが有効な状態（既定、推奨）。
形式: 1/true/yes/on で有効化します。
設定の所在: ユーザー向け設定ではありません

`WEB_UI_DIST_DIR`

同一 origin の web-ui 静的ルート。

制御対象: ビルド済みの web-ui dist/ ディレクトリに設定すると、HTTP gateway は API と同じ origin 上の / でその SPA を提供します（アセット + クライアントサイドナビゲーションの index.html へのフォールバック）。そのためデスクトップシェルや単一 origin のデプロイでは、別個の静的ホストも CORS も不要です。API（/v1/*）は引き続き bearer で保護され、公開されるのは静的シェルと /assets/* のみです。
使用箇所: src/gateway/static-spa.ts（src/gateway/api.ts 経由）。
設定するタイミング: デスクトップアプリをパッケージ化する場合、または UI + API を 1 つのポートで提供する場合。
未設定時: 静的 UI は提供されません。gateway は純粋な API サーバーとして動作します（Docker / CLI の既定）。
形式: index.html を含む既存ディレクトリへの絶対パス。
設定の所在: ユーザー向け設定ではありません

`WEBHOOK_PORT`

webhook gateway ポート。

制御対象: 任意の webhook リスナーが受信イベント（TradingView アラート、Minara プッシュイベント、src/workflow/triggers.ts に供給される価格アラートトリガー）用にバインドするポート。
使用箇所: src/gateway/server.ts。
設定するタイミング: 外部の webhook ソースを workflow エンジンに接続する場合。GATEWAY_PORT とは異なる必要があります。
未設定時: webhook リスナーは起動されません。スケジュールされた cron トリガーのみが自律ターンを発火します。
形式: 1〜65535 の整数。
設定の所在: ユーザー向け設定ではありません

`FILES_URL_BASE`

サンドボックスファイルダウンロードの URL プレフィックス。

制御対象: Agent がクライアントにファイルを返す際、ローカルのサンドボックスパスを書き換える公開プレフィックス。
使用箇所: src/app.ts。
設定するタイミング: HTTP gateway がリバースプロキシの背後にデプロイされ、呼び出し側が絶対 URL（https://agent.example.com/v1/files）を必要とする場合。
未設定時: 既定では相対パス /v1/files。
形式: 絶対 URL または相対パスプレフィックス、末尾スラッシュなし。
設定の所在: ユーザー向け設定ではありません

`OFFLINE_MODE`

送信 HTTP のキルスイッチ。

制御対象: src/tools/_shared/fetch-timeout.ts を経由するすべての送信 fetch が blocked エラーで短絡します。すべてのツールのネットワーク呼び出しが拒否されます。
使用箇所: src/tools/_shared/fetch-timeout.ts。
設定するタイミング: 決定論的なテストや、いかなる送信呼び出しもバグとなるエアギャップのデモを実行する場合。
未設定時: ネットワーク呼び出しは通常どおり動作します。
形式: 1 / true / yes / on で有効化します。それ以外の値 = オフ。
設定の所在: 設定 → 環境設定（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 を使い、指示なしで揃えたい場合。
未設定時: 誰かが手動で同期するまで何も送信しません。会話にはローカルのパスや非公開の文脈が含まれるため、無人の同期は既定でオフです。
形式: 1 / true / yes / on で有効化。それ以外の値 = オフ。
設定の所在: 設定 → 環境設定（schema キー）

`CLOUD_SYNC_CHAT`

同期対象に会話を含める。

制御対象: 会話を同期対象に含めるかどうか。送信されるのはあなたとエージェントの発言だけで、ツール呼び出し・ツール結果・推論はこの端末に残ります。
使用箇所: ランタイム Preferences の cloudSync.chat。
設定するタイミング: false にすると、他のデータの同期は続けたまま会話本文だけをこの端末に留められます。
未設定時: 会話を含めますが、実際に動くのはこの端末が同期するときだけです。
形式: 0 / false / no / off で除外。それ以外の値 = 含める。
設定の所在: 設定 → 環境設定（schema キー）

`CLOUD_SYNC_PERSONALIZATION`

同期対象に Minara が覚えていることを含める。

制御対象: Minara が覚えている短い事実を同期対象に含めるかどうか。会話全体ではなく 1 文のメモです。
使用箇所: ランタイム 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 で有効化。それ以外の値 = オフ。
設定の所在: 設定 → 環境設定（schema キー）

`LOG_LEVEL`

logger の詳細度。

制御対象: src/core/logger.ts が出力する最小レベル。これを下回るメッセージは破棄されます。
使用箇所: src/core/logger.ts。
設定するタイミング: 新しいツール / スキルの開発中は debug、静かな本番デプロイでは warn または error。
未設定時: 既定では warn。
形式: debug | info | warn | error のいずれか。
設定の所在: ユーザー向け設定ではありません

目次