OpenClaw 配置指南
什么是 OpenClaw
OpenClaw 是一个开源的个人 AI 助手框架,支持通过 Telegram、Discord、WhatsApp 等平台与 AI 聊天。
安装
macOS / Linux
bash
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
powershell
iwr -useb https://openclaw.ai/install.ps1 | iexnpm 安装
bash
npm install -g openclaw@latest初始化配置
运行初始化命令:
bash
openclaw onboard --install-daemon配置 ai.TokenHub
OpenClaw 支持 OpenAI 兼容协议,可以直接配置 ai.TokenHub 作为 API 提供商。
方法 1:使用 onboard 向导
? Select your AI provider:
> Custom (Third-party/Aggregation Platform)
? Enter the base URL:
https://ai-tokenhub.com/v1
? Enter your API Key:
your_api_key_here方法 2:手动配置
编辑配置文件 ~/.openclaw/openclaw.json:
json
{
"model": "anthropic/claude-sonnet-4-20250514",
"models": {
"providers": {
"openai": {
"apiKey": "your_api_key_here",
"baseURL": "https://ai-tokenhub.com/v1"
}
}
}
}模型配置
使用 Claude 模型
json
{
"models": {
"providers": {
"anthropic": {
"apiKey": "your_api_key_here",
"baseURL": "https://ai-tokenhub.com/v1"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-sonnet-4-20250514"
}
}
}
}使用 GPT 模型
json
{
"models": {
"providers": {
"openai": {
"apiKey": "your_api_key_here",
"baseURL": "https://ai-tokenhub.com/v1"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "openai/gpt-4o"
}
}
}
}配置多个模型
json
{
"models": {
"mode": "merge",
"providers": {
"anthropic": {
"apiKey": "your_api_key_here",
"baseURL": "https://ai-tokenhub.com/v1"
},
"openai": {
"apiKey": "your_api_key_here",
"baseURL": "https://ai-tokenhub.com/v1"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-sonnet-4-20250514",
"fallbacks": [
"openai/gpt-4o",
"openai/gpt-4o-mini"
]
}
}
}
}常用命令
查看配置
bash
openclaw config show检查状态
bash
openclaw gateway status打开控制台
bash
openclaw dashboard切换模型
在聊天中使用 /model 命令切换模型:
/model openai/gpt-4o常见问题
API 错误
检查 API Key 是否正确,以及账户是否有足够的余额。
连接超时
检查网络连接,确保可以访问 https://ai-tokenhub.com。
模型未找到
确保模型名称拼写正确,使用 /model 从列表中选择。