chord-gateway

为什么需要 chord-gateway

聊天控制面

把微信 iLink、飞书、Telegram、企业微信、钉钉、Discord 或 Slack 连接到 chord headless，即可从 IM 聊天甚至手机上控制 Chord。

本地优先边界

Chord 进程、工作区文件、运行时状态和凭据都继续保留在你自己的机器或服务器上。 聊天消息仍会经过所选 IM 平台；模型服务的数据边界由 Chord 配置决定。

按聊天隔离

gateway 按 workspace、IM 类型和 chat ID 路由，让不同聊天保留独立的 Chord session pin。

交互式确认

确认、问题、todo 更新和 session 命令都会回到聊天工作流里。

三步上手

1. 安装

go install github.com/keakon/chord-gateway@latest

请按 Chord 官方说明单独安装，并确保 chord 在 PATH 中；也可以在网关配置里设置 chord_path。

2. 选择 IM 平台

从 微信 iLink、飞书、Telegram、企业微信、钉钉 、Discord 或 Slack 开始，然后在 config.yaml 中只保留需要的 adapter。

3. 启动 gateway

chord-gateway -f config.yaml --pair

在 Slack 之外的平台，用终端配对码在私聊发送 /bind "<directory>" <pairing_code>，再用 /status 验证绑定。钉钉需先私聊 hello 完成身份验证。第一条任务才启动 Chord；之后普通启动无需 --pair。 Discord 服务器频道和 thread 中的命令需在开头 @Bot。Slack 使用 /chord bind ... 和 /chord status，thread 命令见接入指南。

接下来

快速开始

构建最小可用配置，并验证第一条聊天命令。 前往 →

部署 Cookbook

从 release 安装，选择配置模板，并用 systemd 或 launchd 后台运行。 前往 →

IM 接入总览

选择微信、飞书、Telegram、企业微信、钉钉、Discord 或 Slack，理解路由归属，并避开常见接入陷阱。 前往 →

配置参考

所有配置字段、路由规则、路径和示例集中说明。 前往 →

故障排查

启动、微信、飞书、企业微信、钉钉、Discord、路由和运行时问题检查清单。 前往 →