配置

在 Astreus 文档中了解配置，获取用于构建智能体系统的设置指导、API 模式和实用示例。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

Astreus 智能体项目的环境变量和配置选项。

环境设置

创建项目后，复制示例环境变量文件：

cp .env.example .env

然后编辑 .env 完成你的配置。

特定提供商的配置

生成的 .env.example 取决于你所选择的提供商：

OpenAI

OPENAI_API_KEY=your-api-key-here

Anthropic

ANTHROPIC_API_KEY=your-api-key-here

Google Gemini

GEMINI_API_KEY=your-api-key-here

Ollama

# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434

多提供商

# Add API keys for providers you want to use
OPENAI_API_KEY=your-openai-key
ANTHROPIC_API_KEY=your-anthropic-key
GEMINI_API_KEY=your-gemini-key

完整配置

对于生产环境部署，你可能需要额外的配置：

# ===== 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

数据库配置

SQLite（开发环境）

开发环境下默认使用，零配置：

DB_URL=sqlite://./astreus.db

PostgreSQL（生产环境）

推荐用于生产环境部署：

DB_URL=postgresql://user:password@localhost:5432/astreus_db

知识库数据库

RAG 功能所必需。必须使用带有 pgvector 的 PostgreSQL：

KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db

设置 pgvector

使用 Docker：

# docker-compose.yml
services:
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_USER: astreus
      POSTGRES_PASSWORD: password
      POSTGRES_DB: knowledge_db
    ports:
      - "5432:5432"

docker-compose up -d

安全

加密密钥

生成一个安全的加密密钥：

openssl rand -hex 32

添加到你的环境变量中：

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcm

生产环境检查清单

使用 PostgreSQL 而非 SQLite
启用加密
设置 NODE_ENV=production
使用 LOG_LEVEL=warn 或 error
将密钥存储在环境变量中，而非文件中
使用密钥管理服务（Vault、AWS Secrets 等）

各提供商的默认模型

Provider	Default Model
OpenAI	`gpt-4o`
Anthropic	`claude-sonnet-4-20250514`
Google	`gemini-2.0-flash`
Ollama	`llama3`

最后更新时间:2026年7月6日

本节内容

简介

使用最佳实践和合理的默认配置来搭建新的 Astreus AI 智能体项目。以交互方式配置你需要的功能。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

快速开始

在 Astreus 文档中了解快速开始，获取用于构建智能体系统的设置指导、API 模式和实用示例。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

功能

在 Astreus 文档中了解功能，获取用于构建智能体系统的设置指导、API 模式和实用示例。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

模板