KeylessAI FAQ

PowerShell では v$PluginVersion: が不正な変数参照として解釈されます。v0.6.34 以降では v${PluginVersion}: に修正済みです。

客先には keyless-ai-windows-customer-v0.6.35.zip 以降、または Dashboard から再発行した最新の Windows setup.cmd を送ります。v0.6.33 の zip は使わないでください。

PS C:\...> の画面では %USERPROFILE% は展開されません。PowerShellでは & "$env:USERPROFILE\.keyless-ai\keyless-doctor.cmd" を使います。

コマンドプロンプトでは powershell.exe -NoProfile -ExecutionPolicy Bypass -File "%USERPROFILE%\.keyless-ai\keyless-doctor-windows.ps1" が使えます。v0.6.35 以降の setup は keyless-doctor.cmd も保存します。

reg query で KEYLESS_API_KEY が見える、または doctor が local auth file のキーを server accepted と表示する場合、Keyless APIキー自体は保存できています。問題は Cowork / Claude が Keyless MCP bridge を読み込めていない経路です。

Cowork は plugin SessionStart hook を実行しないため KEYLESS_SESSION_ID は通常入りません。正常経路は Keyless MCP bridge が保存済み local API key を直接読み、keyless_call / keyless_diagnose / keyless_status を出す方式です。

v0.6.35 以降の doctor は stable bridge が古い場合に PASS にせず、Stable bridge is outdated と表示します。古い v0.6.30 などを読み続けている場合は最新 setup を再実行してください。

• keyless-ai-windows.plugin
• 顧客用に発行した Keyless APIキーを入れた setup.cmd
• keyless-doctor-windows.ps1
• README / FAQ

• Windows 向けに旧 keyless-ai.plugin を送らない
• スクリーンショット、チャット、メール、ログに出た Keyless APIキーを再利用しない
• provider の生 APIキーを送らない

setup.cmd は Keyless APIキーを Windows user 環境と local auth file に保存し、stable bridge を配置します。実行後は Cowork / Claude を完全終了してから、新しいセッションを開きます。

Dashboard から発行した最新の Windows setup.cmd、または keyless-setup-windows.ps1?v=0.6.35 を使います。setup は download cache を避け、manifest version が 0.6.35 でなければ失敗します。

チャットを閉じるだけでは足りません。アプリ自体を終了し、必要ならタスクマネージャーで残プロセスが無いことを確認してから起動し直します。

まだ見えない場合は setup が保存した keyless-doctor.cmd を実行します。PowerShellなら & "$env:USERPROFILE\.keyless-ai\keyless-doctor.cmd"、直接実行なら powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.keyless-ai\keyless-doctor-windows.ps1" です。