安装指南

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

什么是

Sanjianke · A7W Full Protocol Bridge 是一项 Openclaw Skills 集成，可让现有的兼容 OpenAI 客户端通过一个本地基础 URL，连接到 api.a7w.cn 算力市场。它可转换聊天、流式 SSE、文本转语音、语音转文本、图像生成和应用任务请求，无需修改受支持的客户端。
该桥接器提供 75 个模型和 21 款生成应用，包括 TTS、语音克隆、ASR、SRT/VTT 字幕、图像生成、数字人、视频生成、超分辨率、服装替换、音乐和去水印。它使用 Python 标准库在本地运行，支持可选的嵌入向量转发，并专为 Dify、n8n、Chatbox、Cline、MoneyPrinterTurbo、VideoCaptioner、ComfyUI 及其他兼容 OpenAI 的软件等工具而设计。

应用场景

使用本地兼容 OpenAI 的端点，将 Dify、FastGPT、RAGFlow、n8n、Langflow 或其他 AI 平台连接到 A7W。
为已支持 OpenAI 音频 API 的应用添加语音合成和语音克隆功能。
将音频转录为文本、SRT、VTT 或包含片段和词级时间元数据的 verbose JSON。
使用兼容 OpenAI 的图像生成客户端生成图像并接收图像 URL。
通过一个透明的应用路由，支持视频、字幕、数字人、超分辨率、音乐及其他生成工作流。
将同一个本地网关用于 Chatbox、Cherry Studio、LobeChat、Open WebUI、AnythingLLM、Cline、Roo Code、Continue、Aider 和 OpenHands。
将嵌入向量路由到 Ollama 等独立的兼容 OpenAI 服务，同时让客户端只使用一个基础 URL。
使用内置健康检查、离线自测和包含 12 个用例的端到端测试套件，在本地验证集成。

工作原理

通过 https://api.a7w.cn/ 的 A7W 账户中心创建自己的 API 密钥；此技能不包含或分发 API 密钥。
启动本地桥接器；它默认监听端口 8788，并通过本地服务保存与上游 A7W 的连接。
将客户端基础 URL 配置为 http://127.0.0.1:8788/v1，保留桥接器要求的 /v1 路径。
向 /v1/chat/completions、 /v1/audio/speech、 /v1/audio/transcriptions、 /v1/images/generations 或 /v1/embeddings 发送标准的兼容 OpenAI 请求。
桥接器将兼容的请求转换为 A7W 上游模型或应用协议，并处理同步响应、异步任务，以及通过 _wait: true 进行的可选轮询。
对于特定应用的功能，请调用统一路由 ANY /a7w/{app}/{code}。
检查 /health 和 /v1/models，以验证配置并发现可用的 146 个条目，其中包括 75 个模型和 71 项应用能力。
运行自测或端到端测试脚本，验证流式响应、音频、字幕、图像生成和可选的嵌入向量转发。

配置指南

前置条件
Python 3.8 或更高版本。
可访问 https://api.a7w.cn 的网络连接。
个人 A7W 账户和 API 密钥。切勿将密钥提交到源代码管理中、嵌入应用代码或在聊天中分享。
无需执行 pip install；桥接器使用 Python 标准库模块。
启动桥接器
python -X utf8 scripts/a7w_bridge.py --port 8788
启动后，将兼容客户端配置为：
base_url = http://127.0.0.1:8788/v1
api_key = any-client-value
桥接器使用本地配置的上游密钥；根据集成设置，也可以使用请求标头中的密钥。有关特定客户端的说明，请参阅 references/integrate.md；有关一键式 .cmd 或 .sh 启动器，请参阅 references/launcher.md。
可选的嵌入向量转发
export A7W_EMBEDDING_BASE_URL=http://127.0.0.1:11434/v1
export A7W_EMBEDDING_MODEL=bge-m3
export A7W_EMBEDDING_API_KEY=sk-xxx
未进行此配置时，/v1/embeddings 会返回 HTTP 501，并提供设置指引。启用后，嵌入向量会转发到所选的兼容 OpenAI 服务。
验证安装
PYTHONDONTWRITEBYTECODE=1 python -X utf8 scripts/selftest.py -v
python -X utf8 scripts/test_bridge.py
自测会运行 26 个离线逻辑用例，端到端套件则会检查 12 项实时网关行为，并且需要可用的上游 API 密钥。
Sanjianke · A7W Full Protocol Bridge 数据架构与分类体系
面向客户端的路由
路由 用途 输出或行为
GET /health 检查桥接器运行状况和配置 报告密钥状态和嵌入向量设置
GET /v1/models 发现可用能力 列出 146 个条目：75 个模型和 71 项应用能力
POST /v1/chat/completions 聊天和推理 支持标准响应和流式 SSE 响应
POST /v1/audio/speech 文本转语音 返回生成的 audio/mpeg 数据
POST /v1/audio/transcriptions 语音识别 支持 text、SRT、VTT 和 verbose_json 格式
POST /v1/images/generations 图像生成 返回生成的图像 URL
POST /v1/embeddings 向量嵌入 未配置时返回 501，或转发到外部服务商
ANY /a7w/{app}/{code} 应用能力 面向 21 款 A7W 应用的统一直通路由
生成文件和仓库文件
路径 作用
scripts/a7w_bridge.py 主要的本地协议桥接器；无外部 Python 依赖
scripts/test_bridge.py 实时端到端验证，涵盖 12 个集成用例
scripts/selftest.py 离线逻辑验证，包含 26 个测试用例
references/launcher.md 创建一键启动脚本的说明
references/integrate.md 各客户端的基础 URL 和集成指南
元数据和任务约定
通过 /v1/models 发现模型元数据，而不是将其硬编码到客户端配置中。
应用任务通过 /a7w/{app}/{code} 中的应用标识符和操作代码调用。
异步应用请求可包含 _wait: true，以便自动轮询直至任务完成。
在受支持的情况下，转录元数据可能包含字幕时间戳、片段、verbose JSON 字段和词级时间信息。
API 密钥属于本地机密，因此不会被写入生成的配置或文档。

高级特性

通过一个本地基础 URL，为聊天、音频、图像、嵌入向量和应用工作流提供 OpenAI 协议转换。
支持流式聊天补全的 Server-Sent Events，并正确处理
text/event-stream
[DONE]
终止标记。
自动桥接同步的短文本 TTS 请求与异步的长文本 TTS 任务。
_wait: true
请求选项统一轮询异步任务。
提供支持字幕的 ASR 输出格式，包括 SRT、VTT 和
verbose_json
，并包含片段级和词级时间戳。
通过包含 146 个模型和应用条目的目录自动发现能力。
可选地将嵌入向量委托给 Ollama 或其他兼容 OpenAI 的嵌入服务，同时让客户端继续使用单一端点。
本地健康诊断可显示上游密钥状态和嵌入向量配置，但不会暴露密钥本身。
运行时零依赖，基于 Python 标准库，可在常见环境中移植使用。
内置离线和实时验证工作流，用于回归测试，涵盖 TTS 到 ASR 往返测试、图像生成、SSE 流式传输、字幕生成和嵌入向量转发。
广泛兼容 Openclaw Skills 工作流，以及允许自定义
base_url
的现有 AI 客户端，最大限度减少集成改动。

name: sanjianke-a7w-bridge slug: sanjianke-a7w-bridge
displayName: 三剪客 · a7w 全量协议桥
description: "一行 base_url，让上百个开源 AI 项目瞬间用上算力集市 api.a7w.cn 的全部能力——75 个大模型 + 21 个生成应用（TTS / 音色克隆 / 语音转文字 / 出图 / 数字人 / 视频生成 / 超分 / 换装 / 音乐）。自动补齐 OpenAI 协议的语音与图像端点，把 ASR 的字级时间戳直接输出成 SRT / VTT / verbose_json 字幕；Dify、n8n、MoneyPrinterTurbo、pyvideotrans、VideoCaptioner、ComfyUI 等无需改一行代码即可接入。本地零依赖运行，一行命令启动，实测 12/12 通过。遇到问题可加技术微信 9872659。" version: 1.1.1
summary: "把算力集市 api.a7w.cn 的全部能力翻译成生态通用的 OpenAI 协议，让任何 OpenAI 兼容客户端零改造接入：chat、TTS、ASR（含 SRT/VTT 字幕）、出图、以及 21 个生成应用的统一透传口。零依赖、本地常驻、一行命令启动。实测 12/12 通过：TTS→ASR 往返一字不差、真实出图、流式 SSE、字幕生成。附一键启动脚本与逐项目接入配方。遇到问题可加技术微信 9872659。"
license: MIT
tags:

• 算力集市
• a7w
• OpenAI兼容
• 协议适配
• TTS
• ASR
• 字幕
• 出图
• Dify
• n8n

三剪客 · a7w 全量协议桥

一行 base_url，把算力集市的全部能力接进你现有的 AI 项目。

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

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

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

你已经在用某个开源 AI 项目——Dify 做知识库、MoneyPrinterTurbo 批量出片、 VideoCaptioner 做字幕、ComfyUI 玩出图。现在想换成国产算力、一个 Key 通吃。

你把 base_url 改成算力集市，对话跑通了，然后：

点「生成配音」 → 报错
点「语音转字幕」 → 报错
点「生成图片」 → 报错

于是你以为「这个网关不支持」。

其实能力一直都在，只是协议对不上。 算力集市有两条入口：

模型网关 POST /api/v1/chat/completions ← 真 OpenAI 兼容，客户端直接用 ✅
应用任务 POST /api/v1/apps/{app}/{code} ← 自有异步协议，客户端不认 ❌

而开源生态只会说 OpenAI 那几种协议。中间缺一层翻译。

这个桥就是那层翻译。

二、它能做什么

装完这个桥，你的客户端什么都不用改，就能用上：

能力 说明
💬 对话 / 推理 75 个模型：DeepSeek、千问、智谱、Kimi、文心、混元、MiniMax、OpenAI、Google…
🔊 文字转语音 长短文本自适应，短文本走同步、长文本自动转异步
🎙️ 音色克隆 上传参考音频即可生成专属音色
📝 语音转文字 支持 SRT / VTT / verbose_json 字幕输出，带字级时间戳
🖼️ 文生图 / 图片编辑 直接返回图片 URL
🎬 21 个生成应用 数字人、视频生成、超分、换装、音乐、水印消除…统一透传口
🔌 embedding 可选外挂：把向量化转发到你自己的 bge-m3 等服务
📋 模型自动发现 GET /v1/models 一次返回 146 项（75 模型 + 71 应用能力）

一句话：以前只能聊天的客户端，现在 TTS、ASR、出图全都能调。

三、三分钟上手

# 1) 启动（想双击运行：把 references/launcher.md 里的脚本存成 .cmd 即可）
python -X utf8 scripts/a7w_bridge.py --port 8788

启动后你会看到：

================================================================
a7w-bridge —— 算力集市全量协议桥

上游 : https://api.a7w.cn
API Key : 已配置（sk-***）
embedding : 未配外挂（/v1/embeddings 返回 501 + 配置指引）

客户端 base_url : http://127.0.0.1:8788/v1
健康检查 : http://127.0.0.1:8788/health 21 个应用全量透传 : http://127.0.0.1:8788/a7w/{app}/{code}

# 2) 把你客户端的 base_url 改成它

base_url = http://127.0.0.1:8788/v1
api_key = 任意值（桥会用本机 Key，也可在请求头自带）

就这两步。 原本报错的能力全部可用。

代码里怎么用
from openai import OpenAI
c = OpenAI(base_url="http://127.0.0.1:8788/v1", api_key="dummy")

# 对话

c.chat.completions.create(model="DeepSeek-V4-Flash",
messages=[{"role": "user", "content": "你好"}])

# 配音

c.audio.speech.create(model="s2-pro", voice="alloy", input="今天天气不错")

# 字幕（一条拿到 SRT，带时间轴）

r = c.audio.transcriptions.create(model="whisper-1", file=open("a.mp3","rb"),
response_format="srt")
open("a.srt","w",encoding="utf-8").write(r)

# 出图

c.images.generate(model="nano-banana", prompt="一只在窗台上晒太阳的橘猫")

全量应用（21 个都走这个口）

curl -s http://127.0.0.1:8788/a7w/voice_tts/list_voices \

-H 'Content-Type: application/json' -d '{}'

# 加 "_wait": true 自动轮询到任务完成
curl -s http://127.0.0.1:8788/a7w/flashvsr/submit \

-H 'Content-Type: application/json'
-d '{"video_url":"https://...","_wait":true}'

四、实测：12/12 全通过

用真实 Key、真发请求，逐项验证：

# 端点 结果

1 GET /health ✅ 报告 Key 状态与 embedding 外挂配置 2 GET /v1/models ✅ 146 项全部可见（75 模型 + 71 应用能力） 3 POST /v1/chat/completions 非流式 ✅ 4 POST /v1/chat/completions 流式 SSE ✅ text/event-stream，正确 [DONE] 5 POST /v1/audio/speech ✅ 返回 audio/mpeg，真实音频 6 POST /v1/audio/transcriptions ✅ TTS→ASR 往返，识别与原文字字一致 7 ...response_format=srt ✅ 输出合法 SRT 字幕 8 ...response_format=verbose_json ✅ 带 segments 分段 9 POST /v1/images/generations ✅ 真实出图，返回图片 URL 10 POST /v1/embeddings（未配外挂） ✅ 明确 501 + 配置指引 11 POST /v1/embeddings（配了外挂） ✅ 正确转发并原样返回 12 ANY /a7w/{app}/{code} ✅ 21 个应用统一透传

随时自己复跑：

python -X utf8 scripts/test_bridge.py

五、支持的客户端与平台

凡是能改 base_url 的，都能接：

类型 代表
大模型应用平台 Dify、FastGPT、RAGFlow、MaxKB、n8n、Langflow、Onyx
聊天客户端 Chatbox、Cherry Studio、NextChat、LobeChat、open-webui、AnythingLLM
编程助手 Cline、Roo Code、Continue、Aider、OpenHands
视频 / 短剧 MoneyPrinterTurbo、pyvideotrans、VideoCaptioner、VideoLingo、NarratoAI、splicr、printfilm
图像 / 工作流 ComfyUI（第三方 API 节点）、InvokeAI

逐项目的具体改法见 references/integrate.md。

提示：桥自己实现了 /v1/*，所以 base_url 要带 /v1。 （直连算力集市网关时则相反——那是 sanjianke-chatbox 里讲的那个坑。）

六、embedding 外挂（可选增强）

算力集市聚焦在生成类能力上，向量化交给更专业的服务更划算。 桥提供外挂转发：客户端仍然只配一个 base_url，chat 走算力集市、 embedding 走你指定的服务。

export A7W_EMBEDDING_BASE_URL=http://127.0.0.1:11434/v1 # Ollama
export A7W_EMBEDDING_MODEL=bge-m3
export A7W_EMBEDDING_API_KEY=sk-xxx # 可选

不配也能用——/v1/embeddings 会返回 501 并附上配置指引。

七、脚本清单
脚本 作用
scripts/a7w_bridge.py 协议桥本体（零依赖，标准库）
references/launcher.md 一键启动脚本（复制成 .cmd / .sh 即可双击运行）
scripts/test_bridge.py 端到端测试：12 项（含 TTS→ASR 往返、SRT、出图、embedding 转发）
scripts/selftest.py 纯逻辑自测（26 用例，离线，不需要 Key）

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

八、依赖条件

Python 3.8+，仅标准库（urllib / json / base64），不需要 pip install

一个算力集市账号 + API Key（注册领取，用户中心 → API 密钥）
能访问 https://api.a7w.cn 的网络出口
九、关于作者

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

相关链接
链接 地址 说明
算力集市 · 注册领 API Key api.a7w.cn 一个 Key 调用全部 AI 算力；注册、充值、创建 Key 都在这
算力集市 API 文档 api.a7w.cn/docs.html 接口清单与示例
AI 插件市场 aigc.a7w.cn 全部 AI 插件与接口说明
三剪客 · 一句话批量出片 ks.a7w.cn 短剧二创 / 影视解说 / 矩阵号批量混剪桌面客户端
视频超清 · 在线批量超分 vr.a7w.cn 网页版视频超分，批量处理，最高 4K
配套技能
技能 分工
one-key-ai-gateway 网关本身的 CLI/SDK：模型清单、应用 schema、任务、账单
sanjianke-chatbox 把 Chatbox 客户端接上算力集市
voice-tts-studio TTS / 克隆 / ASR 的逐接口参数表
Sanjianke Chatbox · 算力市场连接器
地理课程规划助手