配置檔案位置
OpenClaw 使用 JSON 配置檔案，位於~/.openclaw/openclaw.json。
基礎配置
建立或編輯配置檔案~/.openclaw/openclaw.json：
{
"agents": {
"defaults": {
"model": { "primary": "apiyi/gpt-5.4" }
}
},
"models": {
"providers": {
"apiyi": {
"baseUrl": "https://api.apiyi.com/v1",
"apiKey": "sk-你的API易金鑰",
"api": "openai-completions",
"models": [
{ "id": "gpt-5.4", "name": "GPT-5.4" },
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4" },
{ "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }
]
}
}
}
}
配置欄位說明
| 欄位 | 說明 |
|---|---|
agents.defaults.model.primary | 預設模型，格式為 provider名/模型名 |
models.providers | 自定義模型提供商配置 |
baseUrl | API 地址，使用 https://api.apiyi.com/v1 |
apiKey | 你的 API易 金鑰 |
api | API 型別：OpenAI 相容用 openai-completions，Anthropic 相容用 anthropic-messages |
多模型配置
可以配置多個模型，在聊天中用/model <id> 切換：
{
"models": {
"providers": {
"apiyi": {
"baseUrl": "https://api.apiyi.com/v1",
"apiKey": "sk-你的金鑰",
"api": "openai-completions",
"models": [
{ "id": "gpt-5.4", "name": "GPT-5.4" },
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4" },
{ "id": "deepseek-v3.2", "name": "DeepSeek V3.2" }
]
}
}
}
}
完整配置示例
包含模型配置和 Telegram 渠道的完整示例：{
"agents": {
"defaults": {
"model": { "primary": "apiyi/gpt-5.4" }
}
},
"models": {
"providers": {
"apiyi": {
"baseUrl": "https://api.apiyi.com/v1",
"apiKey": "sk-你的API易金鑰",
"api": "openai-completions",
"models": [
{ "id": "gpt-5.4", "name": "GPT-5.4" },
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4" },
{ "id": "deepseek-v3.2", "name": "DeepSeek V3.2" }
]
}
}
},
"channels": {
"telegram": {
"enabled": true,
"accounts": {
"default": {
"token": "你的Telegram Bot Token"
}
}
}
}
}
配置檔案修改後，需要重啟 Gateway 服務才能生效：
openclaw gateway restart