OpenClaw 配置
OpenClaw 支持接入多种 AI Provider。521code 同时提供 OpenAI 兼容协议和 Anthropic/Claude 兼容协议两种接入方式，可根据 OpenClaw 版本和功能支持情况选择。OpenClaw 使用 provider/model 格式引用模型，如 openai/gpt-4o-mini 或 anthropic/claude-sonnet-4-5。
A. OpenAI 兼容协议 推荐
使用 OpenAI Compatible Provider，Base URL 指向 521code 的 OpenAI 兼容端点。
Provider: OpenAI / OpenAI Compatible
Base URL: https://us.efxhp.cn/v1
API Key: sk-xxxx 或 <YOUR_API_KEY>
Model 示例: openai/gpt-4o-mini、openai/gpt-4.1-mini
配置文件示例（JSON/JSONC）
{
"providers": {
"openai": {
"apiKey": "env:OPENAI_API_KEY",
"baseURL": "https://us.efxhp.cn/v1",
"models": {
"defaults": {
"primary": "openai/gpt-4o-mini"
},
"list": [
"openai/gpt-4o-mini",
"openai/gpt-4.1-mini"
]
}
}
},
"agents": {
"defaults": {
"model": {
"provider": "openai",
"primary": "openai/gpt-4o-mini"
}
}
}
}
注意：字段名以实际 OpenClaw 版本为准。以上为示例结构，请参考 OpenClaw 官方文档调整。
环境变量方式
OPENAI_API_KEY=sk-xxxx
OPENAI_BASE_URL=https://us.efxhp.cn/v1
B. Anthropic / Claude 兼容协议
使用 Anthropic Compatible Provider，Base URL 指向 521code 的 Claude 兼容端点。
Provider: Anthropic / Claude Compatible
Base URL: https://us.efxhp.cn
API Key: sk-xxxx 或 <YOUR_API_KEY>
Model 示例: anthropic/claude-sonnet-4-5、anthropic/claude-haiku-4-5
配置文件示例（JSON/JSONC）
{
"providers": {
"anthropic": {
"apiKey": "env:ANTHROPIC_API_KEY",
"baseURL": "https://us.efxhp.cn",
"models": {
"defaults": {
"primary": "anthropic/claude-sonnet-4-5"
},
"list": [
"anthropic/claude-sonnet-4-5",
"anthropic/claude-haiku-4-5"
]
}
}
},
"agents": {
"defaults": {
"model": {
"provider": "anthropic",
"primary": "anthropic/claude-sonnet-4-5"
}
}
}
}
注意：字段名以实际 OpenClaw 版本为准。以上为示例结构，请参考 OpenClaw 官方文档调整。
环境变量方式
ANTHROPIC_API_KEY=sk-xxxx
提示：如果当前 OpenClaw 版本不支持 Anthropic 自定义 Base URL，可优先使用 OpenAI 兼容协议接入 Claude 映射模型（如有提供），或留意后续版本更新。
缓存说明：仅在 OpenClaw 版本/插件明确支持 Anthropic Base URL 和缓存字段（如 beta.max_tokens）时，通过 A 社协议接入才有缓存收益。不支持 Anthropic 自定义 Base URL 或缓存机制的 OpenClaw 版本/插件，建议直接使用 OpenAI 兼容协议 https://us.efxhp.cn/v1 调用映射模型。
验证方式
- 保存配置后重启 OpenClaw。
- 检查模型列表是否正常加载出 521code 提供的模型。
- 发起一次简单对话，观察是否正常返回结果。
- 访问 https://us.status.efxhp.cn 确认 521code 服务状态正常。
常见问题
Q: 模型列表为空？
检查 API Key 是否正确填写，确认 Base URL 末尾是否包含 /v1（OpenAI 协议）或不包含（Anthropic 协议）。
Q: 提示认证失败？
确认 API Key 格式为 sk- 开头，且在 521code 控制台已创建并启用。
Q: 两种协议如何选择？
如无特殊需求，推荐使用 OpenAI 兼容协议，接入更简单，兼容性更好。