> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# チャネルのドッキング

チャネルドッキングは、1つの OpenClaw セッションに対する通話転送です。同じ
会話コンテキストを維持しつつ、そのセッションの今後の返信が配信される場所を
変更します。ドッキングは直接チャットからのみ機能します。グループチャットからは
実行されません。

## 例

Alice は Telegram と Discord で OpenClaw にメッセージを送信できます。

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456"],
    },
  },
}
```

Alice が Telegram の直接チャットからこれを送信した場合:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/dock_discord
```

OpenClaw は現在のセッションコンテキストを維持し、返信ルートを変更します。

| ドッキング前                 | `/dock_discord` 後     |
| ---------------------- | --------------------- |
| 返信は Telegram `123` に届く | 返信は Discord `456` に届く |

セッションは再作成されません。トランスクリプト履歴は同じセッションに
紐付いたままです。

## 使用する理由

タスクがあるチャットアプリで開始されたものの、次以降の返信を別の場所で
受け取りたい場合にドッキングを使用します。

一般的なフロー:

1. Telegram からエージェントタスクを開始します。
2. 作業を調整している Discord に移動します。
3. Telegram の直接チャットから `/dock_discord` を送信します。
4. 同じ OpenClaw セッションを維持しつつ、今後の返信を Discord で受け取ります。

## 必須設定

ドッキングには `session.identityLinks` が必要です。送信元の送信者と対象ピアは
同じ ID グループに含まれている必要があります。

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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` など、元のチャネルに
対応するコマンドを送信します。