跳到主要内容

模型配置

PicoClaw 采用以模型为中心的配置方式。只需指定 vendor/model 格式即可接入新的提供商——零代码改动!

这种设计还支持多 Agent 灵活调用:

  • 不同 Agent 使用不同提供商:每个 Agent 可以有自己的 LLM 提供商
  • 模型备用(Fallback):配置主要模型和备用模型,提高可靠性
  • 负载均衡:将请求分发到多个端点
  • 集中管理:所有提供商配置在同一个地方

支持的提供商

提供商model 前缀默认 API 地址协议获取 API Key
OpenAIopenai/https://api.openai.com/v1OpenAI获取
Anthropicanthropic/https://api.anthropic.com/v1Anthropic获取
智谱 AI(GLM)zhipu/https://open.bigmodel.cn/api/paas/v4OpenAI获取
DeepSeekdeepseek/https://api.deepseek.com/v1OpenAI获取
Google Geminigemini/https://generativelanguage.googleapis.com/v1betaOpenAI获取
Groqgroq/https://api.groq.com/openai/v1OpenAI获取
Moonshot(Kimi)moonshot/https://api.moonshot.cn/v1OpenAI获取
通义千问(Qwen)qwen/https://dashscope.aliyuncs.com/compatible-mode/v1OpenAI获取
NVIDIAnvidia/https://integrate.api.nvidia.com/v1OpenAI获取
Ollama(本地)ollama/http://localhost:11434/v1OpenAI无需 Key
OpenRouteropenrouter/https://openrouter.ai/api/v1OpenAI获取
vLLM(本地)vllm/http://localhost:8000/v1OpenAI无需 Key
Cerebrascerebras/https://api.cerebras.ai/v1OpenAI获取
火山引擎volcengine/https://ark.cn-beijing.volces.com/api/v3OpenAI获取
Antigravityantigravity/Google Cloud自定义仅 OAuth
GitHub Copilotgithub-copilot/localhost:4321gRPC

基础配置

{
"model_list": [
{
"model_name": "gpt4",
"model": "openai/gpt-5.2",
"api_key": "sk-your-openai-key"
},
{
"model_name": "claude",
"model": "anthropic/claude-sonnet-4-6",
"api_key": "sk-ant-your-key"
},
{
"model_name": "glm",
"model": "zhipu/glm-4.7",
"api_key": "your-zhipu-key"
}
],
"agents": {
"defaults": {
"model": "gpt4"
}
}
}

各提供商示例

OpenAI

{
"model_name": "gpt4",
"model": "openai/gpt-5.2",
"api_key": "sk-..."
}

Anthropic(Claude)

{
"model_name": "claude",
"model": "anthropic/claude-sonnet-4-6",
"api_key": "sk-ant-your-key"
}

也可运行 picoclaw auth login --provider anthropic 粘贴 API Token。

智谱 AI(GLM)

{
"model_name": "glm",
"model": "zhipu/glm-4.7",
"api_key": "your-key"
}

DeepSeek

{
"model_name": "deepseek",
"model": "deepseek/deepseek-chat",
"api_key": "sk-..."
}

Ollama(本地部署)

{
"model_name": "llama3",
"model": "ollama/llama3"
}

自定义代理 / API

{
"model_name": "my-model",
"model": "openai/custom-model",
"api_base": "https://my-proxy.com/v1",
"api_key": "sk-..."
}

负载均衡

为同一个 model_name 配置多个端点,PicoClaw 会自动轮询:

{
"model_list": [
{
"model_name": "gpt4",
"model": "openai/gpt-5.2",
"api_base": "https://api1.example.com/v1",
"api_key": "sk-key1"
},
{
"model_name": "gpt4",
"model": "openai/gpt-5.2",
"api_base": "https://api2.example.com/v1",
"api_key": "sk-key2"
}
]
}

从旧版 providers 迁移

旧版 providers 配置已废弃,但仍向后兼容。

旧配置(已废弃):

{
"providers": {
"zhipu": {
"api_key": "your-key",
"api_base": "https://open.bigmodel.cn/api/paas/v4"
}
},
"agents": {
"defaults": {
"provider": "zhipu",
"model": "glm-4.7"
}
}
}

新配置(推荐):

{
"model_list": [
{
"model_name": "glm-4.7",
"model": "zhipu/glm-4.7",
"api_key": "your-key"
}
],
"agents": {
"defaults": {
"model": "glm-4.7"
}
}
}

详细迁移步骤请参考迁移指南

语音转文字

备注

Groq 提供免费语音转写(Whisper)。配置后,Telegram 语音消息将自动转文字。

{
"model_list": [
{
"model_name": "whisper",
"model": "groq/whisper-large-v3",
"api_key": "gsk_..."
}
]
}