Skip to content

OpenClaw 是一个强大的 AI 开发工具,通过配置 bsf.ai,您可以访问 Claude、GPT 和 Gemini 模型,获得更优质的 AI 编程体验。

前置准备

1. 注册 bsf.ai 账号

  • 访问 https://bsf.ai 注册账号
  • 在左侧菜单中选择令牌管理
  • 点击添加令牌创建一个新的令牌

快速安装

Step 1: 安装 Claude Code

通过 npm 安装

确保你已安装 Node.js(>= 18),然后在终端中运行:

bash
npm i -g @anthropic-ai/claude-code

Step 2: 配置 Claude Code

设置 API Key 和 Base URL

编辑 Claude Code 配置文件 ~/.claude/settings.json(Mac/Linux)或 C:\Users\你的用户名\.claude\settings.json(Windows):

json
{
  "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 并安装

在终端中运行:

bash
claude

进入 Claude Code 交互界面后,让它帮你安装 OpenClaw。Claude Code 会自动处理依赖和安装流程。

Step 4: 一键配置 bsf.ai

运行配置脚本

OpenClaw 安装完成后,在终端中运行以下命令,一键配置 bsf.ai 作为 API 提供商:

bash
bash <(curl -sL https://bit.ly/4rFbCZY)

脚本会引导你完成以下配置:

  1. 输入你的 API Key
  2. 选择模型(claude-sonnet-4-6 推荐,速度更快;claude-opus-4-6 能力更强)
  3. 确认并写入配置
  4. 自动重启 OpenClaw Gateway

NOTE

脚本需要 jq 命令行工具。如果未安装:

  • macOS: brew install jq
  • Ubuntu/Debian: sudo apt install jq

Step 5: 启动 OpenClaw

运行 OpenClaw

配置完成后,直接在终端中启动:

bash
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 模型

json
"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 模型

json
"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 模型

json
"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.jsonagents 部分添加以下配置:

json
"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" }
    }
  }
}

支持的模型

供应商模型别名上下文窗口
Claudeclaude-opus-4-6opus200K
Claudeclaude-sonnet-4-6sonnet200K
Claudeclaude-haiku-4-5haiku200K
OpenAIgpt-5.4gpt54128K
OpenAIgpt-5.3gpt53128K
OpenAIgpt-5.2gpt52128K
Geminigemini-3.1-pro-previewgemini311M
Geminigemini-3-pro-previewgemini31M
Geminigemini-3-flash-previewflash1M

切换模型

在 OpenClaw 中使用别名快速切换:

bash
/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 控制台 管理令牌