前置要求
- ✅ 已成功安装 OpenClaw
- ✅ 拥有有效的 API Key(gaccode.com,没有订阅可发送任意邮件到gaccode@163.com获取),此处默认Claude分组
配置步骤
步骤 1:打开配置文件
方式 A:图形界面(推荐新手)
在终端输入以下命令,系统将自动用「文本编辑」打开配置文件:
open -e ~/.openclaw/openclaw.json
方式 B:命令行编辑器
使用文本编辑器打开配置文件:
# macOS/Linux
nano ~/.openclaw/openclaw.json
# 或使用其他您喜欢的编辑器
vim ~/.openclaw/openclaw.json
步骤 2:修改配置内容
在配置文件中找到 "auth"、"models"、"agents" 这三个部分,如果还未配置新增即可,将它们完整替换为以下内容(注意不要删除其他配置模块):
2.1 替换/新增 auth 配置
"auth": {
"profiles": {
"tui:default": {
"provider": "tui",
"mode": "api_key"
}
}
}
2.2 替换/新增 models 配置
⚠️ 重要:将 "your-api-key-here" 替换为您实际的 API Key!
💡 提示:
- 如果您使用的是
gaccode方案,更改baseUrl的地址为:https://gaccode.com/claudecode - 可以自行更换配置中的模型,只需修改
models数组中的id和name即可
"models": {
"providers": {
"tui": {
"baseUrl": "https://gaccode.com/claudecode",
"apiKey": "your-api-key-here(在gaccode.com中api栏生成)",
"api": "anthropic-messages",
"models": [
{
"id": "claude-sonnet-4-5-20250929",
"name": "Claude Sonnet 4.5",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
},
{
"id": "claude-opus-4-5",
"name": "Claude Opus 4.5",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
2.3 替换/新增 agents 配置
"agents": {
"defaults": {
"model": {
"primary": "tui/claude-sonnet-4-5-20250929",
"fallbacks": [
"tui/claude-opus-4-5"
]
},
"models": {
"tui/claude-opus-4-5": {},
"tui/claude-sonnet-4-5-20250929": {}
}
}
}
步骤 3:完整配置示例
完成后,您的配置文件应该包含以下内容(以及其他原有的配置模块):
{
"auth": {
"profiles": {
"tui:default": {
"provider": "tui",
"mode": "api_key"
}
}
},
"models": {
"providers": {
"tui": {
"baseUrl": "https://api.tu-zi.com",
"apiKey": "your-api-key-here",
"api": "anthropic-messages",
"models": [
{
"id": "claude-sonnet-4-5-20250929",
"name": "Claude Sonnet 4.5",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
},
{
"id": "claude-opus-4-5",
"name": "Claude Opus 4.5",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "tui/claude-sonnet-4-5-20250929",
"fallbacks": [
"tui/claude-opus-4-5"
]
},
"models": {
"tui/claude-opus-4-5": {},
"tui/claude-sonnet-4-5-20250929": {}
}
}
}
}
步骤 4:保存并重启
- 保存配置文件
- 方式 A 图形界面:按
Command + S保存,关闭窗口即可 - 方式 B nano 编辑器:按
Ctrl + O保存,Ctrl + X退出 - 方式 B vim 编辑器:按
ESC,输入:wq保存退出
- 重启 OpenClaw 使配置生效,在终端输入以下命令:
openclaw gateway restart
✅ 验证配置
配置完成后,使用 TUI(终端用户界面)模式测试是否配置成功:
openclaw tui
### 测试对话
在 TUI 界面中输入一个简单的问题来测试:
```
你好,请做个自我介绍
你好!我是运行在 OpenClaw 框架里的 AI 助手,...
💡 提示
配置完成后,您可以:
- 通过命令行直接进行对话
- 集成到飞书等通讯工具
- 构建自定义 AI 工作流
祝使用愉快! 🎉