为 OpenClaw 智能体工作流配置 Taotoken 作为模型供应商

1. 准备工作

在开始配置之前，请确保您已安装 OpenClaw 框架并创建了 Taotoken 账户。您需要从 Taotoken 控制台获取有效的 API Key，并在模型广场查看支持的模型 ID。这些信息将在后续配置步骤中使用。

2. 使用 TaoToken CLI 快速配置

TaoToken 官方提供了 CLI 工具 @taotoken/taotoken，可简化 OpenClaw 的配置流程。以下是推荐的使用方法：

npm install -g @taotoken/taotoken
taotoken openclaw --key YOUR_API_KEY --model claude-sonnet-4-6

执行上述命令后，CLI 会自动完成以下配置：

• 将 baseUrl 设置为 https://taotoken.net/api/v1
• 将 agents.defaults.model.primary 设为 taotoken/claude-sonnet-4-6
• 将配置写入 OpenClaw 的默认配置文件

您也可以使用简写参数 -k 和 -m：

taotoken oc -k YOUR_API_KEY -m claude-sonnet-4-6

3. 手动配置文件修改

如果您需要更精细的控制，可以手动编辑 OpenClaw 的配置文件。通常配置文件位于 ~/.openclaw/config.json（Linux/macOS）或 %USERPROFILE%\.openclaw\config.json（Windows）。

以下是关键配置项示例：

{
  "providers": {
    "taotoken": {
      "baseUrl": "https://taotoken.net/api/v1",
      "apiKey": "YOUR_API_KEY"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "taotoken/claude-sonnet-4-6"
      }
    }
  }
}

请注意 baseUrl 必须包含 /v1 路径，这是 OpenAI 兼容 API 的必要部分。

4. 环境变量配置方式

对于容器化或需要动态配置的场景，您也可以通过环境变量设置：

export OPENCLAW_PROVIDER_TAOTOKEN_BASEURL=https://taotoken.net/api/v1
export OPENCLAW_PROVIDER_TAOTOKEN_APIKEY=YOUR_API_KEY
export OPENCLAW_AGENTS_DEFAULTS_MODEL_PRIMARY=taotoken/claude-sonnet-4-6

这些变量会被 OpenClaw 自动读取并覆盖配置文件中的相应设置。

5. 验证配置

配置完成后，您可以通过运行简单的测试命令验证连接是否正常：

openclaw test-connection --provider taotoken

如果配置正确，您应该能看到类似以下的输出：

Connection to Taotoken provider successful.
Model: taotoken/claude-sonnet-4-6 is available.

6. 常见问题排查

如果遇到连接问题，请检查以下几点：

1. 确认 baseUrl 正确包含 /v1 路径
2. 验证 API Key 是否有效且未过期
3. 检查模型 ID 是否与 Taotoken 模型广场中列出的完全一致
4. 确保网络连接可以访问 https://taotoken.net

如需进一步帮助，请参考 OpenClaw 接入说明。