English
Integration docs

BitCloud API Documentation

Browse Base URL, API key, model, and client setup guides for connecting tools to the unified gateway.

Current documentOpenClaw
Markdown rendered as page contentOpenClaw

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 填入配置。