跳转到主要内容
Gateways 让你通过兼容 MCP 的 AI 代理使用 Alter,或通过 Discord 和 Telegram 与 Alter 聊天。工具和操作由 Mac 上的 Alter 执行;处理请求时 Alter 必须保持运行。
Gateways 与 设置 → Router 中的 API Gateway 不同,后者为第三方 App 提供 OpenAI 兼容端点。该功能请参阅 API Gateway 指南。

Gateways 做什么

Gateways 让你通过聊天平台和 AI 代理使用 Alter:
  • MCP Gateway — 连接兼容的 AI 代理以搜索会议、运行获准操作并与 Alter 聊天。参阅 Remote MCP 设置 或 ChatGPT 插件指南。
  • Discord — 向机器人发私信,或在服务器频道中 @ 提及它(配置后)。
  • Telegram — 在私聊或群组中向机器人发消息。
每个 Gateway 实例有自己的名称、默认 Action、访问控制和连接设置。对话与 Hub 聊天一样保存在 Mac 上的 Alter 中 — Gateways 是开始和继续这些对话的另一种方式。 对于 Discord 和 Telegram,收到消息时 Alter:
  1. 通过平台机器人连接接收消息。
  2. 运行选定的 Alter Action(例如 Ask Anything)。
  3. 将回复流式传回 Discord 频道或 Telegram 聊天。
  4. 可下载传入附件,并上传工具运行产生的输出文件。

打开 Gateways 设置

1

打开设置

按 ⌘,(Command + 逗号),点击菜单栏中的 Alter 图标并选择 设置…,或从 notch 的 ⋯ 菜单打开 设置。
2

前往 集成 → Gateways

在设置侧边栏中打开 集成,然后选择 Gateways。
也可以直接深链:com.wearedevx.alter://settings?id=gateways Gateways 页面显示所有已配置的 Gateway。使用 添加 Gateway 创建 MCP Gateway、Discord 或 Telegram 连接。

设置指南

Discord gateway

创建 Discord 机器人、启用 intents、邀请到服务器,并在 Alter 中连接。

Telegram gateway

通过 BotFather 创建机器人,并将 token 粘贴到 Alter。

Gateway 设置参考

所有 Gateway 共享以下字段: 平台特定的 连接 字段见设置指南: 保存已启用的 Gateway 后,Alter 会显示状态行,例如 已连接为 @username,或可操作的错误信息。

合盖時保持 Gateways 在线

在 MacBook 上,合上盖子通常会让 Mac 进入睡眠并断开 Gateway 机器人。Alter 可以在合盖时保持活跃的 Gateway 可用。 在 設定 → 集成 → Gateways 顶部:

电池保护

Alter 会自动暂停合盖可用性以保护电池续航:
  • 低于此值時暫停 — Mac 未插电且放电时,Alter 在此电量或以下恢复正常睡眠(默认 20%,可在 5% 到 50% 之间以 5% 步进调整)。充电超过该阈值后,合盖可用性会重新开启。
  • 低電力模式下暫停 — macOS 低电量模式开启时始终生效。
关闭主开关会保留已安装的管理员权限,以便再次启用时无需重新提示。若要完全撤销,请在 选项… 中使用 移除管理者权限…。
合盖可用性会修改受保护的 macOS 睡眠设置。Alter 还会运行安全监控,在 App 意外停止时恢复正常睡眠。Gateways 仍要求 Alter 保持运行 — 此功能是让 Mac 保持唤醒,而不是让 Alter 在关闭时继续工作。

哪些 Action 可用于 Gateways?

Action 需主动选择外部平台。在 Action Editor 中打开 Gateways 部分,选择 可用性:
内置 Ask Anything Action 默认为 全部 — 是新 Gateway 的常用 默认 Action。若只要本地使用,将 Ask Anything 设为 无。自定义 Action 默认 无,直到启用某平台或 全部。
在 设置 → Integrations → Gateways 中,每个 Gateway 显示其平台的 可用 Action 列表。可用来确认已启用的 Action,并直接进入 Action Editor → Gateways 编辑任一 listed Action。 在 Discord 和 Telegram 中,只要 Action 在该平台可用,仍可用 /new [action] 或 Choose action 选择器按会话切换 Action。

无参数与有参数 Action

当用户从 Choose action(或 /actions)选择 Action 时:
  • 无参数 Action(Action Editor 中无输入字段)会立即开始 — Alter 用已配置的 prompt 运行 Action,与 Hub 中一键启动相同。
  • 有参数 Action(含输入字段)会开始新会话,并等待下一条消息以便用户提供输入。

聊天命令与控制

Discord 和 Telegram 支持相同的文本命令(作为普通消息输入)。在 Telegram 上,命令也可带机器人后缀,例如 /help@YourBotName。 在 Discord 上,机器人连接时 Alter 还会注册原生斜杠命令(/help、/new、/actions、/chats、/history、/stop、/status)。若设置了 Server ID,命令仅在该服务器注册;否则为机器人应用全局注册。 两个平台还提供常用任务的按钮 — 例如 /help 中的 New chat、Choose action 和 Past chats。Telegram 使用内联键盘;Discord 使用消息组件。当 Action 使用 Ask User 工具时,Alter 通过相同交互控件呈现多选题(并接受「Other」答案的文字回复)。 非命令消息会被视为当前对话中的一轮聊天。

日常使用

  1. 在 Mac 上保持 Alter 运行,并启用 Gateway(已启用)。在 MacBook 上,若希望合盖时机器人保持连接,请开启 合盖時保持 Gateways 在线。
  2. 在 Discord 或 Telegram 向机器人发消息(或在 Discord 服务器中 @mention,当 在服务器中需要 @提及 开启时)。
  3. Alter 在 Action 运行期间显示 Thinking… 占位符,然后更新为流式回复。在 Telegram 私聊中,若支持,Alter 可通过 Telegram 原生草稿预览流式输出;在群组中会编辑普通消息。
  4. 在 Discord 或 Telegram 附加文件 — Alter 会下载供该轮使用,并可上传工具输出文件。语音消息和音频文件会使用所选语音处理器(设置 → Voice)转写并以文本发送给 Alter;较长音频也会作为会议式转写上下文附加。
  5. 使用 /stop、Stop 按钮(Telegram 群组和 Discord),或等待当前轮次结束后再在同一频道或聊天中发送下一条消息。

一次只处理一条回复

Alter 每个频道或聊天同时只处理一条进行中的回复。若 Alter 仍在回复时又收到消息,机器人会提示 Alter 已在该频道或聊天中回复。请等待当前轮次结束后再发送。

对话连续性

每个 Discord 频道或 Telegram 聊天可有一个活跃的 Alter 对话。使用 /new 重新开始,或使用 /chats 和 /use 从 Mac 恢复已有 Alter 对话。 在 Discord 上,启用 在线程中開始服务器討論 后,每条新的服务器顶层消息会有独立线程和 Alter 聊天。在已有线程内的回复会继续该聊天,而不是再开一个。

Gateways 上的计划 Action 输出

计划的 Alter Actions 可以将自动开场响应发布到已连接的 gateway,而不仅限于 Hub。
1

在 gateway 上启用 Action

在 Action Editor → Gateways 中打开 Action,将 Availability 设为平台、启用所需的 gateway 开关,或使用 All。
2

开启计划 gateway 投递

启用 Start scheduled conversations on a gateway,选择已启用的 Discord、Telegram 或 Buzz (内部) gateway,然后选择 Destination(服务器频道、Telegram 聊天或 Buzz 流/论坛/DM)。
3

保存并测试

保存 Action 并运行或等待计划。Alter 将开场响应及输出附件投递到所选目标。
仅 Buzz: 当 Action 应回退到默认目标而无需每次命名时,在 gateway 上设置 Default scheduled destination。参见 Buzz gateway (internal)。
若保存的目标不再可访问,请在下次计划运行前于 Action Editor 或 gateway 设置中刷新目标。

隐私与数据

  • Bot 令牌 存储在 macOS Keychain 中,而非明文设置文件。
  • Gateway 配置(名称、访问列表、default action)本地保存在 Mac 上 Alter 的偏好设置中。
  • 按频道状态(所选对话、待处理 Action)保存在 Alter 的 Application Support 文件夹中。
  • 工具和操作在 Mac 上的 Alter 中运行。MCP Gateway 使用 Alter 中继传递请求和结果,包括代理请求时的转录文本。连接的代理会收到你允许其读取的数据。
另请参阅 本地数据与隐私。

故障排除

连接与 token

使用

合盖可用性

平台说明

  • Alter 必须运行 — 关闭 Alter 会停止 Gateway 机器人,直到重新打开 App。在 MacBook 上,合盖時保持 Gateways 在线 在 Gateway 运行期间保持 Mac 唤醒,但 Alter 仍需保持打开。
  • 两个平台都会忽略机器人消息。
  • Discord 处理消息时添加 👀,轮次结束时添加 ✅ 或 ❌。用户添加的反应不会被视为命令或聊天输入。
  • Telegram 对 message 和 callback_query 更新(内联键盘点击)使用 long polling。轮次完成后,Alter 可能对你的消息回复 👍 或 👎。群聊在活跃轮次期间显示 Stop 按钮。
更广泛的工具与权限问题,请使用 设置 → Doctor 或 Tools not working。

相关页面