Skip to main content
Gateways 将 Alter 连接到 Discord 和 Telegram 机器人，让你可以从这些 App 与 Alter 聊天。每个 Gateway 都在 Mac 上本地运行 — Alter 必须保持打开并运行，消息才会被处理。
Gateways（Discord/Telegram 机器人）与 设置 → Router 中的 API Gateway 不同，后者为第三方 App 提供 OpenAI 兼容端点。该功能请参阅 API Gateway 指南。

​
Gateways 做什么

Gateways 让你从已打开的聊天平台使用 Alter：
  • Discord — 向机器人发私信，或在服务器频道中 @ 提及它（配置后）。
  • Telegram — 在私聊或群组中向机器人发消息。
每个 Gateway 实例有自己的名称、默认 Action、访问控制和连接设置。对话与 Hub 聊天一样保存在 Mac 上的 Alter 中 — Gateways 是开始和继续这些对话的另一种方式。 当有人发送消息时，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 创建 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。 只要 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 聊天。在已有线程内的回复会继续该聊天，而不是再开一个。

​
隐私与数据

  • Bot 令牌 存储在 macOS Keychain 中，而非明文设置文件。
  • Gateway 配置（名称、访问列表、default action）本地保存在 Mac 上 Alter 的偏好设置中。
  • 按频道状态（所选对话、待处理 Action）保存在 Alter 的 Application Support 文件夹中。
  • 消息处理使用与 Hub 相同的本地 Alter 栈 — Gateway 流量没有单独的云端中继。
另请参阅 本地数据与隐私。

​
故障排除

​
连接与 token

​
使用

​
合盖可用性

​
平台说明

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

​
相关页面