権威あるリストは常にリポジトリ内の注釈付き api/.env.example です。本ページは用途別に「なぜ必要か、どう正しく記入するか」を解説します。普遍的なルールを 1 つ:env に KEY=(空文字列)と書くのは未設定と同じで、デフォルト値へのフォールバックが発動します——値をクリアしたいときは行ごとコメントアウトを。
LLM ゲートウェイ 3 点セット(必須)
DEEPSEEK_API_KEY(あなたのゲートウェイキー——名前は歴史的経緯で、任意の OpenAI 互換ゲートウェイに使えます)、OPENAI_BASE_URL(ゲートウェイアドレス、/chat/completions の手前まで)、AI_MODEL(そのゲートウェイが認識するモデル ID)。.env.example には DeepSeek / OpenRouter / Groq / Together / OpenAI / Ollama の 6 テンプレートが内蔵されており、選んだものをアンコメントするだけ。AI に画像を読ませるにはビジョン対応モデル(gpt-4o-mini、qwen-vl-plus など)を選んでください。
サーバーシークレット 3 本(本番では必ず変更)
ADMIN_SECRET(/admin/* 運用エンドポイントの認証キー)、JWT_SECRET(ログインセッションの署名)、USER_API_KEY_ENCRYPTION_SECRET(ワールドオーナーが持ち込む API キーのサーバー側暗号化キー)。3 本とも互いに異なる長いランダム文字列を:openssl rand -hex 32 を 3 回実行。
ネットワークとパス
PORT(バックエンドポート、デフォルト 3000)、DATABASE_PATH(SQLite ファイルの位置。相対パスはリポジトリルートから解決。Docker モードでは /app/data/database.sqlite に固定されホストの ./data にマウント)、CORS_ALLOWED_ORIGINS(クロスオリジンを許可するフロントエンドのオリジン、カンマ区切り——公開後は自分のドメインを忘れずに追加)、PUBLIC_API_BASE_URL(対外公開する Web ルートアドレス、/api は付けない)。ルート compose は追加で APP_PORT(フロントエンドのホスト側ポートマッピング、デフォルト 80)をサポート。
オプション:MiniMax メディア生成
MINIMAX_API_KEY / MINIMAX_BASE_URL はモーメンツや動画チャンネルで NPC が動画・音楽を自動生成するのに使います。完全にオプション:未記入ならその部分だけ「メディア生成は無効」のプレースホルダーが表示されるだけで、チャット・モーメンツ・グループチャットなど他の機能には影響しません。
オプション:SMTP メール二重チャネル
SMTP_* はメール認証コードログイン用。SMTP_HOST を空にすると認証コードはサーバーログに出力されます(開発 mock モード)。資格情報を記入すれば実際に送信されます。オプションの SMTP_OVERSEAS_* グループは受信者のメールドメインで振り分け(gmail/outlook などの海外ドメインは海外チャネル)、未設定ならデフォルトチャネルへ自動フォールバック——典型的な組み合わせは、デフォルトチャネルに国内のメールサービス、海外チャネルに Gmail/SES。
関連する質問
Enclave はどの大規模言語モデルに対応していますか?
Enclave のモデル層は完全に差し替え可能です。OpenAI、Anthropic、Google、DeepSeek、さらにローカルの Ollama / vLLM もすべて設定できます。キャラクターごとに別々のモデルを使うこともでき、用途とコストに応じて自由に割り当てられます。Enclaveは完全オフラインで動かせますか?
できます。モデル層をローカルのOllama / vLLMに切り替え、現実世界との同期をオフにすれば、システム全体は外部へのリクエストを一切送らなくなり、あなた自身のマシン上で完全にオフラインで動作します——いかなる約束にも依存しない、最も強力なプライバシー保証です。Enclave はセルフホストできますか?難しいですか?
できます。難易度は普通の web サービスを動かすのと同程度です。docker compose を使ったことがあれば、3 ステップで自分のインスタンスを持てます。リポジトリをクローンし、.env をコピーし、docker compose up するだけ。API・フロントエンド・データベース・ベクトルインデックスはすべて自分のマシン上で動きます。