OpenClaw 是一个强大的 AI 开发工具,通过配置 bsf.ai,您可以访问 Claude、GPT 和 Gemini 模型,获得更优质的 AI 编程体验。
前置准备
1. 注册 bsf.ai 账号
- 访问 https://bsf.ai 注册账号
- 在左侧菜单中选择令牌管理
- 点击添加令牌创建一个新的令牌
快速安装
Step 1: 安装 Claude Code
通过 npm 安装
确保你已安装 Node.js(>= 18),然后在终端中运行:
npm i -g @anthropic-ai/claude-codeStep 2: 配置 Claude Code
设置 API Key 和 Base URL
编辑 Claude Code 配置文件 ~/.claude/settings.json(Mac/Linux)或 C:\Users\你的用户名\.claude\settings.json(Windows):
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "替换为你的 API Key",
"ANTHROPIC_BASE_URL": "https://api.bsf.ai",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
},
"permissions": {
"allow": [],
"deny": []
}
}NOTE
配置完成后,可以在终端输入 claude 验证是否能正常连接。
Step 3: 使用 Claude Code 安装 OpenClaw
启动 Claude Code 并安装
在终端中运行:
claude进入 Claude Code 交互界面后,让它帮你安装 OpenClaw。Claude Code 会自动处理依赖和安装流程。
Step 4: 一键配置 bsf.ai
运行配置脚本
OpenClaw 安装完成后,在终端中运行以下命令,一键配置 bsf.ai 作为 API 提供商:
bash <(curl -sL https://bit.ly/4rFbCZY)脚本会引导你完成以下配置:
- 输入你的 API Key
- 选择模型(
claude-sonnet-4-6推荐,速度更快;claude-opus-4-6能力更强) - 确认并写入配置
- 自动重启 OpenClaw Gateway
NOTE
脚本需要 jq 命令行工具。如果未安装:
- macOS:
brew install jq - Ubuntu/Debian:
sudo apt install jq
Step 5: 启动 OpenClaw
运行 OpenClaw
配置完成后,直接在终端中启动:
openclaw如果看到 bsf.ai 已激活的提示,说明配置成功。
快速配置(已有 OpenClaw)
NOTE
前提:OpenClaw 已经有其他模型跑起来,可以自动执行任务,才能使用以下快速配置。
使用以下提示词让 AI 助手帮你快速配置:
我的 bsf.ai 令牌:
你的令牌(需要替换成你的令牌)
根据以下配置,更新到 openclaw.json 配置文件中
https://bsf.ai/config/openclaw-bsf-ai手动配置
编辑 OpenClaw 配置文件 ~/.openclaw/openclaw.json,找到 models 部分,替换为以下内容。
如果没有 models 部分,在最外面的 { } 加入以下代码。
WARNING
请将下面配置中的 你的令牌 替换为您在 bsf.ai 平台创建的令牌。
Claude 模型
"bsf-ai-claude": {
"baseUrl": "https://api.bsf.ai",
"apiKey": "你的令牌",
"auth": "token",
"api": "anthropic-messages",
"authHeader": true,
"models": [
{
"id": "claude-opus-4-6",
"name": "claude-opus-4-6",
"api": "anthropic-messages",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 200000,
"maxTokens": 8192
},
{
"id": "claude-sonnet-4-6",
"name": "claude-sonnet",
"api": "anthropic-messages",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 200000,
"maxTokens": 8192
},
{
"id": "claude-haiku-4-5",
"name": "claude-haiku",
"api": "anthropic-messages",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 200000,
"maxTokens": 8192
}
]
}OpenAI 模型
"bsf-ai-openai": {
"baseUrl": "https://api.bsf.ai/v1",
"apiKey": "你的令牌",
"auth": "token",
"api": "openai-responses",
"authHeader": true,
"models": [
{
"id": "gpt-5.4",
"name": "gpt-5.4",
"api": "openai-responses",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 16384
},
{
"id": "gpt-5.3",
"name": "gpt-5.3",
"api": "openai-responses",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 16384
},
{
"id": "gpt-5.2",
"name": "gpt-5.2",
"api": "openai-responses",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 16384
}
]
}Gemini 模型
"bsf-ai-gemini": {
"baseUrl": "https://api.bsf.ai/v1beta",
"apiKey": "你的令牌",
"auth": "token",
"api": "google-generative-ai",
"authHeader": true,
"models": [
{
"id": "gemini-3.1-pro-preview",
"name": "Gemini 3.1 Pro Preview",
"api": "google-generative-ai",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 8192
},
{
"id": "gemini-3-pro-preview",
"name": "Gemini 3 Pro Preview",
"api": "google-generative-ai",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 8192
},
{
"id": "gemini-3-flash-preview",
"name": "Gemini 3 Flash Preview",
"api": "google-generative-ai",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 8192
}
]
}配置默认 Agent 模型
在 openclaw.json 的 agents 部分添加以下配置:
"agents": {
"defaults": {
"model": {
"primary": "bsf-ai-claude/claude-sonnet-4-6"
},
"fallbacks": [
"bsf-ai-claude/claude-opus-4-6",
"bsf-ai-openai/gpt-5.4",
"bsf-ai-gemini/gemini-3.1-pro-preview"
],
"models": {
"bsf-ai-claude/claude-opus-4-6": { "alias": "opus" },
"bsf-ai-claude/claude-sonnet-4-6": { "alias": "sonnet" },
"bsf-ai-claude/claude-haiku-4-5": { "alias": "haiku" },
"bsf-ai-openai/gpt-5.4": { "alias": "gpt54" },
"bsf-ai-openai/gpt-5.3": { "alias": "gpt53" },
"bsf-ai-openai/gpt-5.2": { "alias": "gpt52" },
"bsf-ai-gemini/gemini-3.1-pro-preview": { "alias": "gemini31" },
"bsf-ai-gemini/gemini-3-pro-preview": { "alias": "gemini3" },
"bsf-ai-gemini/gemini-3-flash-preview": { "alias": "flash" }
}
}
}支持的模型
| 供应商 | 模型 | 别名 | 上下文窗口 |
|---|---|---|---|
| Claude | claude-opus-4-6 | opus | 200K |
| Claude | claude-sonnet-4-6 | sonnet | 200K |
| Claude | claude-haiku-4-5 | haiku | 200K |
| OpenAI | gpt-5.4 | gpt54 | 128K |
| OpenAI | gpt-5.3 | gpt53 | 128K |
| OpenAI | gpt-5.2 | gpt52 | 128K |
| Gemini | gemini-3.1-pro-preview | gemini31 | 1M |
| Gemini | gemini-3-pro-preview | gemini3 | 1M |
| Gemini | gemini-3-flash-preview | flash | 1M |
切换模型
在 OpenClaw 中使用别名快速切换:
/model opus # Claude Opus 4.6
/model sonnet # Claude Sonnet 4.6
/model haiku # Claude Haiku 4.5
/model gpt54 # GPT-5.4
/model gemini31 # Gemini 3.1 Pro常见问题
- 确认
openclaw.json格式正确(可用 JSON 校验工具检查) - 确认令牌已正确替换(不要保留
你的令牌占位符) - 重启 OpenClaw 使配置生效
- 访问 bsf.ai 控制台 管理令牌