OpenAB Grok

OpenAB 是一个轻量的开源 Rust 程序，通过 stdio JSON-RPC 将 Discord 和 Slack 桥接到任何支持 Agent Client Protocol 的 coding CLI。

此模板部署 Grok 变体 — 使用 xAI 官方 coding agent CLI Grok Build 作为后端，通过 grok agent stdio 启动。

注意事项

• 镜像标签： 此模板使用固定版本（0.8.3-beta.11）。如需升级，请在 Zeabur Dashboard → 服务 → 设置中更改镜像标签。可用标签：GitHub Packages。
• 持久化存储： /home/agent 挂载为持久化磁盘。Grok 认证数据（~/.grok/auth.json）、设置、config 会在重启后保留。

设置步骤

1. 获取 Discord Bot Token

1. 前往 https://discord.com/developers/applications，点击 New Application
2. 进入 Bot 页签 → 点击 Reset Token → 复制 token
3. 同一页面往下滑，在 Privileged Gateway Intents 下启用 Message Content Intent
4. 前往 OAuth2 → URL Generator → 勾选 scope bot → 勾选权限：Send Messages、Send Messages in Threads、Create Public Threads、Read Message History、Add Reactions、Manage Messages
5. 复制生成的 URL，在浏览器中打开以邀请 Bot 到你的服务器

2. 获取 Discord 频道 ID

1. 打开 Discord → 前往 用户设置（齿轮图标）→ 高级 → 启用 开发者模式
2. 右键点击你要 Bot 回应的频道 → 复制频道 ID
3. 多个频道用逗号分隔：123456789012345678,234567890123456789

3. 选择认证方式

Grok Build 支持三种认证来源，选一个适合你的场景：

方法	适用场景	操作
API Key	按使用量付费 API、CI / bot 部署	至 console.x.ai 获取 key，填入 GROK_CODE_XAI_API_KEY 变量
Device-Auth	SuperGrok 订阅	GROK_CODE_XAI_API_KEY 留空。部署后到服务 Exec 终端执行 runuser -u agent -- grok login --device-auth。CLI 会打印短代码 + URL — 在任何设备打开 URL、输入代码、同意授权。Token 写入 /home/agent/.grok/auth.json（重启后保留）。
Deployment Key	xAI 企业客户	部署后在 Zeabur Dashboard → 服务 → Variables 新增自定义变量 GROK_DEPLOYMENT_KEY。优先级高于 auth.json。

💡 跟 loopback OAuth 不同，Grok 的 device-auth 在任何 headless 环境都能用（不需 port-forward、不需 curl callback）。

4. 部署

填入变量后点击部署。服务会自动连接到 Discord。如果选择 Device-Auth，部署后再执行步骤 3 中的 login 指令。

Slack 设置（可选）

OpenAB 支持通过 Socket Mode 连接 Slack，无需公开 URL。

1. 前往 https://api.slack.com/apps → Create New App → From scratch
2. Socket Mode → 启用 → 生成 App-Level Token，scope 选 connections:write → 复制 xapp-... token（SLACK_APP_TOKEN）
3. Event Subscriptions → 启用 → 添加 bot events：app_mention、message.channels、message.groups
4. OAuth & Permissions → Bot Token Scopes → 添加：app_mentions:read、chat:write、channels:history、groups:history、channels:read、groups:read、reactions:write、files:read、users:read
5. Install App → 安装到工作区 → 复制 xoxb-... token（SLACK_BOT_TOKEN）
6. 在每个要使用 Bot 的 Slack 频道执行 /invite @YourAppName

部署前填入 SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN 变量。Discord 和 Slack 可同时运行。

添加通讯平台（Telegram / LINE / 飞书 / Google Chat / MS Teams / 企业微信）

若要桥接 Telegram、LINE、飞书/Lark、Google Chat、MS Teams 或企业微信（WeCom），请在同一个 Zeabur 项目中部署 OpenAB Gateway 模板，然后在此服务上设置以下环境变量：

• GATEWAY_URL = ws://openab-gateway:8080/ws
• GATEWAY_PLATFORM = telegram、line、feishu、googlechat、teams 或 wecom 之一

重启服务。启动脚本会自动将 [gateway] 块注入 config.toml。

使用方式

• 在允许的 Discord 或 Slack 频道中 @mention Bot 即可开始对话
• OpenAB 会自动创建 thread 进行多轮对话 — 后续消息不需要再 @mention
• 每个 thread 对应一个持久的 Grok session（默认 24 小时 TTL）

自定义设置

文件	说明
/home/agent/.config/openab/config.toml	OpenAB 设置（sessions、reactions、STT 等）
/home/agent/.grok/auth.json	Grok OAuth 认证（由 grok login 管理）
/home/agent/.grok/config.toml	Grok runtime 设置

config.toml 在首次启动时从内建模板创建。之后请直接编辑文件，环境变量仅用于初始设置。要恢复默认值请删除后重启：rm /home/agent/.config/openab/config.toml

OpenAB 设置选项请参阅 OpenAB 文档。Grok 设置选项请参阅 Grok Build 文档。

停用

部署时将 Discord Bot Token 和 SLACK_BOT_TOKEN 都留空即可。服务会进入 sleep 状态，不会崩溃。

链接

• OpenAB GitHub
• Grok Build（xAI）
• Agent Client Protocol