OpenClawの「Device Token Mismatch」を修正する方法 [2026ガイド]

以下のエラーが出ていますか？

device token mismatch

connect failed: device token mismatch

disconnected (4008): connect failed

disconnected (4008): connect failed — device token mismatch

openclaw gateway device token mismatch

Error: device token mismatch — please re-pair this device

WebSocket connection failed: device token mismatch

connect failed (4008): device identity rejected

すべて同じ意味です：デバイスに保存されているトークンが、OpenClawゲートウェイが期待するものと一致しなくなっています。このガイドですべての修正方法を説明します。

TL;DR -- クイックフィックス

OpenClaw環境内で以下を実行します：

openclaw doctor --fix && openclaw restart

この1つのコマンドでトークンの不一致を検出し、一致するトークンを再生成し、ゲートウェイを再起動します。それでも解決しない場合は、以下の詳細な手順をお読みください。

OpenClaw Device Token Mismatchのステップバイステップ修正

ステップ1：ビルトイン診断を実行

openclaw doctor --fix

**openclaw doctor --fix**はdevice token mismatchを含む設定の問題をスキャンします。自動的にトークンを再生成し、ゲートウェイ設定を更新します。

ステップ2：ゲートウェイを再起動

openclaw restart

修正は再起動後にのみ有効になります。再接続を試みる前に、ログに[gateway] listening onが表示されるまで待ってください。

ステップ3：修正を確認

openclaw status

gateway: runningがエラーなしで表示されるはずです。デバイスが切断されたままの場合は、ステップ4に進んでください。

ステップ4：切断されたデバイスを再承認

登録されているすべてのデバイスを一覧表示します：

openclaw devices list

デバイスがpendingまたはrejectedと表示されている場合、承認します：

openclaw devices approve DEVICE_ID

デバイスが壊れた状態でスタックしている場合、削除して再ペアリングします：

openclaw devices remove DEVICE_ID

その後、ブラウザまたはTelegramボットを開いて再接続します。新しいペアリングリクエストが表示されます。openclaw devices approveと新しいデバイスIDで承認します。

ステップ5：すべてのデバイスが接続されていることを確認

openclaw devices list

すべてのデバイスがconnectedステータスを表示するはずです。

なぜこれが起きるのか

device token mismatchエラーには4つの一般的な原因があります。

1. ゲートウェイ再起動でトークンが再生成された

OpenClawはピン留めしない限り、再起動のたびにゲートウェイトークンを再生成します。これにより、既存のすべてのデバイス接続が即座に無効になります。

これが最も一般的な原因です。サーバーの再起動、プロセスマネージャーの再起動、またはピン留めされたトークンなしでopenclaw restartを実行するたびに、すべてのペアリング済みデバイスでミスマッチが発生します。

2. コンテナが再構築された（Dockerユーザー）

Dockerコンテナの再構築は新しいゲートウェイIDを作成します。以前にペアリングされたすべてのデバイス -- ブラウザ、Telegramボット、モバイルアプリ -- は、新しいコンテナにそれらの記録がないため無効になります。

docker run、docker-compose up --build、またはデプロイ時にコンテナを再作成するCI/CDパイプラインを使用する方に影響します。

3. 複数のOpenClawインスタンスが実行中

同じマシンで2つのOpenClawインスタンスを実行すると、トークンの衝突が発生します。各インスタンスが同じデフォルトデータディレクトリから読み取るため、互いのトークンを上書きします。

断続的なミスマッチエラーが自然に修正されたように見えて、また発生します。エラーが不安定な場合、これが原因である可能性が高いです。

4. ブラウザキャッシュの古さ

ブラウザがlocalStorageに古いデバイストークンを保持していることがあります。サーバー側の設定を修正しても、ブラウザが古いトークンを送信します。

修正： ブラウザ設定でOpenClaw URLのサイトデータをクリアしてから、再接続して新しいデバイスを承認します。

Docker固有のDevice Token Mismatch修正

OpenClawをDockerで実行している場合、修正にはコンテナに入る必要があります：

# 実行中のコンテナに入る
docker exec -it YOUR_CONTAINER_NAME bash

# 診断ツールを実行
openclaw doctor --fix

# コンテナから出る
exit

# 変更を適用するためにコンテナを再起動
docker restart YOUR_CONTAINER_NAME

Docker内でデバイストークンを手動リセットするには：

docker exec -it YOUR_CONTAINER_NAME bash

# 安定したゲートウェイトークンを設定
openclaw config set gateway.token "your-stable-token-here"

# すべての古いデバイスペアリングを削除
openclaw devices list
openclaw devices remove DEVICE_ID

exit
docker restart YOUR_CONTAINER_NAME

コンテナの再起動後、ブラウザまたはTelegramから再接続し、新しいデバイスを承認します。

Docker Composeユーザー

Docker Composeを使用している場合、docker-compose.ymlに環境変数を追加します：

services:
  openclaw:
    image: openclaw-stack
    environment:
      - OPENCLAW_GATEWAY_TOKEN=your-stable-token-here
    volumes:
      - openclaw-data:/app/data

volumes:
  openclaw-data:

データを失わずに再構築します：

docker compose down && docker compose up -d

防止チェックリスト

device token mismatchの再発を防ぐには：

• ゲートウェイトークンをピン留めする。 環境変数としてOPENCLAW_GATEWAY_TOKENを設定するか、openclaw config set gateway.token "your-stable-token"を実行します。これにより再起動時のトークン再生成を防ぎます。
• データディレクトリを永続化する。 Dockerボリュームを/app/dataにマウントして、コンテナの再構築でデバイスペアリングが消去されないようにします。
• マシンごとに1インスタンス。 複数インスタンスを実行する必要がある場合は、それぞれに別のデータディレクトリとポートを設定します。
• アップグレード後にopenclaw doctorを実行する。 メジャーバージョンのアップグレードでトークン形式が変更される可能性があります。openclaw doctor --fixで問題がユーザーに到達する前にキャッチします。
• 大きな変更後にブラウザキャッシュをクリアする。 ゲートウェイURL、ドメイン、トークンを変更した場合、OpenClawに接続するすべてのブラウザのサイトデータをクリアします。

それでも解決しない場合

openclaw doctor --fixと手動トークンリセットでエラーが解決しない場合：

1. OpenClawバージョンを確認する。 openclaw --versionを実行し、最新リリースであることを確認します。古いバージョンにはパッチ済みのトークンローテーションバグがありました。
2. ポートの競合を確認する。 openclaw statusを実行し、ゲートウェイポートが他のプロセスで使用されていないことを確認します。
3. ゲートウェイログを検査する。 openclaw logs gatewayを実行し、tokenまたはdeviceを含む行を探します。ログ出力にゲートウェイが期待するトークンとクライアントが送信したトークンが正確に表示されます。
4. 最終手段 -- 完全リセット。 他に何も機能しない場合、すべてのデバイスペアリングを削除してやり直します：

openclaw devices list
# すべてのデバイスを削除
openclaw devices remove DEVICE_ID_1
openclaw devices remove DEVICE_ID_2

# 新しい安定トークンを設定
openclaw config set gateway.token "new-token-here"

# 再起動
openclaw restart

その後、再接続して各デバイスを再承認します。

5. コミュニティに相談する。 openclaw doctorの出力とゲートウェイログをOpenClaw GitHub DiscussionsまたはDiscordサーバーに投稿してください。

トークン管理を完全にスキップする

ClawTankはゲートウェイトークン、デバイスペアリング、コンテナの永続化、自動TLSをすべて標準で管理します。手動のトークンピン留め、Dockerボリューム設定、再起動ごとのopenclaw doctorは不要です。一度デプロイして、どのデバイスからでも接続できます。