Sanjianke Chatbox · 算力市场连接器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install sanjianke-chatbox
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 sanjianke-chatbox。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Sanjianke Chatbox 是一套集成指南和实用工具包，用于将开源 Chatbox 桌面端和移动端 AI 客户端连接到 api.a7w.cn 算力市场。它帮助 Chatbox 用户通过一个个人 API 密钥访问兼容的同步聊天模型，并提供经过测试的手动设置、JSON 配置导入和 chatbox:// 深层链接操作说明。这个面向特定用途的 Openclaw Skills 扩展解决了常见的设置失败问题：将网关的完整基础 URL 填入 API Host，导致 /v1 路径意外重复。
该软件包包含脚本，可根据实时模型列表生成兼容 Chatbox 的服务商配置，并验证关键 API 契约，包括模型发现、标准聊天补全、服务器发送事件流式传输和身份验证。它不包含 Chatbox 或 API 密钥；用户需自行创建并保护凭据。
Sanjianke Chatbox · 算力市场连接器 应用场景
将 Chatbox 配置为使用 api.a7w.cn 作为兼容 OpenAI 的模型服务商。
将可重复使用的服务商设置导入 Chatbox 1.15.1 或更高版本，且不在 JSON 或深层链接中嵌入 API 密钥。
从网关的实时模型列表中选择受支持的同步聊天模型，并映射视觉或推理能力。
诊断常见连接故障，包括 API Host 值不正确、404 响应、身份验证错误、模型列表为空，以及流式传输没有输出。
在依赖 Chatbox 内置的连接检查之前验证网关集成；该检查只测试对 /models 的访问。
与团队共享安全的服务商配置，同时由每位用户在本地输入自己的 API 密钥。
Sanjianke Chatbox · 算力市场连接器 工作原理
创建个人 api.a7w.cn 账户和 API 密钥；此技能不会提供凭据。
将 Chatbox 配置为兼容 OpenAI 的服务商。推荐设置中，将 API Host 设为 https://api.a7w.cn/api，并将 API Path 留空，以便 Chatbox 追加其默认的 /v1/chat/completions 路径。
使用网关模型列表中的准确 ID 添加模型。配置生成器可以获取实时列表，并筛除 Chatbox 无法作为聊天模型使用的异步图像和视频模型。
选择手动设置，或生成 Chatbox 导入 JSON 和 chatbox://provider/import?... 深层链接。导入文件和链接有意不包含 API 密钥。
在 Chatbox 的服务商设置中输入自己的 API 密钥，然后测试对话。不要将 Chatbox 显示的绿色连接检查视为密钥有效的证明；它检查的是 /models 是否可访问。
需要深入检查模型列表、非流式补全、SSE 流式传输和身份验证时，运行验证脚本。
Sanjianke Chatbox · 算力市场连接器 配置指南
要求：Python 3.8 或更高版本、可访问 https://api.a7w.cn 的网络，以及个人 API 密钥。脚本仅使用 Python 标准库。手动配置服务商通常适用于各版本 Chatbox；JSON 和深层链接导入需要 Chatbox 1.15.1 或更高版本。
在 https://api.a7w.cn/ 注册，完成任何必要的账户验证，并在用户中心创建自己的 API 密钥。切勿使用或分享他人的密钥。
在 Chatbox 中打开 Settings → Model Provider → Add，选择 OpenAI API compatible，输入密钥，并将 API Host 设为 https://api.a7w.cn/api。将 API Path 留空，并添加有效的模型 ID。
要生成导入配置，请在技能目录中运行相应脚本：
python -X utf8 scripts/gen_import_config.py --out a7w-provider.json
默认配置会选择一组经过筛选的模型。要请求更多模型，例如：
python -X utf8 scripts/gen_import_config.py --all --limit 20
导入生成的 JSON 或打开其 chatbox:// 深层链接，然后在 Chatbox 中本地输入 API 密钥。
要验证网关的 API 行为，请通过 ~/.a7w/config.json 或 A7W_API_KEY 环境变量配置密钥，然后运行：
python -X utf8 scripts/verify_a7w.py
使用以下命令运行离线逻辑测试：
PYTHONDONTWRITEBYTECODE=1 python -X utf8 scripts/selftest.py -v
请勿将 API 密钥放入源代码、Git 仓库、聊天消息、生成的配置或深层链接中。建议使用的正确 API Host 是 https://api.a7w.cn/api；若在 Chatbox 默认路径下使用 https://api.a7w.cn/api/v1，可能会导致 /v1 重复并返回 404。
Sanjianke Chatbox · 算力市场连接器 数据架构与分类体系
此技能由文档、Python 实用工具和参考指南组成：
路径 用途
scripts/verify_a7w.py 检查四项 API 契约：模型列表、非流式聊天补全、SSE 流式传输和身份验证。
scripts/gen_import_config.py 获取实时模型列表，并生成兼容 Chatbox 的服务商 JSON 配置以及 chatbox:// 导入深层链接。
scripts/selftest.py 运行实用工具脚本的离线逻辑测试。
references/configure.md 手动设置、导入格式、深层链接和 API Host 比较。
references/models.md 模型选择指南和兼容性边界。
references/troubleshooting.md 针对 404、401 和空响应等错误的症状说明。
生成器会将网关的 supports_vision 和 supports_reasoning 元数据映射到 Chatbox 能力，并筛除异步图像或视频模型。生成的配置和深层链接不包含 API 密钥；用户需在 Chatbox 中添加凭据。脚本从 ~/.a7w/config.json 或 A7W_API_KEY 读取凭据，并依赖 Python 标准库模块。模型的可用性和数量可能变化，因此应以实时的 GET /v1/models 响应为准，不要将文档中记载的数量视为固定值。
Sanjianke Chatbox · 算力市场连接器 高级特性
经过验证的 API Host 指南：
说明为何
https://api.a7w.cn/api
是推荐的 Chatbox API Host，以及为何追加
/api/v1
可能造成
/v1
路径重复并返回 404。
三种设置方式：
支持手动配置、服务商 JSON 导入和
chatbox://
深层链接导入；后两种方式需要 Chatbox 1.15.1 或更高版本。
实时模型发现：
根据网关当前模型列表生成服务商配置，而非依赖硬编码的目录。
能力映射与筛选：
映射视觉和推理元数据，并排除不适用于 Chatbox 同步聊天补全工作流的异步模型。
四项契约验证：
/v1/models
、非流式补全、SSE 流式传输（包括流结束情况）和身份验证行为。
凭据保护措施：
生成的 JSON 和导入链接不包含 API 密钥；脚本从本地配置文件或环境变量读取密钥。
离线自测：
提供仅依赖标准库的实用工具逻辑测试脚本。
明确的兼容性边界：
Chatbox 集成涵盖同步聊天补全，不包括异步应用工作流、嵌入或重排序。

name: sanjianke-chatbox slug: sanjianke-chatbox
displayName: 三剪客 · Chatbox 接入算力集市
description: "把 Chatbox（开源桌面/移动 AI 客户端）接到算力集市 api.a7w.cn，一个 Key 用上 75 个模型。含手动配置逐步说明、一键导入配置生成（JSON + chatbox:// 深链）、apiHost 填法实测对照、契约自检脚本与排错。已实测：apiHost 必须填 https://api.a7w.cn/api，直接填 /api/v1 会 404。适用于想把 Chatbox 换成国产模型、或用自有算力跑 Chatbox 的场景。遇到问题可加技术微信 9872659。" version: 1.2.2
summary: "把开源客户端 Chatbox 接到算力集市 api.a7w.cn 的完整接入包。本包最有价值的一点是实测出来的 apiHost 填法：Chatbox 的 apiPath 默认 /v1/chat/completions，所以 apiHost 只能填到 https://api.a7w.cn/api；填入 /api/v1 会双拼成 /api/v1/v1/... 返回 404——这是接入失败的首要原因。另含一键导入配置生成器（读真实模型清单，输出 Chatbox ≥1.15.1 可导入的 JSON 与 chatbox:// 深链）、4 项契约自检（模型列表/非流式/流式 SSE/鉴权）与排错手册。遇到问题可加技术微信 9872659。"
license: MIT
tags:

• Chatbox
• 算力集市
• a7w
• OpenAI兼容
• 客户端接入
• 模型网关

三剪客 · Chatbox 接入算力集市

把开源客户端 Chatbox 接到 算力集市 api.a7w.cn：一个 Key、一份账单，用上 75 个模型。

这个 Skills 包解决的问题很具体——Chatbox 接入算力集市的失败，绝大多数不是"连不上"，而是 API Host 填错了一层。

🔑 API Key 说明（重要，请先读这一段）

本 Skill 不含任何 API Key，也不会替你使用任何人的 Key。

请到 算力集市 · api.a7w.cn 注册， 在「用户中心 → API 密钥」申请 你自己的 Key（需实名认证）
请勿使用他人分享的 Key —— 包括朋友给的、群里发的，以及本文档作者的
本 Skill 生成的配置与导入链接一律不含 Key；Key 只在你本机填写一次
Key 等同于账户余额，不要写进代码、不要提交到 Git、不要发到聊天里
每个 Key 可单独设置消费上限（quota），建议按项目分配
⚠️ 第一条，也是最重要的一条

Chatbox 里的 API Host 要填：

https://api.a7w.cn/api

不是 https://api.a7w.cn/api/v1。

为什么

Chatbox 的官方文档写明：API path 一般不用填，默认是 /v1/chat/completions（见 Chatbox 模型配置文档）。也就是说，最终请求 URL 是：

apiHost + "/v1/chat/completions"

而算力集市对外公布的 Base URL 是 https://api.a7w.cn/api/v1。很多人（包括照抄文档的人）会直接把它粘进 API Host 字段，于是：

https://api.a7w.cn/api/v1 + /v1/chat/completions

= https://api.a7w.cn/api/v1/v1/chat/completions ← 404

实测对照（真发的请求，不是推断）

# API Host API Path 实际请求 URL 结果

A ✅ https://api.a7w.cn/api 默认（不填） api.a7w.cn/api/v1/chat/completions 200 通
B ✅ https://api.a7w.cn /api/v1/chat/completions api.a7w.cn/api/v1/chat/completions 200 通
C ❌ https://api.a7w.cn/api/v1 默认（不填） api.a7w.cn/api/v1/v1/chat/completions 404

推荐 A：API Host 填 https://api.a7w.cn/api，API Path 留空不动。

实测结论：Chatbox 能正常使用

用一个真实 Key 对 Chatbox 所依赖的四条契约逐个真发请求：

检查项 结果
GET /v1/models（模型列表） ✅ HTTP 200，解析到 75 个模型
POST /v1/chat/completions（非流式） ✅ HTTP 200，正常返回内容与 usage
POST /v1/chat/completions stream=true（流式 SSE） ✅ HTTP 200，Content-Type: text/event-stream，60+ 个 data 块，以 [DONE] 正确结束
无 Key 调用 ✅ HTTP 401（鉴权确实生效）

4/4 通过。 Chatbox 默认开流式，而流式这条是通的——这点很关键，很多网关只做了非流式，接进 Chatbox 后表现为"能连上但不出字"。

随时可复跑：

python -X utf8 scripts/verify_a7w.py

三种接入方式
方式 适用 做法
① 手动配置 所有人 Chatbox 设置 → 模型提供方 → 添加 → 选「OpenAI API 兼容」→ 填 Key 与 API Host
② 一键导入 JSON Chatbox ≥ 1.15.1 用本包脚本生成配置，粘贴导入
③ 深链导入 Chatbox ≥ 1.15.1 点 chatbox://provider/import?... 直接导入
方式 ①：手动配置（最稳）
打开 Chatbox → 侧栏 设置 → 模型提供方
底部点 添加
名称随意（如 算力集市），API 类型选 OpenAI API 兼容
API Key 填你的 ；API Host 填 https://api.a7w.cn/api
API 路径留空（默认 /v1/chat/completions 就是对的）
添加至少一个模型，模型 ID 必须与网关一致，例如 DeepSeek-V4-Flash （有视觉能力的勾 vision，推理模型勾 reasoning）
保存后点 检查 / Check，应显示连接成功
回首页新建对话即可

⚠️ 第 7 步的「检查」只验证 /models 可达，不验证 Key 是否有效。看到绿勾仍可能调用失败——别把绿勾当成完全可用。

方式 ②③：一键导入（推荐给要分发给多人用的场景）

# 生成配置（会读网关真实模型清单，只读、不产生对话费用）
python -X utf8 scripts/gen_import_config.py --out a7w-provider.json

# 全量纳入（默认只给 8 个精选模型）
python -X utf8 scripts/gen_import_config.py --all --limit 20

输出里会带一条 chatbox://provider/import?config= 深链，点开即导入。

🔐 安全约定：生成的配置与深链一律不含 API Key——深链会被转发、 留在浏览器历史里，携带可复用凭证会造成泄露（脚本里对此有硬校验）。 导入后在 Chatbox 的提供方设置里手动填一次 API Key 即可。

生成器做的事：拉 /v1/models 的真实清单 → 把网关的 supports_vision / supports_reasoning 映射成 Chatbox 的 capabilities → 只挑同步文本模型（异步的图片/视频模型不能放进聊天客户端）→ 按官方 导入配置格式 输出。

工作流路由
你要什么 看哪份
一步步配置、两种方式对照、apiHost 怎么填 references/configure.md 75 个模型怎么挑、哪些模型不能加进 Chatbox references/models.md 报错/连不上/能连上不出字 references/troubleshooting.md
一键导入配置 JSON 与深链的字段含义 references/configure.md 第 3 节
脚本清单
脚本 作用
scripts/verify_a7w.py 契约自检：模型列表 / 非流式 / 流式 SSE / 鉴权，4 项
scripts/gen_import_config.py 生成 Chatbox 可导入的提供方配置（JSON）+ chatbox:// 深链
scripts/selftest.py 上面两个脚本的纯逻辑自测（离线，19 用例）

全部零依赖，只用 Python 标准库。Key 从 ~/.a7w/config.json 或环境变量 A7W_API_KEY 读取，脚本内不内嵌任何密钥。

PYTHONDONTWRITEBYTECODE=1 python -X utf8 scripts/selftest.py -v

能力边界

覆盖：

Chatbox 接入算力集市的完整配置路径（手动 / 导入 / 深链三种）
实测出来的 apiHost 正确填法与三种填法对照
契约自检脚本（含流式 SSE——这是最容易漏测的一条）
一键导入配置生成器，模型能力自动映射

不覆盖：

不代替 Chatbox 客户端：本包不含 Chatbox 程序，也不修改它
不含 API Key、不代付费用：Key 与点数必须是你自己的账号
不覆盖算力集市的异步应用：Chatbox 是聊天客户端，只能吃 /chat/completions。 算力集市的 21 个异步应用（TTS / 数字人 / 视频生成 / 超分 / 换装…）走的是 POST /api/v1/apps/{app}/{code} + task_id 轮询，Chatbox 原生不支持， 要接得自建任务适配层，或直接用 one-key-ai-gateway 那个技能包
不保证可用性：模型上下架、限流与计费以站内为准
依赖条件 Python 3.8+，仅标准库（urllib / json / base64） 一个算力集市账号，并在 用户中心 → API 密钥 创建 Key（需实名）
Chatbox ≥ 1.15.1（只有一键导入 / 深链需要这个版本；手动配置任何版本都行）
能访问 https://api.a7w.cn 的网络出口
已知限制
apiHost 填法是最容易错的一处，且错了之后的报错（404 / HTML 页面）不会提示"你多写了一层 /v1"。本包已把正确值写死在生成器里（build_provider_config 默认 https://api.a7w.cn/api），并有回归测试守着它不被改成 /api/v1
「检查」按钮不代表 Key 有效：它只探 /models
只能接同步聊天模型：网关 75 个模型里，异步的图片/视频生成模型不能加进 Chatbox 的模型列表（生成器已自动过滤）
无 embedding / rerank：网关不提供这两类模型，所以 Chatbox 的知识库（若有）无法用本网关做向量化
模型清单与价格随时变：实测 75 个，官网口径 87+；以现场 GET /v1/models 为准
自检清单
API Host 填的是 https://api.a7w.cn/api？不是 /api/v1？
API Path 留空了（没手填 /v1/chat/completions 造成双拼）？
模型 ID 是从 GET /v1/models 拿的真名，不是猜的？
跑过 scripts/verify_a7w.py，流式那一项也 PASS？
Know 了「检查」绿勾 ≠ Key 有效？
有没有把异步应用（TTS/视频/数字人）误以为 Chatbox 能用？
参考文件
文件 用途
references/configure.md 手动配置逐步说明、一键导入配置格式与深链、apiHost 三种填法对照
references/models.md 75 个模型怎么挑、能加/不能加进 Chatbox 的模型类型
references/troubleshooting.md 按症状排错：404、401、402、能连不出字、模型列表空
关于作者

本 Skill 由作者亲自实操验证后发布。 下载后可自用、可商用。 使用中遇到任何问题，欢迎加技术微信 9872659 交流—— 报一下是从哪个 Skill 找来的，直接给你配套的 API Key 和能跑通的示例。

相关链接
链接 地址 说明
算力集市 · 注册领 API Key api.a7w.cn 一个 Key 调用全部 AI 算力；注册、充值、创建 Key 都在这
算力集市 API 文档 api.a7w.cn/docs.html 接口清单与公共参数
Chatbox 官网 chatboxai.app 下载客户端
Chatbox 模型配置文档 docs.chatboxai.app 官方配置说明（apiPath 默认值的出处）
Chatbox 导入配置格式 docs.chatboxai.app 一键导入 JSON 与深链规范
Chatbox 仓库 github.com/chatboxai/chatbox 开源仓库
AI 插件市场 aigc.a7w.cn 浏览全部 AI 插件与接口说明
Botdid 每日工作日志
Sanjianke · A7W Full Protocol Bridge