配置

通过环境变量配置 Astreus CLI 以实现完全自定义。这些设置既控制 CLI 本身，也控制你在 agent 开发过程中可以使用的底层 Astreus 框架功能。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

通过环境变量配置 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-4-20250514

# Or start with local Ollama
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3

数据库配置

SQLite（默认）

对于本地开发，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

安全设置

加密

为敏感数据启用加密：

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

Shell 配置文件设置

添加到你的 ~/.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-project

CLI 将理解你的项目结构、现有代码和配置。

3. 通过会话迭代

你的开发会话会自动保存。返回时可以从上次离开的地方继续：

astreus
/sessions  # See and restore previous sessions

4. 测试不同的模型

一旦生成了 agent 代码，测试它在不同底层模型下的表现：

/provider claude   # Test with Claude
/provider openai   # Test with GPT-4o
/provider ollama   # Test locally

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

本节内容

简介

用于使用 Astreus 框架构建 agent 的 AI 驱动开发助手。CLI 帮助你直接在终端中创建、测试和迭代 AI agent —— 并且完全了解 Astreus SDK。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

安装

几分钟内即可让 Astreus CLI 运行起来。CLI 是你使用 Astreus 框架构建 agent 的 AI 驱动助手。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

命令

Astreus CLI 所有命令和键盘快捷键的完整参考。使用这些命令管理你的 agent 开发会话、切换模型并组织你的工作流。了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

提供商

简介