客户端与智能体
OpenClaw

OpenClaw

我们提供 4TK 的 OpenClaw provider 插件，可直接通过插件方式接入。

插件目录（仓库内）：

  • openclaw-plugins/openclaw-provider-4tk

官方相关能力可参考：

为什么改为插件

  • 把 4TK 接入变成可安装 provider（onboarding/CLI 可识别），不再是“复制 JSON 片段”。
  • 通过 provider hook 处理 gpt-5.5 / gpt-5.4 的 xhigh 能力声明，减少对二进制 patch 的依赖。
  • 直接在插件里注册 Image provider，默认使用 gpt-image-2 做生成与编辑。
  • 同时注册 memory embedding adapter，确保 openclaw memory 与 capability embedding providers 能识别 4tk。
  • 在插件里统一给出默认策略：memory 默认开启（auto 场景收敛到 4tk）、TTS 默认关闭（可配置默认开启）。

快速开始（插件方式）

当前公开发布渠道为 npm（@4tk/[email protected]）。

# 1) 安装插件
openclaw plugins install @4tk/openclaw-provider-4tk
 
# 2) 通过 OpenClaw 鉴权流程写入 4tk auth profile（推荐）
openclaw models auth login --provider 4tk --method api-key --set-default

如果只 export FOURTK_API_KEY，部分 agent 会话可能仍显示 missingProvidersInUse。 使用 models auth login 可避免该问题，并直接设置默认模型。 若默认模型已是 4tk/* 且 agents.defaults.memorySearch.provider=auto，插件会自动补成 4tk。

0.3.1 补充说明

0.3.1 对图像默认模型做了收敛，默认 imageGenerationModel 为 4tk/gpt-image-2，避免将 chat 模型误作为 Images API 默认模型。

安装后，在 OpenClaw 里确认主模型为：

  • 4tk/gpt-5.5（主会话 / 重推理，可选 xhigh，支持图片输入）

推荐默认策略（插件内置）

能力默认策略说明
对话 / 推理开启通过 openai-responses 走 4TK。
图像生成 / 编辑开启通过 OpenAI Images API 走 4TK，默认补 imageGenerationModel=4tk/gpt-image-2。
Memory Search默认开启默认指向 embedding 模型（text-embedding-3-large）；当主模型是 4tk/* 且 provider 为 auto，会自动收敛为 4tk。
TTS / 语音播报默认关闭避免不必要语音成本与延迟；若配置 enableTtsByDefault=true，会自动补齐 talk provider/model。

若你们后台新增了聊天模型，可通过 plugins.entries["4tk-provider"].defaults.extraModels 追加，不必每次等待插件发版。

推荐模型分工

用途建议模型协议 / 说明
主模型（日常对话、工具调用、重推理）gpt-5.5Responses API（POST /v1/responses，支持 xhigh 与图片输入）
图像生成 / 编辑gpt-image-2OpenAI Images API（POST https://image.4tk.ai/v1/images/generations / .../edits，编辑走 multipart/form-data）
记忆检索（默认开）text-embedding-3-largePOST /v1/embeddings
TTS（默认关，按需开）tts-1-hdPOST /v1/audio/speech

xhigh 说明

插件已通过 provider hook 为 gpt-5.5 / gpt-5.4 声明 xhigh 支持，优先使用插件能力。

OpenClaw 与底层 pi-ai 两侧都会根据「模型 id」判断是否允许 xhigh：若内部把模型写成 4tk/gpt-5.5 这种带 provider 前缀的形式，旧版插件会误判为不支持，或把错误 id 传给上游。@4tk/openclaw-provider-4tk 0.1.1 起会在 hook 与动态模型解析里自动剥掉 4tk/ 前缀，再参与 xhigh 判定与请求。

旧脚本 scripts/patch-openclaw-xhigh-thinking.sh 仍保留作为兼容兜底（当你使用的 OpenClaw 版本对第三方 provider 的 xhigh 判定仍异常时再考虑使用），但不再作为主方案。

常见问题

  • 出现 missingProvidersInUse：说明默认模型已切到 4tk/*，但当前 agent 未读到 4tk 凭据。执行 openclaw models auth login --provider 4tk --method api-key --set-default 后重开 TUI。
  • 连不上 4TK：确认子令牌有效；聊天/embedding 等需可达 api.4tk.ai，生图需可达 image.4tk.ai。
  • 没有看到 4tk provider：确认插件安装成功，并重启 gateway。
  • xhigh 不生效：先确认模型为 4tk/gpt-5.5 或 4tk/gpt-5.4；仍异常再考虑使用补丁脚本兜底。
  • 图像生成或编辑不可用：确认 image provider 使用 4tk/gpt-image-2、插件 0.3.4+ 默认 imageBaseUrl=https://image.4tk.ai/v1，并已完成 models auth login --provider 4tk。
  • TTS 触发了不必要费用：检查 talk / 语音开关，确保默认关闭策略未被覆盖。
CC SwitchHermes Agent