跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

通道停靠是針對單一 OpenClaw 工作階段的來電轉接。 它會保留相同的對話脈絡，但變更該工作階段日後回覆的傳送位置。

​
範例

Alice 可以在 Telegram 和 Discord 上傳訊息給 OpenClaw： 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456"],
    },
  },
}
如果 Alice 從 Telegram 傳送這個： 
/dock_discord
OpenClaw 會保留目前的工作階段脈絡，並變更回覆路由：
停靠前/dock_discord 後
回覆會傳送到 Telegram 123回覆會傳送到 Discord 456
工作階段不會重新建立。轉錄歷史記錄會保持附加在同一個工作階段上。

​
使用原因

當任務從一個聊天應用程式開始，但後續回覆應該送達其他地方時，請使用停靠。 常見流程：
  1. 從 Telegram 啟動代理任務。
  2. 移至你正在協調工作的 Discord。
  3. 從 Telegram 工作階段傳送 /dock_discord。
  4. 保留相同的 OpenClaw 工作階段，但在 Discord 中接收日後回覆。

​
必要設定

停靠需要 session.identityLinks。來源傳送者和目標對等端必須位於同一個身分群組中： 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456", "slack:U123"],
    },
  },
}
這些值是帶有通道前綴的對等端 ID：
值含義
telegram:123Telegram 傳送者 ID 123
discord:456Discord 直接對等端 ID 456
slack:U123Slack 使用者 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 之後的範例
lastChanneldiscord
lastTo456
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。