Keural Duo

Duoは、デスクトップアプリがこのコンピューター（または接続したDGX Spark）にインストールする常駐型エージェントです。隔離されたサンドボックスで動作し、サイドバーのDuoやTelegramで会話し、登録したルーチンを実行します。NVIDIA NemoClaw・OpenClawをベースにしています。

インストールアンカーリンクをコピー

設定 → Duo → 実行環境でモデルを選び、実行する場所の行のインストールを押します。モデルを選んでいない場合や、ディスクの空きが足りない場合は、インストールボタンが無効になります。

実行場所と要件アンカーリンクをコピー

ディスクは20GB以上必要で、40GB以上を推奨します。不足している場合は、インストールボタンがロックされ、「{need} GB 必要 · {free} GB 空きあり」と表示されます。

モデルアンカーリンクをコピー

インストール後も、モデルの行でモデルを変更できます。同じ種類の中では「切り替える」ですぐに切り替わります。ローカル・クラウド・ゲートウェイの間で種類が変わる場合は、種類が変わると再インストールされます。再インストールしてもルーチンは維持されます。実行場所を移すには、先に削除してから、別の場所にインストールします。

インストールの手順アンカーリンクをコピー

このデバイスの確認 → コンテナーランタイムの準備 → NemoClawのインストール → モデルの起動（クラウド・ゲートウェイの場合はモデルの利用権限の準備） → サンドボックスの作成 → Duoの設定 → 動作の確認の順に進みます。現在の段階はボタンと進行カードに表示されます。「少し時間がかかっています。アプリを開いたままにしてください。」と表示されても、アプリを閉じないでください。

インストールが止まったら、インストールできないときで画面の表示から原因を確認します。

ほかのアカウント・ワークスペースのDuoアンカーリンクをコピー

Duoはデバイスごとに1つで、インストールしたアカウントとワークスペースに属します。別のアカウントでサインインしたり、別のワークスペースに切り替えたりすると、設定のDuoは「インストールされていません」と表示され、サイドバーのDuoとMate & Morphは非表示になります。この状態でインストールを押すと、「ほかのアカウントまたはワークスペースのDuoがあります。新しくインストールすると、そのDuoと会話・ルーチンが削除されます」という確認ウィンドウが表示されます。新しくインストールを押すと、既存のDuoを削除して新しく作成します。元のアカウント・ワークスペースに戻ると、既存のDuoが再び表示されます。

以前にインストールしたDuoが残っている場合は、整理してからインストールします。整理に失敗すると、「既存のDuoを削除できませんでした。もう一度インストールしてください。」と表示されます。

インストールできないときアンカーリンクをコピー

インストールが止まると、設定 → Duoにエラーメッセージが表示されます。メッセージ末尾の括弧内のコードも確認します。原因を解決したら、インストールをもう一度押します。

解決しない場合は、設定 → サポート で問い合わせます。画面の表示、括弧内のコード、端末の種類（macOS・Windows・Spark）を伝えてください。

設定 → Duoの画面アンカーリンクをコピー

インストール・モデルの切り替え・チャットアプリの適用・削除などの長い作業の間は、ほかの領域がロックされます。コンピューターの使用をオンにするとき、またはルールを広げるときは、OSの確認ウィンドウが表示されます。

会話アンカーリンクをコピー

サイドバーのDuoを押します（コードモードでは表示されません）。接続が切れている間に送ったメッセージは「{n}件 送信待ち」と表示され、接続が戻ると届けられます。/newを送ると、新しい会話を始めるかどうかの確認が表示されます。

上部のDuo情報をオンにすると、横のパネルに次のカードが表示されます。

バックグラウンドタスクボタンを押すと、Duoが実行しているサブエージェントの一覧を表示します。

会話のメモリアンカーリンクをコピー

設定 → Duo → 会話のメモリで、「使用中のコンテキスト」をトークン数と割合で確認します。圧縮で会話を短くするか、新規で新しい会話を開きます。現在の会話は保管されます。Duoが作業中の場合は、作業が終わった後に行えます。「会話が長くなりすぎて、モデルが処理できないため、Duoが答えられませんでした。」と表示されたら、圧縮するか新しく始めてください。

ルーチンアンカーリンクをコピー

Duoに「毎朝9時に…してね」のように話すと、このルーチンを作りますか？カード（作業・予定・実行場所）が表示されます。ルーチンを作るを押すと登録されます。変更や削除のときも、同じカードで確認します。

Duo情報パネルのルーチンカードで、オン・オフを切り替えます。もっと見るから、今すぐ実行・削除を行えます。行ごとに、次の実行時刻と状態（送信済み・未実行・失敗・一時停止中・期限切れ）が表示されます。ルーチンの結果は、Duoの会話またはTelegramに届き、デスクトップ通知も表示されます（今すぐ実行は通知なし）。ルーチンは、アプリが開いているときに実行されます。

チャットアプリ（Telegram）アンカーリンクをコピー

設定 → Duo → チャットアプリ → Telegram → 接続するで、案内に従います。

1. Telegramで@BotFatherを開き、/newbotを送ってから、ボットの名前とユーザー名を決めます。
2. BotFatherが発行したボットトークンを貼り付けて、確認を押します。トークンが漏えいすると誰でもボットを操作できてしまうため、公開しないでください。
3. QRコードをスマートフォンで読み取ってボットを開き、開始を押します。メッセージが届かない場合は、画面のコードをボットに送ってください。
4. 「{名前}さんだけが個人のメッセージで会話できます」と表示されたら、追加を押し、続けて適用を押します。

適用すると、Duoが再起動されます（会話とファイルはそのまま残ります）。その後、スマートフォンから送った内容は、Duoの会話に「Telegramから送信」として表示されます。接続した1人だけが、個人のメッセージで会話できます。接続を切るには、接続を解除を押してから適用を押します。Telegramを接続すると、ルーチンの承認もTelegramで受け取ります。

ボットトークンは、1つのアカウントの1台のDuo（端末）でのみ使えます。別の機器に接続するには、既存の機器で接続を解除してから、トークンを再登録します。

アプリでの作業の承認は、Telegramから始めた会話であっても、Keuralアプリのウィンドウだけで行います。

接続アンカーリンクをコピー

設定 → Duo → 接続で設定します。

コンピューターの使用アンカーリンクをコピー

設定 → Duo → コンピューターの使用 → Duoがこのコンピューターを使うことを許可するをオンにすると、Duoがこのコンピューターのアプリを開いて使ったり、指定したフォルダーを読んだり、ルーチンを作ったりできます。オンにすると、Duoが1分ほど再起動します。

確認せずに実行でも、常に許可でも、送信・削除・上書き・支払い・提出・サインイン・公開・キャンセルなどの重要な操作と、Enter・Backspace・⌘Qなどのキーは、必ず先に確認します。

Duoが許可を待っている場合は、入力欄の上に「Duoが承認を待っています」と表示されます。確認を押すと承認ウィンドウが開き、拒否・今回のみ許可・常に許可から選びます。Mate & Morphにも「承認を待っています」と表示されます。承認はこのウィンドウでのみ行えます。

Duoは検索結果のリンクだけを承認なしで開きます。Duoが直接入力または変更したアドレスは、承認ウィンドウにアドレス全体を表示して確認します。

Mate & Morphアンカーリンクをコピー

Duoのデスクトップのキャラクターです。設定 → Duo → コンピューターの使用 → Mate & Morph → デスクトップに表示をオンにして、キャラクター（Mate・Morph・両方）とサイズ（小・標準・大）を選びます。

• Duoが実行中で、会話の準備ができているときだけ表示されます。別のアカウント・ワークスペースに切り替えたり、プランによってDuoが使えなくなったりすると、非表示になります。
• キャラクターを1回押すと入力欄が開き、すぐに話しかけられます。すばやく2回押すと、アプリが開きます。キャラクターの横には、状態（待機中・作業中・完了・詰まり・入力が必要・承認を待っています）と、最後の回答が失敗した理由が表示されます。
• 右クリックのメニュー：非表示・既読にする・Duoを開く・Duoの設定。メニューバー（トレイ）のメニューにも、Mate & Morphを表示／非表示があります。

Windowsアンカーリンクをコピー

WindowsのDuoは、WSLのディストリビューション内で動作し、会話・ルーチン・Telegram・承認・Mate & Morph・コンピューターの使用をmacOSと同様にサポートします。一部のアプリや、パスワード入力欄・UAC・ターミナルなどの保護されたウィンドウは、Duoが操作せず、ユーザーに引き渡します。

設定 → Duo → 新機能（Windowsコンピューター）で、Duoの接続、共有フォルダー（Duoは選択したフォルダーだけを読み取ります）、アプリへのアクセス、最近の作業を確認します。Windowsでは、ソフトウェアのインストール（正確なパッケージIDのみ）とWi‑Fi接続（保存されたプロファイル）もでき、送信・削除・上書き・インストール・ネットワークの変更は、必ず先に確認します。

削除アンカーリンクをコピー

設定 → Duo → 実行環境で、インストールされた場所の行の削除を押し、確認ウィンドウで削除を押します。サンドボックス、会話の履歴、ルーチン、作業ファイルが削除されます。macOSでは、Duo専用のコンテナーVMも削除されます。DGX SparkのDuoは、Sparkが接続されている間だけ削除できます。

よく見る表示アンカーリンクをコピー

IT担当者向けの詳細アンカーリンクをコピー

要件アンカーリンクをコピー

Windowsでは、インストールの際に%USERPROFILE%\.wslconfigの[wsl2]にnetworkingMode=natを使います。ミラーリングネットワーキング（mirrored）を使っているPCにはインストールされません。

インストールされる場所アンカーリンクをコピー

ダウンロード先アンカーリンクをコピー

ファイアウォールやプロキシで、次のアドレスを許可します。ダウンロードするファイルは固定のバージョンで、SHA-256で検証します。

ウェブ検索やGitHubの接続を使う場合は、api.tavily.com、api.search.brave.com、api.github.com、api.githubcopilot.comも許可します。

ネットワークとポートアンカーリンクをコピー

Sparkでufwファイアウォールがオンになっている場合は、インストールの途中でゲートウェイと中継のポートを2つ開きます。このとき、Sparkのアカウントのパスワードを1回入力します。

サンドボックスは、インターネットに直接接続しません。ウェブ検索とページの読み取りはアプリが代行し、GitHubは読み取り専用で接続します。

モデルのアドレスアンカーリンクをコピー

ゲートウェイのアドレスは、httpsであればどこでもかまいません。httpの場合は、プライベートIPや社内の名前（.local・.lan・.internal・.intranet・.home.arpa、ドットのない名前）だけを受け付けます。localhostやuser:pass@を含むアドレスは受け付けません。

Telegramアンカーリンクをコピー

• ボットトークンは、BotFatherの/newbotで取得します。形式は数字:英数字です。
• 接続コードが作成されたら、10分以内にスマートフォンでボットを開き、5分以内に最初のメッセージを送ります。最初のメッセージを送ったアカウントが許可されます。
• グループの会話には返答しません。

ルーチンの制限アンカーリンクをコピー

フォルダー追加のルールアンカーリンクをコピー

次のフォルダーは追加できません。

コンピューターの使用の権限アンカーリンクをコピー

送信・削除・支払い・購入・提出・サインイン・送金・公開・キャンセルなどのボタンや、Enter・Delete・ウィンドウを閉じる・アプリを終了するなどのキーは、重要な操作として扱い、そのたびに確認します。

削除時に消えるものアンカーリンクをコピー

削除を押すと、サンドボックス、Duoの会話履歴、ルーチン、Telegram・GitHub・検索の接続、クラウドモデルのトークンが削除されます。この端末に別のDuoがない場合、macOSでは~/.keural-runtime/と自動起動の項目も削除されます。Mate & Morphの設定とSparkの接続履歴はデバイスの設定のため、残ります。