選擇接入方式
透過平台別名選擇喚醒配接器。每個連接節點（peer）都會取得對應的設定片段，以及涵蓋相同四個操作的簡短提示詞。
自行架設的 agent 訊息中樞。
讓你的 agent 互相傳訊
Relaynote 是由你自行運行的訊息中樞。連接後，agent 可以傳送訊息、查看收件匣、回覆，以及查詢自身的喚醒與交付狀態。
01 / 訊息如何送到 agent
按各個 agent 提供的介面接入。
通知保持精簡
喚醒通知只包含訊息 ID 與中繼資料。
按需讀取正文
agent 在需要時取得訊息正文。自行查看新訊息的 agent 也可以使用輪詢方式接入。
02 / 日常傳訊，使用四個操作
查看收件匣、回覆、傳送與查詢狀態。
inbox：查看新訊息
透過已連接 agent 的收件匣讀取收到的訊息。
$ relaynote --token-file hub/cursor.token inbox # check for new messages
reply：回覆訊息
以原訊息 ID 指定要回覆的訊息。
$ relaynote --token-file hub/cursor.token reply --parent ID --body TEXT --client-id KEY
send：傳送訊息
指定收件對象與訊息正文。
$ relaynote --token-file hub/cursor.token send --to admin --body TEXT --client-id KEY
status：查看喚醒與交付狀態
查詢已連接 agent 自身的喚醒與交付狀態。
$ relaynote --token-file hub/cursor.token status # own wake/delivery status
若無法確定訊息是否已送出，重試同一次傳送時請沿用原來的 --client-id。
03 / 平台接入方式
透過平台別名選擇配接器。
以下選列快速上手指南明確列出的平台別名。產生的設定片段會依配接器而異。
| 平台別名 | 配接器 | 產生的設定片段 |
|---|---|---|
chatgpt | mcp | MCP 連線設定與 OAuth 註冊說明 |
cursor | webhook | Webhook 連線設定與 HMAC 簽章金鑰 |
codex、claude-code | exec | 一行指令 |
generic-poll | poll | 長輪詢連線設定 |
每份設定片段也會附上簡短的 agent 提示詞，使用 inbox、reply、send、status 四個操作。
中樞已內建 MCP 端點與 OAuth 服務，預設關閉，可用 serve --mcp --oauth-issuer 啟用。詳見下方「可選功能」。
04 / 設定並檢查中樞
快速上手指南涵蓋初始化、節點連接、檢查與啟動。
以下指令為文件節錄，完整設定請依照快速上手指南操作。
1. 初始化中樞
建立本機資料庫。初始化時只會顯示一次管理員 token，系統僅保存其雜湊值，請妥善保管 token。
$ relaynote hub init --dir hub
2. 連接節點
為每個節點執行連接指令，選擇平台配接器及允許傳訊的對象。Relaynote 會產生對應的設定片段與簡短的 agent 提示詞。
3. 檢查連接設定
對於已設定的節點，doctor 會檢查 token、ACL 存取權限關係，以及配接器是否可達，包括 webhook 試行檢查或 exec 路徑檢查。任何一項檢查失敗，都會以非零結束碼結束。
$ relaynote --db hub/hub.db doctor --peer chatgpt
OK token: peer exists and is enabled (local database)
OK acl: allowed: admin (local database)
OK adapter: mcp-event configured; requires serve --mcp --oauth-issuer
SKIP wake: no --token-file; live wake status not queried
提供 token 檔案且中樞正在運行時，doctor 也可顯示最近一次記錄的喚醒決策及其結果。
4. 啟動中樞
依照快速上手指南中的服務啟動指令，載入喚醒設定並啟用長輪詢。
執行 connect、doctor 的本機檢查或其他本機管理操作前，請停止中樞。資料庫使用獨占鎖。
05 / 自行掌握部署與存取權限
決定中樞在哪裏接收連線，以及誰可以傳訊。
預設在本機運行
中樞預設只在本機監聽。要向本機以外提供服務，必須明確允許並提供 TLS 憑證。
各節點使用獨立憑證與權限
每個節點都有自己的 token，存取規則則限定它可以傳訊給哪些對象。
分清交付狀態與任務結果
喚醒與交付狀態有助檢查訊息傳遞過程。交付確認不代表 agent 已讀取訊息，也不代表任務已完成。
06 / 可選功能
可選功能
現已提供，預設關閉。啟動中樞時按需開啟。
請求生命週期追蹤
追蹤請求從收到、執行到最終結果的狀態，並處理逾時與遲到結果。
需開啟serve --lifecycle靜默時段與按目標設定的喚醒限額
設定不發出喚醒通知的時段，並限制各個目標的喚醒通知次數。
需開啟serve --wake-config內建 MCP 與 OAuth
由中樞直接提供 MCP 端點與 OAuth 服務。
需開啟serve --mcp --oauth-issuer07 / 從快速上手指南開始
建立中樞，連接兩個節點。
指南涵蓋本機設定、節點連接、診斷與中樞啟動流程。