@0xmaxma/claude-gateway

中文文档
2.1.12发布于 2026/11/06TypeScriptCommonJS构建来源已验证近 30 天下载 7797

克劳德的多代理网关

中文使用文档
文档目录6 节
  1. 特征
  2. 开始吧
  3. 学多点
  4. 安装卫生
  5. 安全模式调查
  6. 计算机使用同意

克劳德网关

Claude Code的管弦乐、语音和多频道平台.

Claude Gateway在Claude Code的员工执行任务时保持对话响应. 通过您连接的渠道交谈或键入, 跟踪进度, 并携带您的代理员的记忆和技能跨会话 .

Claude Gateway

文档 • 妇女 快速启动 • 妇女 API 参考

特征

  • 🔎 联合评估 ——代理商,职工共享的可选打字选择,分数和名词评价以及范围化整合,具有直接或相容的上游资质. 见 Jev 设置。 。 。 .

  • 🪄 代理管弦乐引擎 ——在工人执行持久任务时进行响应性对话. 仪表板将代理/工人的代号用途分开,提供附有缓存和工具细节的每期报告。 没有开关的现有配置自动升级; 明确 false 仍然是选择退出。 见 管弦乐设置。 。 。 .

  • 🔥 代理指挥 ——在可重复使用的工人执行持久任务的同时,保持对话响应,报告进展情况,接受后续指示,支持取消. 见 协调与任务。 。 。 .

  • ⚙️ 工人的用具 ——在准备就绪时自动将GPT工人传送到本地的Codex,克洛德代码在发送到主机或内部的应用容器之前会回落. Claude代码上还有谈话特工 见 工人的用具。 。 。 .

  • 🧰 纸板 - 装入 点心 Claude 代码插件只针对您所设置的代理 /pstack-setup,以每个代理模型工作表,子代理作为网关任务和现场审查小组状态。 见 纸板。 。 。 .

  • 🎙️ 语音对话 ——通过按代理模式和声音进行语音识别和语音回答,直接或上游提供者,现场或录音语音输入,以及音频重播. 见 语音设置。 。 。 .

  • 🧠 技能自我改进 ——代理从自己的工作中学习可再用的技能:在实质性转会后,背景审查员创建或更新技能,为下回转会热重装. 得到证明的保镖(从未超过人类写作技能),每天封顶,接受审计 SKILLS_LEARNED.md。见 gateway.skillLearning

  • 📚 知识基础(双行道记忆) ——每名代理SQLite/FTS5可搜索档案通过曝光 memory_search 编号 : memory_get MCP工具,所以代理人员回忆到不符合总注入核心的注释;块会携带出处失效而索引被刷新出出自网关事件回路. 见 gateway.knowledge

  • 🌙 夜梦 ——长期内存的背景整合:仅由印刷品审查员向安全应用员写作的操作建议 MEMORY.md 编号 : USER.md (支持、限值损失、预算超出时净负数)。 定型收缩,预算规模的挤压,和 Staleness GC保持内存接近预算而不会忘记——存档条目仍然可以搜索. 见 gateway.dreaming

  • 🤖 多剂 ——从一个单一的网关运行多个bot,每个网关都有孤立的会话

  • 🔒 孤立的内存模式 - 为许多无关的发送者服务的代理人 USER.md编号 :MEMORY.md 每个对话,共享内存,技能,克龙,代理和app工具被关闭;一个应用代理也在自己的沙盒容器中运行每个对话,每个信道工具只回复由来的对话. 设定 agents[].isolateMemory 或 services.agent.isolate_memory 在应用程序 app.yaml。见 孤立内存模式

  • 🔌 多渠道 MCP – 每个频道的模块化工具系统(Telegram, Discord, LINE, Slack, WhatsApp, Cron, 技能, 可扩展到更多)

  • 📥 海峡入侵恢复 ——不可用附件保存消息和可读文件;Telegram/Discord接收器重试隔离对话并归档 stale startup 队列而不执行旧请求. 见 内部复苏。 。 。 .

  • ⏳ 供应商出厂接纳 ——持久冷却约束重复报告/推论失败,保留排队输入和任务结果,并曝光等待状态而不再重启运行的工人. 见 供应商录用设置。 。 。 .

  • 🧩 代理技能 – 通过 SKILL.md 文件可扩展技能系统;代理在运行时可以使用热重装从 URL 创建、删除并安装技能

  • 🎭 代理身份 通过工作空间标记文件定义个性、语气和规则

  • 📡 实时状态信息 实时状态更新,显示工具的使用、思维和进度

  • ⌨️ 打字指标 ——代理工作时连续打入动画(Telegram and Discord)

  • 🌊 流出 API - SSE(服务员-恒星事件)实时响应流的终点

  • ↪️ 自动前进 ——代理文本输出即使没有明确的回复工具调用也自动传输到Telegram

  • ⏰ 心跳/ 预定任务 ——通过HERTBEAT.md + REST API提供基于核心的主动信息和重复任务;代理任务向Telegram, Discord 或两者都提供输出

  • 💬 持续聊天历史 - 双层存储:会话背景(.jsonl+ 永久 SQLite DB 带有 FTS5 全文搜索;存活 /compact 和会议驱逐

  • 🧹 自动清理 ——可配置的留存政策每天排出超过N天的信息和媒体文件

  • 🗄️ 长期记忆 ——会间持续记忆系统

  • 🔄 配置自动移徙 ——配置格式改变时自动进行计划迁移

  • 🔐 访问控制 许可列表、开放或对等的Telegram访问政策

  • 🌐 HTTP API 密码 —— REST API 有基于密钥的外部集成认证

  • 🛍️ 应用程序存储 ——在网关上安装,更新并主机多克编程应用程序;应用程序在 /app/:name/:portName/*,用于主机脚本的可选 Unix 套接字桥,以及可选的 AI 代理注入

  • ⬆️ 自更新日期 ——检查更新版本 claude-gateway 财务报告和审定财务报表 claude-code 然后通过一个API呼叫(不需要SSH或 shell访问)触发更新,或者从终端启动 claude-gateway update 编号 : claude-gateway claude update; 网关跟随 npm stable ditt-tag( 秒数) (--latest (最新版本)

  • 💾 持续会期 ——通过重启保存并恢复对话历史

  • 🖥️ PTY 外壳( 包装外壳模式) ——可选交互式伪地后端(gateway.headless: false用于需要真实 TTY 的工具;包括活浏览器查看器(xterm.js)和 a /api/v1/sessions/:sessionId/screen 将可见屏幕作为纯文本返回的结束点 —— 代理可以进行测试, 以检测挂起状态、 菜单或意外输出, 不解析 ANSI 逃生代码 ; a /cli 聊天命令(Telegram/Discord/LINE)为单一代理打开同一取景器,代理瞄准镜和没有管理键;app代理和管弦乐总是保持无头

开始吧

安装有频道支持的节点.js 22+, Bun, 和一个经认证的克洛德代码 CLI. 管弦乐在Linux,macOS,和Windows上运行. 应用程序需要多克/ 构成; 一些语音格式需要 ffmpeg。 。 。 .

npm install -g @0xmaxma/claude-gateway
claude-gateway gateway start

在另一个终端:

claude-gateway agents create

跟着 快速启动,则 启用管弦乐, (中文(简体) ), 连接频道,可选择 配置语音。 。 。 .

学多点

专题文档
配置和全权证书配置
代理人、工人和任务控制管弦
平台符号和频道设置频道
STT, TTS, 供应商和重放语音
请求、响应、流和权限API 参考
运行、升级和故障排除业务
来源建设和捐款发展

API的文档在文档网站上生活. CLI 命令引用 是生成的命令引用。 要编辑或预览此网站,请参见 网站开发。 。 。 .

安装卫生

运行 claude-gateway doctor 检查启动、语音和可选的 Codex 依赖性,即使 服务器已关闭 。 使用 claude-gateway doctor fix 用于支持当地维修和 丢失的安装 ffmpeg编号 :ffprobe。修理要求确认,绝不 启动或重新启动网关。 见 诊断和维修。 。 。 .

浏览器语音可以在导航后恢复未听到的已核准回复. 保留客户 每会话模式/默特意图并重新连接回放收据;见 语音恢复协议。 。 。 .

浏览器重放在原声之前可供核准口头答复使用 录音完成,包括中断的回放。 明确的重放可以生成 缺少与配置的 TTS 提供者的音频( 正常的提供者收费适用) . 见 重放和重播控制。 。 。 .

安全模式调查

运行 claude-gateway safemode --name investigation --prompt "Inspect this gateway problem" 进行本地互动Claude密码调查 而不阻止网关. 使用 --cli codex 选择代码x, --model 覆盖本地模式,以及 --resume investigation 回到同样的调查。 保护安全模式 建立/启动证据并使用单独的源快照。 会话 ID 是 当地Claude代码/编码; safemode rename ID NEW_NAME 更改别名 没有打扰到谈话。 无头收购, 请求ID和信任的操作员代理控制在 安全模式指南. 受信任的代理人可以发现明确指派的调查,并作为网关管理的任务追踪,自动完成报告和对话控制.

作为网关管理,Paired桌面 MCP连接器也可以通过Jev运行 计算机 使用任务, 并获得本地应用程序的同意和相同的共享思维 配置 。 见 计算机使用连接器。 。 。 . 没有Jev,计算机使用可以选择每个步骤,由代理商自己的模型通过 gateway.computerUse; 见 没有Jev的计算机使用。 。 。 .

计算机能力发现列表 在线计算机配对而不要求访问. 一个由网关管理的计算机任务只有在启动时才要求访问. 桌面 然后所有者选择应用程序(或明确选择所有应用程序)和 a 会期。 拒绝执行;单靠配对和发现永远不会 启动桌面动作。 任务等待取消和所有权的批准 检查活动,而不是要求用户在设置中预先访问.

版本与发布记录

@0xmaxma/claude-gateway 共发布 166 个版本,首次发布于 2026/05/14;过去 12 个月发布了 166 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.1.12latest2026/11/061 天前
2.1.112026/11/052 天前
2.1.102026/11/052 天前
2.1.92026/10/2810 天前
2.1.82026/10/2117 天前
2.1.72026/10/2117 天前

关于 @0xmaxma/claude-gateway 的常见问题

@0xmaxma/claude-gateway 是什么?

克劳德的多代理网关

如何安装 @0xmaxma/claude-gateway?

在项目目录运行 npm install @0xmaxma/claude-gateway,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 claude-gateway,可以用 npx claude-gateway 直接运行。

@0xmaxma/claude-gateway 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@0xmaxma/claude-gateway 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@0xmaxma/claude-gateway 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@0xmaxma/claude-gateway 可以商用吗?

@0xmaxma/claude-gateway 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@0xmaxma/claude-gateway 的下载量有多少?

根据 npm 官方下载统计,@0xmaxma/claude-gateway 在 2026/10/04 – 2026/11/02 这 30 天内被下载 7,797 次,日均约 260 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@0xmaxma/claude-gateway 还在维护吗?

最新版本 2.1.12 发布于 2026/11/06(1 天前);至今共发布 166 个版本,其中过去 12 个月发布了 166 个;首次发布于 2026/05/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。