チャネルのドッキング

チャネルドッキングは、1つの 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 が必要です。送信元の送信者と対象ピアは同じ ID グループに含まれている必要があります。

{
  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）は共有 ID グループ名にすぎません。Dock コマンドは、チャネル接頭辞付きの値を使用して、送信元の送信者と対象ピアが同一人物であることを証明します。

コマンド

OpenClaw は、ネイティブコマンドをサポートする読み込み済みの各チャネル Plugin に対して /dock-<channel> コマンドを1つ生成するため、Plugin が追加されるにつれて一覧は増えます。現在これをサポートしている同梱 Plugin:

対象チャネル	コマンド	エイリアス
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 ボットを接続する
ユーザーにアクセス権を付与する
チャネルの許可リストや DM ポリシーをバイパスする
トランスクリプト履歴を別のセッションに移動する
無関係なユーザーにセッションを共有させる

現在のセッションの配信ルートだけを変更します。

トラブルシューティング

コマンドが、送信者がリンクされていないと表示します。 現在の送信者と対象ピアの両方を、同じ session.identityLinks グループに追加します。たとえば、Telegram 送信者 123 を Discord ピア 456 にドッキングする場合は、 telegram:123 と discord:456 の両方を含めます。 コマンドが、ドッキングは直接チャットからのみ利用可能だと表示します。 ドックコマンドはグループチャットではなく、OpenClaw との直接チャットから送信します。 コマンドが、アクティブなセッションが存在しないと表示します。 既存の直接チャットセッションからドッキングします。このコマンドは新しいルートを永続化するために、アクティブなセッションエントリを必要とします。 返信がまだ古いチャネルに届きます。 コマンドが成功メッセージを返したことを確認し、対象ピア ID がそのチャネルで使用される ID と一致していることを確認します。ドッキングはアクティブセッションのルートだけを変更します。別のセッションは引き続き別の場所にルーティングされる場合があります。 元に戻す必要があります。 リンク済みの送信者から、/dock_telegram や /dock-telegram など、元のチャネルに対応するコマンドを送信します。

​例

​使用する理由

​必須設定

​コマンド

​変更される内容

​変更されない内容

​トラブルシューティング