频道停靠

频道停靠是针对单个 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）只是共享身份组的名称。停靠命令使用带渠道前缀的值来证明源发送者和目标对等方是同一个人。

命令

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 Bot
向用户授予访问权限
绕过渠道允许列表或私信策略
将对话记录历史移至另一个会话
使无关用户共享一个会话

它只会更改当前会话的投递路由。

故障排查

命令提示发送者未关联。 将当前发送者和目标对等方添加到同一个 session.identityLinks 组。例如，如果 Telegram 发送者 123 应停靠到 Discord 对等方 456，请同时包含 telegram:123 和 discord:456。 命令提示停靠仅适用于私信。 请从与 OpenClaw 的私信中发送停靠命令，而不是从群聊中发送。 命令提示不存在活动会话。 请从现有私信会话进行停靠。该命令需要活动会话条目，以便持久化新路由。 回复仍然发送到原渠道。 检查命令是否返回成功消息，并确认目标对等方 ID 与该渠道使用的 ID 匹配。停靠只会更改活动会话的路由；另一个会话仍可能路由到其他位置。 我需要切换回去。 从已关联的发送者发送原渠道对应的命令，例如 /dock_telegram 或 /dock-telegram。

基础

会话与记忆

多代理

消息与投递

示例

使用原因

必需配置

命令

发生的变化

不会发生的变化

故障排查

​示例

​使用原因

​必需配置

​命令

​发生的变化

​不会发生的变化

​故障排查

示例

使用原因

必需配置

命令

发生的变化

不会发生的变化

故障排查