OpenClaw配置全流程
1. 配置文件位置
- Windows:
C:\Users\<您的用戶名>\.openclaw\openclaw.json - macOS/Linux:
~/.openclaw/openclaw.json
如何找到配置文件:
Windows:
# 方法一: 直接打開文件夾 explorer C:\Users\$env:USERNAME\.openclaw # 方法二: 查看配置文件內(nèi)容 type C:\Users\$env:USERNAME\.openclaw\openclaw.json
macOS/Linux:
# 方法一: 打開文件夾 open ~/.openclaw # macOS nautilus ~/.openclaw # Linux (GNOME) # 方法二: 查看配置文件內(nèi)容 cat ~/.openclaw/openclaw.json

2. 配置大模型 API Key
方法一: 直接編輯配置文件 (推薦)
步驟 1: 打開配置文件
Windows:
# 使用記事本打開 notepad C:\Users\$env:USERNAME\.openclaw\openclaw.json # 或使用 VS Code 打開 code C:\Users\$env:USERNAME\.openclaw\openclaw.json
macOS/Linux:
# 使用默認(rèn)編輯器打開 open -e ~/.openclaw/openclaw.json # macOS (TextEdit) # 或使用 VS Code 打開 code ~/.openclaw/openclaw.json
步驟 2: 根據(jù)您的模型提供商修改配置
華為云 (MaaS) 配置
獲取 API Key
- 訪問: https://developer.huaweicloud.com/space/developerspace/tokens.html
- 登錄華為云賬號(hào)
- 創(chuàng)建或復(fù)制您的 API Key
配置文件內(nèi)容
{
"auth": {
"profiles": {
"huawei:default": {
"provider": "huawei",
"mode": "api_key"
}
}
},
"models": {
"providers": {
"huawei": {
"baseUrl": "https://api.modelarts-maas.com/openai/v1",
"apiKey": "在這里粘貼您的華為云API Key",
"api": "openai-completions",
"models": [
{
"id": "deepseek-v3.2",
"name": "deepseek-v3.2"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "huawei/deepseek-v3.2"
},
"models": {
"huawei/deepseek-v3.2": {}
},
"workspace": "~/.openclaw/workspace",
"compaction": {
"mode": "safeguard"
},
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
},
"messages": {
"ackReactionScope": "group-mentions"
},
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true,
"ownerDisplay": "raw"
},
"session": {
"dmScope": "per-channel-peer"
},
"channels": {},
"gateway": {
"mode": "local"
},
"plugins": {}
}關(guān)鍵配置項(xiàng)說(shuō)明
models.providers.huawei.apiKey: 您的華為云 API Keymodels.providers.huawei.models[0].id: 模型 ID (如 deepseek-v3.2, glm-5 等)agents.defaults.model.primary: 默認(rèn)使用的模型,格式為huawei/<模型ID>
Doubao (火山引擎) 配置
獲取 API Key 和 Endpoint ID
- 訪問火山引擎控制臺(tái)
- 進(jìn)入"方舟大模型平臺(tái)"
- 創(chuàng)建推理接入點(diǎn),獲取 Endpoint ID
- 獲取 API Key
配置文件內(nèi)容
{
"auth": {
"profiles": {
"doubao:default": {
"provider": "doubao",
"mode": "api_key"
}
}
},
"models": {
"providers": {
"doubao": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
"apiKey": "在這里粘貼您的Doubao API Key",
"api": "openai-completions",
"models": [
{
"id": "在這里粘貼您的Endpoint ID",
"name": "Doubao-1.8"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "doubao/在這里粘貼您的Endpoint ID"
},
"models": {
"doubao/在這里粘貼您的Endpoint ID": {}
},
"workspace": "~/.openclaw/workspace",
"compaction": {
"mode": "safeguard"
},
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
},
"messages": {
"ackReactionScope": "group-mentions"
},
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true,
"ownerDisplay": "raw"
},
"session": {
"dmScope": "per-channel-peer"
},
"channels": {},
"gateway": {
"mode": "local"
},
"plugins": {}
}關(guān)鍵配置項(xiàng)說(shuō)明
models.providers.doubao.apiKey: 您的 Doubao API Keymodels.providers.doubao.models[0].id: 您的 Endpoint ID (如ep-20240604052306-abcde)agents.defaults.model.primary: 格式為doubao/<Endpoint ID>
Anthropic 配置
獲取 API Key
- 訪問: https://console.anthropic.com/
- 登錄或注冊(cè)賬號(hào)
- 在 API Keys 頁(yè)面創(chuàng)建新的 API Key
配置文件內(nèi)容
{
"auth": {
"profiles": {
"anthropic:default": {
"provider": "anthropic",
"mode": "api_key"
}
}
},
"models": {
"providers": {
"anthropic": {
"baseUrl": "https://api.anthropic.com",
"apiKey": "在這里粘貼您的Anthropic API Key",
"api": "anthropic-chat",
"models": [
{
"id": "claude-3-5-sonnet-20240620",
"name": "claude-3-5-sonnet-20240620"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-3-5-sonnet-20240620"
},
"models": {
"anthropic/claude-3-5-sonnet-20240620": {}
},
"workspace": "~/.openclaw/workspace",
"compaction": {
"mode": "safeguard"
},
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
},
"messages": {
"ackReactionScope": "group-mentions"
},
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true,
"ownerDisplay": "raw"
},
"session": {
"dmScope": "per-channel-peer"
},
"channels": {},
"gateway": {
"mode": "local"
},
"plugins": {}
}關(guān)鍵配置項(xiàng)說(shuō)明
models.providers.anthropic.apiKey: 您的 Anthropic API Keymodels.providers.anthropic.api: 必須是anthropic-chatmodels.providers.anthropic.models[0].id: 模型名稱 (如claude-3-5-sonnet-20240620)agents.defaults.model.primary: 格式為anthropic/<模型名稱>
保存配置文件
編輯完成后,保存文件:
- 記事本:
Ctrl + S - VS Code:
Ctrl + S或Cmd + S(macOS)
方法二:使用命令行配置
優(yōu)點(diǎn): 不需要手動(dòng)編輯 JSON 文件,減少格式錯(cuò)誤。
步驟 1: 設(shè)置 gateway 模式
openclaw config set gateway.mode local

步驟 2: 配置華為云 (示例)
# 設(shè)置 baseUrl
openclaw config set models.providers.huawei.baseUrl https://api.modelarts-maas.com/openai/v1
# 設(shè)置 API Key
openclaw config set models.providers.huawei.apiKey "您的API Key"
# 設(shè)置 API 類型
openclaw config set models.providers.huawei.api "openai-completions"
# 設(shè)置模型列表 (JSON 格式)
openclaw config set models.providers.huawei.models --json '[{"id":"deepseek-v3.2","name":"deepseek-v3.2"}]'
# 設(shè)置默認(rèn)模型
openclaw config set agents.defaults.model.primary "huawei/deepseek-v3.2"步驟 3: 驗(yàn)證配置
# 查看完整配置 openclaw config get # 查看特定配置項(xiàng) openclaw config get models.providers.huawei.apiKey
到此這篇關(guān)于OpenClaw(二):配置教程的文章就介紹到這了,更多相關(guān)OpenClaw配置教程內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章
本文檔詳細(xì)介紹了在Mac本地環(huán)境配置OpenClaw與QQ機(jī)器人對(duì)接的完整流程,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨2026-03-18
文章講述了作者在配置環(huán)境變量時(shí)遇到的問題,以及如何通過在shell配置文件和systemd服務(wù)配置中雙重設(shè)置環(huán)境變量來(lái)解決這個(gè)問題,作者還分享了常見的錯(cuò)誤及解決方法,并提出了2026-03-17
OpenClaw多Agent配置實(shí)戰(zhàn)指南:從零搭建你的AI團(tuán)隊(duì)
通過 OpenClaw 配置多 Agent,你可以將“一個(gè)人”拆解為一支分工明確的 AI 團(tuán)隊(duì),本指南將帶你從架構(gòu)選擇到實(shí)戰(zhàn)配置,完成多 Agent 的部署,感興趣的小伙伴可以跟隨小編一起2026-03-16
本文詳細(xì)介紹了配置項(xiàng)"tools"的各個(gè)部分,包括profile、allow、deny和exec,以及approval配置,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的2026-03-13
Mac安裝和配置OpenClaw的超詳細(xì)保姆級(jí)教程(附 skills安裝)
OpenClaw是一個(gè)開源的AI助手框架,支持多模型接入和技能擴(kuò)展,適用于多渠道聊天,文章詳細(xì)介紹了Mac上安裝和配置OpenClaw的步驟,包括安裝OpenClaw CLI、驗(yàn)證安裝、完成onboard2026-03-12
OpenClaw 從零配置指南并接入飛書 + 常用命令 + 原理全解析
本文介紹了如何從零配置OpenClaw并接入飛書,包括安裝、配置、權(quán)限設(shè)置、模型切換、技能管理等步驟,以及常用命令和配置文件說(shuō)明,感興趣的朋友跟隨小編一起看看吧2026-03-12
OpenClaw 使用 JSON/JSON5 格式的配置文件來(lái)管理系統(tǒng)所有組件的設(shè)置,支持靈活的配置覆蓋、環(huán)境變量注入、多配置文件合并、熱重載等功能,本文就來(lái)詳細(xì)的介紹一下OpenClaw主2026-03-10
OpenClaw使用DeepSeek官方API_KEY配置超詳細(xì)教程
近期 OpenClaw突然火了,但是網(wǎng)上居然沒有在openclaw配置deepseek官方apikey的相關(guān)教程,所以下面這篇文章主要介紹了OpenClaw使用DeepSeek官方API_KEY配置的相關(guān)資料,文中將2026-03-09
OpenClaw 安裝與配置實(shí)戰(zhàn)指南(含常用命令 + 故障排查)
OpenClaw安裝與配置實(shí)戰(zhàn),涵蓋了從安裝到故障排查的詳細(xì)流程,重點(diǎn)包括通道配置、模型接入和網(wǎng)關(guān)排障,提供了常用命令速查和故障排查步驟,幫助用戶順利上手和解決常見問題,本2026-03-06










