Qwen Gate
把 Qwen 网页会话接入本地 OpenAI 兼容 API,供现有开发工具调用。
- Star 数
- ★ 203
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 证据不足
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用OpenAI APIClaude Code(部分支持)
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code、Cursor 或 OpenCode 的开发者,希望把请求指向自托管的 OpenAI 兼容端点并调用 Qwen 模型。
- 不适合
- 需要官方 Qwen API 或服务级别保障的团队
- 不能接受通过浏览器自动化登录 chat.qwen.ai 的用户
这个 Agent 能做什么,适合哪些场景?
Qwen Gate 是一个自托管网关,通过浏览器自动化登录 chat.qwen.ai,并将 Qwen 模型接入 OpenAI 兼容接口。它以 Bun 直接运行 TypeScript,提供 `/v1/chat/completions` 和 `/v1/models` 等接口,客户端可通过本地服务地址发送请求。服务支持 SSE 流式响应、账号轮换、会话池和工具调用解析,并附带用于查看请求、账号和设置的 Web 仪表盘。浏览器用于登录和认证,API 请求使用 wreq-js 的 Node.js fetch 传输。它适合愿意自行部署并管理 Qwen 账号、且客户端支持 OpenAI API 格式的开发者;项目声明仅供教育和研究用途,并非 Qwen 或阿里巴巴官方产品。
运行 qg 或 bun start 后,服务在配置端口(默认 26405)启动 Hono API 和仪表盘。管理员在 /dashboard/accounts 添加 Qwen 邮箱和密码,网关通过 Playwright 完成登录并保存会话;客户端随后向 /v1/chat/completions 发送带模型名、消息及可选工具定义的请求,也可通过 /v1/models 获取模型。网关从 Qwen 获取响应,可用 SSE 返回流式内容,并轮换账号、在限流后冷却和重试;工具调用文本会被解析成 OpenAI 风格的工具调用对象。仪表盘提供概览、日志、账号、网络调试和设置页面,配置与请求日志行为可按设置调整。
- 使用 Claude Code、Cursor 或 OpenCode 的开发者,希望把请求指向自托管的 OpenAI 兼容端点并调用 Qwen 模型。
- 维护多个 Qwen 账号、希望通过轮询、自动故障切换和冷却机制分散请求的个人或小团队。
- 需要 SSE 流式响应的开发者,想让现有 OpenAI 格式客户端连接 Qwen 网页会话。
- 希望在本机或自有服务器上查看请求日志、账号状态和网络调用的网关维护者。
- 要试用工具调用的开发者,能够接受网关从模型生成的文本中解析工具调用这一实现方式及其局限。
如何安装或部署这个 Agent?
Linux 或 macOS 可用安装脚本克隆仓库、安装依赖并建立 CLI 命令;手动安装需要 Git 和 Bun。Windows 可用 PowerShell 安装脚本,或手动克隆并运行 bun install。首次使用需要准备 Qwen 账号,并在仪表盘中添加账号。README 标示 Bun 1.3+,并将浏览器自动化用于登录认证。
如何使用这个 Agent?
安装后启动服务,并在浏览器中打开仪表盘添加 Qwen 账号。需要时在 config.json 设置 API_KEY;默认值为空,表示不启用 API 认证。客户端将基础地址设为 http://localhost:26405/v1,并使用 Bearer token(若已配置)调用聊天补全接口。下方示例展示启动与首次请求:
qgcurl -X POST http://localhost:26405/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-api-key" \
-d '{
"model": "qwen3-max",
"messages": [{"role": "user", "content": "Hello!"}]
}'将 your-api-key 与 config.json 中配置的密钥对应;若未设置密钥,按配置使用不带鉴权的请求。设置 "stream": true 可请求 SSE 流式输出。
这个 Agent 有哪些优点和局限?
- 提供
/v1/chat/completions和/v1/models,可让支持 OpenAI 格式的客户端复用现有接入方式。 - 支持多账号轮询、自动故障切换和冷却跟踪,适合管理多个 Qwen 网页账号。
- 浏览器仅用于登录认证,API 请求走 fetch 传输;会话池可复用并按负载扩缩。
- 内置 SSE、文件上传处理、内容清理和工具调用解析,并提供可查看请求与账号状态的仪表盘。
- 核心依赖 chat.qwen.ai 网页会话和浏览器自动化,受单一服务及其条款约束;项目明确声明非官方且仅供教育研究。
- 需要本地运行 Bun 服务并管理 Qwen 邮箱、密码及持久会话,部署和凭据管理成本高于直接使用托管 API。
- README 说明 Qwen 不原生支持工具调用,网关通过解析模型输出文本转换,效果并不完美。
- README 没有承诺服务级别、配额或长期可用性;网页登录或限流变化可能影响请求。
这个 Agent 与同类方案有什么区别?
相较于直接调用 OpenAI 兼容 API 的托管服务,Qwen Gate 是需要自行运行的本地网关,后端依赖 chat.qwen.ai 网页会话;它的优势是可将该会话包装为 OpenAI 格式端点,代价是需要管理浏览器认证和 Qwen 账号。README 未提供与其他网关的直接比较。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Qwen Gate 当前 | 证据不足 | 命令行工具免费 | ★ 203 | 1 个月前 | TypeScript | OpenAI API |
| HarnessRouter 社区版 | 67 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 3k | 今天 | Python | Codex · Claude Code |
| My Free Code | 54 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 624 | 1 天前 | Python | Claude Code · OpenAI API · Claude API |
| OpenClacky | 48 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.2k | 今天 | Ruby | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
- 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
- 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
- 源码中未见:数据流向说明运行时观察它连接了哪些外部服务(代理或防火墙日志);弄清数据去向之前不要输入敏感数据。
- 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 源码中未见:来源归属可核验从官方仓库或包源安装,核对发布者和仓库地址,避免同名仿冒包。
- 此结论源于输入材料不完整;没有据此认定存在安全红线,也没有执行或独立测试。
- README 描述会处理 Qwen 账户凭据和会话,并提示账户专用化及服务条款要求;实际凭据存储、网络流量和访问控制方式无法从所给材料核实。
常见问题
使用 Qwen 模型是否需要按 token 付费?
需要准备哪些账号和运行环境?
它能直接用于 OpenAI SDK 或 Claude Code 吗?
http://localhost:26405/v1;请求通过本地网关转发到 Qwen。