简体中文
接入文档

BitCloud API 文档中心

按工具查看 Base URL、API Key、模型与客户端配置说明,帮助团队直接接入统一网关。

当前文档OpenClaw
Markdown 已转换为页面内容OpenClaw

OpenClaw 配置

BitCloud API 兼容 OpenAI 协议,支持在 OpenClaw 中使用,可参考本文进行配置与使用。


前置工作

获取凭证

项目
BASE_URL(OpenAI 兼容协议)https://web.bitcloud.com.cn/v1
API Key格式:sk-xxxxx
获取方式前往 控制台 → 令牌管理 页面创建

安装 OpenClaw

前置条件:Node.js 22 或更新版本

macOS/Linux:

bashcurl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

powershelliwr -useb https://openclaw.ai/install.ps1 | iex

配置和使用

方法 1:交互式配置向导

安装完成后,将自动开始配置过程。您也可以运行以下命令开始配置:

bashopenclaw onboard --install-daemon

1. 配置供应商

  • 我理解 OpenClaw 默认面向个人使用;共享/多用户使用需要加固? ➡️ Yes
  • 设置模式 ➡️ QuickStart
  • 配置处理 ➡️ 查看并更新
  • Model/auth provider ➡️ 选择 Custom / OpenAI Compatible

2. 配置模型和 API Key

  • 输入 BitCloud API Key
  • 设置 Base URL 为 https://web.bitcloud.com.cn/v1
  • 选择需要的模型

3. 继续完成后续配置

  • 选择频道、选择搜索提供方、配置技能等
  • 完成设置

4. 测试机器人

  • How do you want to hatch your bot? ➡️ 可在 TUI/Web UI 中和机器人对话
  • TUI:输入 openclaw tui,若成功对话则表示配置成功
  • Web UI:通过打开终端中显示的 Web UI (with token) 链接来访问 Web UI

方法 2:修改配置文件

将以下内容完整复制到配置文件 ~/.openclaw/openclaw.json 中(实际使用时按需更换 BASE_URL 和 API Key):

json{
  "auth": {
    "profiles": {
      "bitcloud:default": {
        "provider": "bitcloud",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bitcloud": {
        "baseUrl": "BASE_URL",
        "apiKey": "API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bitcloud/gpt-4o"
      },
      "models": {
        "bitcloud/claude-sonnet-4-20250514": {},
        "bitcloud/gpt-4o": {}
      }
    }
  }
}

接入更多渠道

OpenClaw 提供了更多渠道供您与机器人交互,如 Web UI、Discord、飞书等,可参考官方文档来设置这些渠道:Chat Channels - OpenClaw


常见问题

如何选择模型?

模型广场 查看所有可用模型,根据任务需求选择合适的模型 ID 填入配置。