Sessions and memory

頻道停駐

頻道停靠相當於為單一 OpenClaw 工作階段設定通話轉接。它會保留相同的對話上下文，但變更該工作階段後續回覆的傳送位置。停靠功能僅能從私聊使用；無法從群組聊天執行。

範例

Alice 可以在 Telegram 和 Discord 上傳訊息給 OpenClaw：

json5

{  session: {    identityLinks: {      alice: ["telegram:123", "discord:456"],    },  },}

如果 Alice 從 Telegram 私聊傳送以下命令：

text

/dock_discord

OpenClaw 會保留目前的工作階段上下文，並變更回覆路由：

停靠前	執行 `/dock_discord` 後
回覆傳送至 Telegram `123`	回覆傳送至 Discord `456`

工作階段不會重新建立。對話記錄歷程仍會附加至同一個工作階段。

使用時機

當任務從某個聊天應用程式開始，但後續回覆應傳送至其他位置時，請使用停靠功能。

常見流程：

從 Telegram 啟動代理程式任務。
移至用來協調工作的 Discord。
從 Telegram 私聊傳送 /dock_discord。
保留相同的 OpenClaw 工作階段，但在 Discord 接收後續回覆。

必要設定

停靠功能需要 session.identityLinks。來源傳送者與目標對等端必須位於相同的身分群組中：

json5

{  session: {    identityLinks: {      alice: ["telegram:123", "discord:456", "slack:U123"],    },  },}

這些值是帶有頻道前綴的對等端 ID：

值	含義
`telegram:123`	Telegram 傳送者 ID `123`
`discord:456`	Discord 私聊對等端 ID `456`
`slack:U123`	Slack 使用者 ID `U123`

標準鍵（上例中的 alice）僅是共用身分群組的名稱。停靠命令會使用帶有頻道前綴的值，證明來源傳送者與目標對等端是同一個人。

命令

OpenClaw 會為每個支援原生命令且已載入的頻道外掛，產生一個 /dock-<channel> 命令，因此命令清單會隨著新增外掛而增加。目前支援此功能的內建外掛如下：

目標頻道	命令	別名
Discord	`/dock-discord`	`/dock_discord`
Mattermost	`/dock-mattermost`	`/dock_mattermost`
Slack	`/dock-slack`	`/dock_slack`
Telegram	`/dock-telegram`	`/dock_telegram`

在 Telegram 這類直接提供斜線命令的介面上，底線形式也是原生命令名稱。

變更內容

停靠功能會更新作用中工作階段的傳送欄位：

工作階段欄位	執行 `/dock_discord` 後的範例
`lastChannel`	`discord`
`lastTo`	`456`
`lastAccountId`	目標頻道帳號，或 `default`

這些欄位會持久儲存在工作階段儲存區中，並由該工作階段後續的回覆傳送流程使用。

不變內容

停靠功能不會：

建立頻道帳號
連線新的 Discord、Telegram、Slack 或 Mattermost 機器人
授予使用者存取權
略過頻道允許清單或私訊政策
將對話記錄歷程移至另一個工作階段
讓無關的使用者共用工作階段

它只會變更目前工作階段的傳送路由。

疑難排解

命令顯示傳送者尚未連結。

請將目前傳送者與目標對等端加入同一個 session.identityLinks 群組。例如，若 Telegram 傳送者 123 應停靠至 Discord 對等端 456，請同時加入 telegram:123 和 discord:456。

命令顯示停靠功能僅能從私聊使用。

請從與 OpenClaw 的私聊傳送停靠命令，而非從群組聊天傳送。

命令顯示沒有作用中的工作階段。

請從現有的私聊工作階段執行停靠。此命令需要作用中的工作階段項目，才能持久儲存新路由。

回覆仍傳送至舊頻道。

請確認命令已回覆成功訊息，並確認目標對等端 ID 與該頻道使用的 ID 相符。停靠功能只會變更作用中工作階段的路由；其他工作階段仍可能路由至其他位置。

我需要切換回原頻道。

請從已連結的傳送者傳送原頻道對應的命令，例如 /dock_telegram 或 /dock-telegram。

Was this useful?