tflow
控制台
客户端集成

OpenClaw 接入指南

重定向 OpenClaw（开源的本地多平台智能代理）的 API 端点至 tflow，实现跨模型调度、系统钥匙串安全认证与多模型容灾。

什么是 OpenClaw？

OpenClaw (原 Moltbot / Clawdbot) 是一个开源的 AI 智能体平台，能够将对话式 AI 引入 Telegram, Discord, Slack, Signal, iMessage, 和 WhatsApp 等多个社交平台渠道。它支持通过本地命令、文件读取和编辑、网络检索等工具协同工作。配置 tflow 网关后，OpenClaw 可无缝分发请求至数十款高可用大语言模型。

方法一：向导引导初始化 (Setup)

推荐：使用 OpenClaw 引导向导 (Recommended Setup Wizard)

配置 OpenClaw 最简单快捷的方式是使用其内置的 onboarding 初始化向导：

$ openclaw onboard

该向导将引导您交互式配置以下设置：

  1. 选择 OpenAI 作为您的 Provider
  2. 在 API Endpoint 处输入 tflow 端点：https://tflow.ai-links.com
  3. 输入您的 tflow API 访问令牌
  4. 选择您想使用的默认模型名
  5. 配置具体绑定的社群消息接收通道

命令行快速启动 (Quick Start CLI)

若要跳过逐步询问直接生成凭据，可以使用下方的一键指令完成快捷绑定：

cli onboard shortcut
openclaw onboard --auth-choice apiKey --token-provider openai --token "$TFLOW_API_KEY" --endpoint "https://tflow.ai-links.com"

方法二：直接修改配置文件 (Manual Configuration)

安全提示： 手动编辑适合需要进行底层精细配置的高级用户。对于日常配置，我们极力推荐使用上面的 onboarding 向导。

如需手动编辑 OpenClaw 的核心配置文件，请按照以下步骤进行操作：

Step 1: 获取您的 tflow 密钥

  1. 登录您的控制台面板并进入 API Keys 模块
  2. 创建并拷贝您的访问密钥（以 sk- 开头）

Step 2: 编辑配置文件

在 ~/.openclaw/openclaw.json 的 openai 提供商模块中，补充端点和密钥：

~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "openai": {
        "baseUrl": "https://tflow.ai-links.com",
        "apiKey": "sk-your-key",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-v4-pro", "name": "DeepSeek v4 Pro" },
          { "id": "MiniMax-M3", "name": "MiniMax M3" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/deepseek-v4-pro"
      }
    }
  }
}

您也可以选择在当前 Shell Profile 会话环境中设置环境变量以实现同等效果：

$ export OPENAI_API_KEY="sk-your-key"
$ export OPENAI_API_BASE="https://tflow.ai-links.com"

Step 3: 选择模型

在 primary 中指向指定模型，并确立在 `models` 映射列表中已被声明。常见的配置方式举例如下：

MiniMax M3:

"model": {
  "primary": "openai/MiniMax-M3"
}

Google Gemini:

"model": {
  "primary": "openai/gemini-1.5-pro"
}

DeepSeek:

"model": {
  "primary": "openai/deepseek-chat"
}

Step 4: 启动 OpenClaw

保存并退出编辑器后，重新引导 OpenClaw 网关进程：

$ openclaw gateway run

安全凭据托管 (Auth Profiles)

为了实现高阶凭据管理并避免本地的 JSON 配置文件暴露明文秘钥，OpenClaw 支持系统级 Auth Profiles 托管。该配置将把密码以加密的形式保存在当前操作系统的 Keychain（钥匙串凭据管理器）中：

1. 首先在本地 openclaw.json 的顶部声明 `auth` 加密配置框架：

~/.openclaw/openclaw.json (Auth Profile)
{
  "auth": {
    "profiles": {
      "openai:default": {
        "provider": "openai",
        "mode": "api_key"
      }
    }
  }
}

2. 紧接着在终端环境执行系统钥匙串密钥设定命令，将实际密钥安全地存入凭据服务：

inject key into system keychain
openclaw auth set openai:default --key "$TFLOW_API_KEY"

用量与审计监控 (Monitoring Usage)

您通过 OpenClaw 发送的请求用量（如 Token 消耗量、请求频次及响应延迟）会统计在您的 tflow 账户中。您可以登录控制台看板获取实时状态分析：

  1. 进入控制台的用量分析和实时日志
  2. 检索特定的秘钥 ID 以查看流量和消耗量
  3. 查看具体的延迟明细和首字响应耗时

常见问题与诊断

"No API key found for provider 'openai'"

OpenClaw 无法定位其需要调用的 API 秘钥凭证。请确认您的命令行中已导出了 OPENAI_API_KEY 变量，或验证您的 openai:default auth profile 已经配置完成。

调用被拦截并返回 401 或 403 鉴权故障

请校验您的 tflow API 秘钥是否存在拼写错误、是否处于被停用状态、或者检查您令牌下的余额是否足够抵扣消费额度。

加载失败并抛出 "Model not found" 或者模型行为不合规范

OpenClaw 要求所有运行模型必须要在 openclaw.json 的 models 对照表中进行过申明。请确认是否正确引用了 openai/model-id ID 规范。

相关资源 (Resources)