OpenClaw 🦞

OpenClaw 是开源的本地 AI 助手，可通过 WhatsApp、Telegram、Slack 等渠道处理对话和任务。

OpenClaw 的程序和配置可运行在本地；但发送给模型的提示词、附件、工具结果等内容，会按你的配置传输至 Tokenhot 和所选模型服务。请勿提交敏感信息，或先确认你的数据处理要求。

为什么搭配 Tokenhot？

统一接入：使用一个 API Key 接入 OpenAI、Anthropic、Gemini 等兼容协议。

灵活选型：可按任务配置主模型、备用模型和轻量模型。

统一用量查看：可在 Tokenhot 控制台查看 API Key 和调用记录。

OpenClaw 通常会进行多轮模型调用，复杂任务的 Token 消耗可能明显高于普通聊天。建议先使用较低成本模型测试，再根据任务复杂度调整模型和并发数。

安装

请优先参考 OpenClaw 官方安装文档。

macOS / Linux：

Windows PowerShell：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))

安装脚本会在本机执行命令。请确认来源为 OpenClaw 官方站点，并在公司设备或生产环境中先完成安全评估。

快速开始

1. 获取 API Key

前往 Tokenhot 控制台创建 API Key。

建议将 API Key 保存为环境变量，不要写入公开仓库：

PowerShell：

$env:TOKENHOT_API_KEY = "你的 Tokenhot API Key"

2. 运行配置向导

选择 Custom Provider 后，填写：

配置项	值
Provider Type	`anthropic-messages`
Base URL	`https://api.tokenhot.ai`
API Key	你的 Tokenhot API Key
Model	从 Tokenhot 模型列表复制模型 ID，例如 `claude-sonnet-4.6`

3. 验证配置

查看已配置模型：

设置默认模型：

随后在 OpenClaw 中发送一条简单消息进行测试。若收到正常回复，即表示连接成功。

推荐配置

OpenClaw 的模型引用应使用 provider/model 格式，例如：

tokenhot-anthropic/claude-sonnet-4.6

不要只写 claude-sonnet-4.6；省略 Provider 属于兼容行为，可能在多 Provider 配置下选错模型。

以下示例仅配置 Anthropic Messages 协议。建议先跑通一个协议，再按需增加 OpenAI 或 Gemini。

{
  "models": {
    "providers": {
      "tokenhot-anthropic": {
        "baseUrl": "https://api.tokenhot.ai",
        "apiKey": "${TOKENHOT_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4.6",
            "name": "Claude Sonnet 4.6"
          },
          {
            "id": "claude-opus-4.6",
            "name": "Claude Opus 4.6"
          },
          {
            "id": "claude-haiku-4.5",
            "name": "Claude Haiku 4.5"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "tokenhot-anthropic/claude-sonnet-4.6",
        "fallbacks": [
          "tokenhot-anthropic/claude-haiku-4.5"
        ]
      },
      "models": {
        "tokenhot-anthropic/claude-sonnet-4.6": {
          "alias": "sonnet"
        },
        "tokenhot-anthropic/claude-opus-4.6": {
          "alias": "opus"
        },
        "tokenhot-anthropic/claude-haiku-4.5": {
          "alias": "haiku"
        }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "tokenhot-anthropic/claude-opus-4.6"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "tokenhot-anthropic/claude-haiku-4.5"
        }
      }
    ]
  }
}

模型是否支持图片、文件、音频、推理模式、上下文长度和最大输出长度，以 Tokenhot 当前模型列表和接口返回为准。不要在配置中写入未经实测的能力或限制。

接入其他协议

协议	Provider ID 示例	Base URL	API 类型
Anthropic Messages	`tokenhot-anthropic`	`https://api.tokenhot.ai`	`anthropic-messages`
OpenAI Responses	`tokenhot-openai`	`https://api.tokenhot.ai/v1`	`openai-responses`
Gemini	`tokenhot-gemini`	`https://api.tokenhot.ai`	`google-generative-ai`

仅在目标模型确认支持对应协议时使用。OpenAI Chat Completions 与 OpenAI Responses 不是同一协议；如模型不支持 Responses，请改用对应的 Chat Completions 配置。

使用建议

日常任务：使用主力或轻量模型。

复杂研究、长文分析：切换到能力更强的模型。

涉及发邮件、创建日程、发送消息、文件修改等操作：先确认 OpenClaw 的权限范围，并在执行前检查目标账号、收件人和内容。

自动化任务上线前：先在测试频道或测试账号中验证。

故障排除

无法连接 Tokenhot

确认配置与协议匹配：

Anthropic Messages：https://api.tokenhot.ai

OpenAI Responses：https://api.tokenhot.ai/v1

Gemini：https://api.tokenhot.ai

同时检查：

API Key 是否有效。

环境变量 TOKENHOT_API_KEY 是否已在当前终端加载。

Base URL 末尾没有多余的 /。

当前模型是否已在对应 Provider 的 models 中声明。

模型不存在或无法选择

请确认模型引用完整：

tokenhot-anthropic/claude-sonnet-4.6

并确认 tokenhot-anthropic 与配置文件中的 Provider ID 完全一致。

Token 消耗较高

先使用 quick Agent 或轻量模型验证任务。

降低不必要的并发数和重复任务。

仅在复杂任务中使用 research Agent。

在 Tokenhot 控制台查看调用记录和用量。

如何切换模型

如果已配置别名，可在对话中使用：

/model sonnet
/model opus
/model haiku

也可以恢复默认模型：

/model default

OpenClaw

OpenClaw 🦞#

为什么搭配 Tokenhot？#

安装#

快速开始#

1. 获取 API Key#

2. 运行配置向导#

3. 验证配置#

推荐配置#

接入其他协议#

使用建议#

故障排除#

无法连接 Tokenhot#

模型不存在或无法选择#

Token 消耗较高#

如何切换模型#