Skip to content

Configuration

์„ค์ •

SalmAlm is configured via environment variables (.env file) and vault storage.

SalmAlm์€ ํ™˜๊ฒฝ๋ณ€์ˆ˜(.env ํŒŒ์ผ)์™€ ๋ณผํŠธ ์ €์žฅ์†Œ๋ฅผ ํ†ตํ•ด ์„ค์ •๋ฉ๋‹ˆ๋‹ค.

Environment Variables / ํ™˜๊ฒฝ๋ณ€์ˆ˜

LLM API Keys / LLM API ํ‚ค

At least one is required. / ์ตœ์†Œ ํ•˜๋‚˜ ํ•„์ˆ˜.

Variable / ๋ณ€์ˆ˜ Description / ์„ค๋ช… Example / ์˜ˆ์‹œ
ANTHROPIC_API_KEY Anthropic Claude API key sk-ant-...
OPENAI_API_KEY OpenAI API key sk-...
XAI_API_KEY xAI (Grok) API key xai-...
GOOGLE_API_KEY Google Gemini API key AIza...
OPENROUTER_API_KEY OpenRouter API key sk-or-...
OLLAMA_URL Local Ollama endpoint http://localhost:11434/v1

Server / ์„œ๋ฒ„

Variable / ๋ณ€์ˆ˜ Description / ์„ค๋ช… Default / ๊ธฐ๋ณธ๊ฐ’
SALMALM_PORT HTTP server port / HTTP ์„œ๋ฒ„ ํฌํŠธ 18800
SALMALM_BIND Bind address / ๋ฐ”์ธ๋“œ ์ฃผ์†Œ 127.0.0.1
SALMALM_VAULT_PW Vault encryption password / ๋ณผํŠธ ์•”ํ˜ธํ™” ๋น„๋ฐ€๋ฒˆํ˜ธ โ€”
PYTHONUNBUFFERED Unbuffered output / ๋ฒ„ํผ ์—†๋Š” ์ถœ๋ ฅ 1

Telegram / ํ…”๋ ˆ๊ทธ๋žจ

Variable / ๋ณ€์ˆ˜ Description / ์„ค๋ช…
TELEGRAM_TOKEN Bot token from @BotFather / @BotFather์—์„œ ๋ฐ›์€ ๋ด‡ ํ† ํฐ
TELEGRAM_OWNER_ID Owner's Telegram user ID / ์†Œ์œ ์ž์˜ ํ…”๋ ˆ๊ทธ๋žจ ์‚ฌ์šฉ์ž ID

Discord / ๋””์Šค์ฝ”๋“œ

Variable / ๋ณ€์ˆ˜ Description / ์„ค๋ช…
DISCORD_TOKEN Discord bot token / ๋””์Šค์ฝ”๋“œ ๋ด‡ ํ† ํฐ
Variable / ๋ณ€์ˆ˜ Description / ์„ค๋ช…
BRAVE_SEARCH_API_KEY Brave Search API key / Brave ๊ฒ€์ƒ‰ API ํ‚ค

Google OAuth / ๊ตฌ๊ธ€ OAuth

Variable / ๋ณ€์ˆ˜ Description / ์„ค๋ช…
GOOGLE_CLIENT_ID OAuth client ID
GOOGLE_CLIENT_SECRET OAuth client secret
GOOGLE_REDIRECT_URI OAuth redirect URI

Vault Storage / ๋ณผํŠธ ์ €์žฅ์†Œ

Sensitive data is stored in an AES-256-GCM encrypted vault (.vault.enc).

๋ฏผ๊ฐํ•œ ๋ฐ์ดํ„ฐ๋Š” AES-256-GCM ์•”ํ˜ธํ™” ๋ณผํŠธ(.vault.enc)์— ์ €์žฅ๋ฉ๋‹ˆ๋‹ค.

Vault can store: / ๋ณผํŠธ์— ์ €์žฅ ๊ฐ€๋Šฅ:

  • API keys / API ํ‚ค
  • OAuth tokens / OAuth ํ† ํฐ
  • Google refresh tokens / ๊ตฌ๊ธ€ ๋ฆฌํ”„๋ ˆ์‹œ ํ† ํฐ
  • Any secrets / ๊ธฐํƒ€ ๋น„๋ฐ€ ์ •๋ณด

Access vault via: / ๋ณผํŠธ ์ ‘๊ทผ ๋ฐฉ๋ฒ•:

/vault list
/vault get <key>
/vault set <key> <value>
/vault delete <key>

Configuration Files / ์„ค์ • ํŒŒ์ผ

File / ํŒŒ์ผ Purpose / ์šฉ๋„
.env Environment variables / ํ™˜๊ฒฝ๋ณ€์ˆ˜
.vault.enc Encrypted secrets vault / ์•”ํ˜ธํ™”๋œ ๋น„๋ฐ€ ๋ณผํŠธ
.token_secret Session token secret / ์„ธ์…˜ ํ† ํฐ ์‹œํฌ๋ฆฟ
reminders.json Saved reminders / ์ €์žฅ๋œ ๋ฆฌ๋งˆ์ธ๋”
workflows.json Workflow definitions / ์›Œํฌํ”Œ๋กœ์šฐ ์ •์˜
rss_feeds.json RSS feed subscriptions / RSS ํ”ผ๋“œ ๊ตฌ๋…
nodes.json Node registry / ๋…ธ๋“œ ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ
plugins/ Plugin directory / ํ”Œ๋Ÿฌ๊ทธ์ธ ๋””๋ ‰ํ† ๋ฆฌ
skills/ Skill definitions / ์Šคํ‚ฌ ์ •์˜
memory/ Memory storage / ๋ฉ”๋ชจ๋ฆฌ ์ €์žฅ์†Œ

Database Files / ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ํŒŒ์ผ

File / ํŒŒ์ผ Purpose / ์šฉ๋„
audit.db Audit log (SQLite) / ๊ฐ์‚ฌ ๋กœ๊ทธ
auth.db Authentication data / ์ธ์ฆ ๋ฐ์ดํ„ฐ
personal.db Personal assistant data / ๊ฐœ์ธ ๋น„์„œ ๋ฐ์ดํ„ฐ
rag.db RAG vector store / RAG ๋ฒกํ„ฐ ์ €์žฅ์†Œ