Sessions and memory

通道對接

通道停靠是針對單一 OpenClaw 工作階段的來電轉接。

它會保留相同的對話脈絡，但變更該工作階段日後回覆的傳送位置。

範例

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

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

如果 Alice 從 Telegram 傳送這個：

/dock_discord

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

停靠前	`/dock_discord` 後
回覆會傳送到 Telegram `123`	回覆會傳送到 Discord `456`

工作階段不會重新建立。轉錄歷史記錄會保持附加在同一個工作階段上。

使用原因

當任務從一個聊天應用程式開始，但後續回覆應該送達其他地方時，請使用停靠。

常見流程：

從 Telegram 啟動代理任務。
移至你正在協調工作的 Discord。
從 Telegram 工作階段傳送 /dock_discord。
保留相同的 OpenClaw 工作階段，但在 Discord 中接收日後回覆。

必要設定

停靠需要 session.identityLinks。來源傳送者和目標對等端必須位於同一個身分群組中：

{
  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）只是共用身分群組名稱。停靠指令會使用帶有通道前綴的值，證明來源傳送者和目標對等端是同一個人。

命令

Dock 命令是從已載入且支援原生命令的通道 Plugin 產生。目前內建的命令：

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

底線別名適用於 Telegram 等原生命令介面。

變更內容

Dock 會更新作用中工作階段的遞送欄位：

工作階段欄位	`/dock_discord` 之後的範例
`lastChannel`	`discord`
`lastTo`	`456`
`lastAccountId`	目標通道帳戶，或 `default`

這些欄位會保存在工作階段儲存區中，並供該工作階段後續回覆遞送使用。

不會變更的內容

Dock 不會：

建立通道帳戶
連接新的 Discord、Telegram、Slack 或 Mattermost bot
授予使用者存取權
繞過通道允許清單或 DM 政策
將對話記錄移至另一個工作階段
讓無關的使用者共用工作階段

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

疑難排解

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

將目前傳送者和目標對等端都加入同一個 session.identityLinks 群組。例如，如果 Telegram 傳送者 123 應 Dock 到 Discord 對等端 456，請同時包含 telegram:123 和 discord:456。

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

請從既有的直接聊天工作階段執行 Dock。此命令需要作用中的工作階段項目，才能保存新的路由。

回覆仍傳送到舊通道。

確認命令已回覆成功訊息，並確認目標對等端 id 符合該通道使用的 id。Dock 只會變更作用中工作階段路由；另一個工作階段可能仍會路由到其他位置。

我需要切換回來。

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

# 範例

# 使用原因

# 必要設定

# 命令

# 變更內容

# 不會變更的內容

# 疑難排解

範例

使用原因

必要設定

命令

變更內容

不會變更的內容

疑難排解