配置
通过环境变量配置 Astreus CLI 以实现完全自定义。这些设置既控制 CLI 本身,也控制你在 agent 开发过程中可以使用的底层 Astreus 框架功能。
环境设置#
在你的主目录中创建一个 .env 文件,或在 shell 配置文件中导出变量。
完整配置#
# ===== CLI SETTINGS =====
# Default provider and model
ASTREUS_PROVIDER=openai # openai, claude, gemini, ollama
ASTREUS_MODEL=gpt-4o # Default model name
# ===== LLM PROVIDERS API KEYS =====
# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here # Optional
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key # Optional
# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here # Optional
# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here
GEMINI_VISION_API_KEY=your-vision-api-key-here # Optional
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key # Optional
# Ollama (for local models)
OLLAMA_HOST=http://localhost:11434
# ===== DATABASE CONFIGURATION =====
# Main Application Database (Agents, Memory, Tasks, etc.)
DB_URL=sqlite://./astreus.db
# PostgreSQL (production recommended)
# DB_URL=postgresql://username:password@localhost:5432/astreus_db
# ===== KNOWLEDGE/RAG SYSTEM =====
# Knowledge Vector Database (PostgreSQL with pgvector required)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db
# ===== APPLICATION SETTINGS =====
NODE_ENV=development # development | production | test
LOG_LEVEL=info # debug | info | warn | error | silent
# ===== DATABASE ENCRYPTION =====
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm必需变量#
至少需要一个 LLM 提供商 API 密钥:
# Choose one:
export OPENAI_API_KEY=sk-...
# or
export ANTHROPIC_API_KEY=...
# or
export GEMINI_API_KEY=...
# or just run Ollama locally默认提供商与模型#
设置你偏好的默认值:
# Always start with Claude
export ASTREUS_PROVIDER=claude
export ASTREUS_MODEL=claude-sonnet-5
# Or start with local Ollama
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3数据库配置#
SQLite(默认)#
对于本地开发,SQLite 开箱即用:
DB_URL=sqlite://./astreus.dbPostgreSQL(生产环境)#
用于生产环境或共享环境:
DB_URL=postgresql://user:password@localhost:5432/astreus_db知识数据库#
如果使用 RAG/知识功能,你需要带有 pgvector 的 PostgreSQL:
KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db安全设置#
加密#
为敏感数据启用加密:
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm生成一个安全密钥:
openssl rand -hex 32日志#
控制日志详细程度:
# Options: debug | info | warn | error | silent
LOG_LEVEL=infoShell 配置文件设置#
添加到你的 ~/.bashrc、~/.zshrc 或 ~/.profile:
# Astreus CLI Configuration
export OPENAI_API_KEY="sk-your-key"
export ASTREUS_PROVIDER="openai"
export ASTREUS_MODEL="gpt-4o"然后重新加载:
source ~/.zshrc # or ~/.bashrc验证配置#
检查你的配置:
# Start CLI and check settings
astreus
/settings这会打开设置面板,显示你当前的配置。
Agent 开发工作流#
为获得最佳的 agent 开发体验:
1. 配置多个提供商#
配置多个 API 密钥,以便你可以跨不同的 LLM 测试你的 agent:
# All providers configured
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."2. 使用项目附件#
在处理 agent 项目时,附加文件夹以获取完整上下文:
astreus
/attach ./my-agent-projectCLI 将理解你的项目结构、现有代码和配置。
3. 通过会话迭代#
你的开发会话会自动保存。返回时可以从上次离开的地方继续:
astreus
/sessions # See and restore previous sessions4. 测试不同的模型#
一旦生成了 agent 代码,测试它在不同底层模型下的表现:
/provider claude # Test with Claude
/provider openai # Test with GPT-4o
/provider ollama # Test locally