OpenMAIC 新手教程

第 3 章:配置模型

至少配一家 LLM。官方推荐 Gemini 3 Flash:质量和速度比较均衡。

1最小配置

复制 .env.example 为 .env.local 后,填其中一家即可启动:

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
OPENROUTER_API_KEY=sk-or-...

也可用 server-providers.yml,不必全写进环境变量:

providers:
  openai:
    apiKey: sk-...
  anthropic:
    apiKey: sk-ant-...

2支持哪些提供商

README 列出:OpenAI、Azure OpenAI、Anthropic、Amazon Bedrock、Google Gemini、DeepSeek、Qwen、Kimi、MiniMax、Grok (xAI)、OpenRouter、豆包、腾讯混元 / TokenHub、小米 MiMo、智谱 GLM、Ollama、Lemonade,以及任意 OpenAI 兼容接口。本地语音识别可用 FunASR。

推荐默认模型:Gemini 3 Flash。要服务器 API 也走 Gemini,设 DEFAULT_MODEL=google:gemini-3-flash-preview。更高质量、更慢可用 Gemini 3.1 Pro。

3国内常用示例

# 智谱(国内默认)
GLM_API_KEY=...
GLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4
DEFAULT_MODEL=glm:glm-5.1

# 国际站改
# GLM_BASE_URL=https://api.z.ai/api/paas/v4

# 小米 Token Plan(国内)
MIMO_API_KEY=tp-...
MIMO_BASE_URL=https://token-plan-cn.xiaomimimo.com/v1
DEFAULT_MODEL=xiaomi:mimo-v2.5-pro

4可选:完全本地

Lemonade 可当本地 OpenAI 兼容的 LLM / 图像 / TTS / ASR,不需要云 Key:

LEMONADE_BASE_URL=http://localhost:13305/v1
TTS_LEMONADE_BASE_URL=http://localhost:13305/v1
ASR_LEMONADE_BASE_URL=http://localhost:13305/v1
IMAGE_LEMONADE_BASE_URL=http://localhost:13305/v1

也支持 Ollama。语音转写可自建 FunASR。这些都不是第一次跑通的前提。

OpenMAIC 新手教程 · 清华大学 MAIC 团队开源的多代理交互课堂
GitHub 仓库 · 在线体验 · MIT 开源