ClawTank

ClawTank

Mac に RDP で接続。オープンソース、ハードウェアアクセラレーション対応、クラウド不要です。

インストール · 接続 · FAQ · トラブルシューティング · ドキュメント · ベータ版のテストに協力

ClawTank は macOS 向けのネイティブ RDP サーバーです。標準的なリモートデスクトップクライアントから Mac に接続し、滑らかなフルデスクトップ環境を利用できます。Windows では Windows App、Mac、iPad、iPhone では Windows App、Android では Microsoft の RDP アプリ、Windows では組み込みの mstsc、Linux では FreeRDP を利用できます。

自宅に Mac mini や Mac Studio はありますか？ MacBook、Windows PC、iPad、Linux から利用できます。ダミーディスプレイプラグもクラウドも不要で、デスクトップは Retina の鮮明さを保ったままウィンドウに合わせて表示されます。

ステータス：0.9 ベータ版。 以下のすべての機能は、自動テスト、実測、各コミットでの FreeRDP 相互運用テストによって検証されています。Microsoft のクライアント（Windows App、mstsc）、ヘッドレスの Mac mini、実際のネットワーク環境での実地テストを進めています。テストに協力するか、問題を報告してください。

機能

• 高速： Mac のメディアエンジンで H.264 動画をエンコードし、RDP のグラフィックスパイプライン経由で送信します。Apple silicon では CPU 使用率 10％未満で約 60 fps です。
• 画面にフィット： デスクトップはクライアントのウィンドウに合わせてリアルタイムにサイズ変更されます。Retina の仮想ディスプレイで文字が鮮明に表示され、ヘッドレスの Mac でもダミーの HDMI プラグは不要です。
• ローカル環境のような使い心地：
  • スクロール、中央ボタン、戻る／進むボタンを含むキーボードとマウス
  • クライアント上に描画されるカーソル形状
  • システムオーディオ、双方向クリップボード（テキスト、リッチテキスト、画像）
  • ファイルやフォルダーのコピーと貼り付け
• デフォルトでセキュア：
  • ネットワークレベル認証を備えた TLS と専用パスワード（macOS のパスワードは使用しません）
  • ローカルネットワークのみ、ログイン失敗後のロックアウト、監査ログ
• Tailscale でどこからでもアクセス： ポートフォワーディング不要で、インターネットに公開されるものもありません（ガイド）。
• エージェント API と MCP サーバー： Mac 上の AI エージェントがスクリーンショットを撮影し、操作できるようにします。エージェントごとのトークン、監査ログ、画面上に表示される停止ボタンを備えています（ガイド）。
• 無料のオープンソース： Apache-2.0 ライセンスのもとで提供され、企業での利用も可能です。アカウント、テレメトリー、クラウドは不要です。

比較

各製品の公開ドキュメントに基づいています。訂正を歓迎します。「—」は未確認を意味します。

インストール

必要条件： Apple シリコン搭載の macOS 14 Sonoma 以降。Intel Mac の場合はソースからビルドしてください（未テスト）。

1. Releases から ClawTank-<version>-arm64.dmg をダウンロードします。必要に応じて SHA256SUMS と照合します：

   shasum -a 256 ~/Downloads/ClawTank-*.dmg
   

2. DMG を開き、ClawTank を Applications にドラッグします。

3. 初回起動（このベータ版はまだ公証されていません）：

   1. ClawTank を開きます。macOS にデベロッパーを検証できないというメッセージが表示されます。
   2. 完了をクリックし、システム設定 → プライバシーとセキュリティを開きます。
   3. 下にスクロールして ClawTank に関するメッセージを表示し、このまま開くをクリックしてから、パスワードまたは Touch ID で確認します。

   この操作は一度だけ行います。ターミナルを使う場合は、xattr -dr com.apple.quarantine /Applications/ClawTank.app を実行してください。公証済みの Developer ID 署名付きビルドは通常どおり開きます。詳しくは docs/releasing.md をご覧ください。

4. ClawTank はメニューバー（ディスプレイアイコン）に表示されます。セットアップウィンドウに沿って、次の設定を行います。

   • 画面収録： クライアントで画面を表示できるようにします。
   • アクセシビリティ： クライアントのキーボードとマウスで Mac を操作できるようにします。
   • ClawTank のパスワード： RDP クライアントで入力するパスワードです。Mac のパスワードではありません。

セットアップウィンドウには、接続に使うアドレス、ユーザー名、証明書のフィンガープリントが表示されます。**メニュー → セットアップガイド…**からいつでも再度開けます。

接続

ClawTank メニューに表示されるアドレス（Copy Address）、セットアップ時に表示される ClawTank のユーザー名、ClawTank のパスワードを使用します。クライアントと Mac は同じネットワーク上にあるか、両方が Tailscale に接続されている必要があります（下記を参照）。

xfreerdp3 /v:<address> /u:<username> /dynamic-resolution /gfx:avc420

自宅やオフィスの外から接続する場合： Mac とお使いのデバイスに Tailscale をインストールし、同じアカウントでサインインします。その後、ClawTank → Settings → Remote Access に表示される名前に接続します。ルーターでポート 3389 を転送しないでください。Wake-on-LAN についても説明している docs/remote-access.md を参照してください。

よくある質問

安全に実行できますか？ 接続は TLS で暗号化され、NLA が必要なため、画面が表示される前にパスワードが確認されます。デフォルトでは、ローカルネットワークと Tailscale のアドレスからのみ接続できます。5 分間にログインに 5 回失敗すると、そのアドレスは 5 分間ブロックされます。すべての試行は メニュー → 接続ログ… に記録されます。パスワードは Keychain に保存されます。アドホックビルドの場合は、アクセス権が 0600 のファイルに保存されます。

画面収録とアクセシビリティが必要なのはなぜですか？ 画面収録を使って、ClawTank は画面をキャプチャして送信します。アクセシビリティを使うと、クライアントのキーボードとマウスを実際の入力として操作できます。アクセシビリティがない場合、画面を見ることはできますが、操作はできません。ClawTank がディスクに録画を保存することはありません。

macOS アカウントではなく、専用のパスワードを使うのはなぜですか？ RDP パスワードが漏れても、Mac、Keychain、sudo のロック解除に使われないようにするためです。設定 → セキュリティ から変更できます。

Mac がロックされているときやログイン画面が表示されているときに接続できますか？ macOS では、アプリがロック画面をキャプチャすることはできません。誰かがキーボードで Mac のロックを解除するまで、クライアントには壁紙だけが表示されます。常時稼働の Mac mini では、自動ログインを有効にすると、再起動後にデスクトップがすぐに使える状態になります（FileVault が有効な場合は利用できません）。ただし、誰が物理的に Mac に近づけるかを考慮してください。Mac がロックされているときは、ClawTank のメニューに表示されます。

Mac しか使っていません。macOS の画面共有を使わないのはなぜですか？ 画面共有は Mac 間で快適に動作し、ハイパフォーマンスモードでは Apple シリコンのハードウェアビデオを使用します。ClawTank は、次のような場合に便利です。

• モニターやダミープラグのないヘッドレス Mac を含め、クライアントのウィンドウに合わせてデスクトップをリサイズできる
• あらゆるデバイスに 1 台のサーバーを使える。同じ Mac mini に、MacBook、Windows PC、iPad、Android、Linux から Microsoft の無料クライアントで接続できる

ClawTank とハイパフォーマンスモードのベンチマークは実施していないため、ClawTank のほうが速いとは主張していません。

複数人が同時に使えますか？macOS ユーザーを分けられますか？ 一度に 1 つの RDP セッションのみ利用でき、ログイン中のユーザーのデスクトップが表示されます。macOS の公開 API では、アカウントごとに別のセッションを利用することはできません。

Mac App Store で配布されていないのはなぜですか？ ClawTank が必要とする API（入力の挿入、仮想ディスプレイ）は、App Store のサンドボックス内で動作するアプリでは使用できません。

アップデート後に macOS から再びアクセス許可を求められます。 署名なし（アドホック）ビルドでは、リリースごとに新しいコード ID が割り当てられるため、macOS はアップデートを新しいアプリとして扱います。プライバシーとセキュリティ → 画面収録／アクセシビリティ で ClawTank を再度有効にしてください（古い項目がある場合は、先に削除してください）。Developer ID 署名済みビルドでは、アクセス許可が維持されます。

外部に通信しますか？ いいえ。ClawTank 自体はネットワーク接続を行いません。受け付けるのは、着信する RDP 接続と、任意で 127.0.0.1 上のローカル Agent API 呼び出しのみです。

トラブルシューティング

既知の制限事項

• 1 セッションにつき 1 台のモニターです。複数モニターのクライアントにも、サイズ変更可能なデスクトップが 1 つ表示されます。AVC444（フルカラー 4:4:4）にはまだ対応していません。代わりに、Retina セッションでは文字が鮮明に表示されます。
• まだ公証を受けていないため、初回のみ「Open Anyway」の手順が必要です。Apple シリコン向けビルドのみです。
• 自動アップデートにはまだ対応していません。GitHub の Releases を確認してください。
• 検証済みの内容については、CHANGELOG.md と docs/testing.md をご覧ください。

ベータ版のテストにご協力ください

実環境で 0.9 を試していただける方を募集しています。Windows と Mac のクライアント、iPad、ヘッドレスの Mac mini、Wi-Fi、Tailscale でのテストをお願いします。ベータテストガイドには、セクションごとに約 5～15 分で実施できる手順を記載しています。ベータテストレポートフォームを使って、成功した場合も含め、各テストの結果を報告してください。

ドキュメント

• Tailscale を使ったリモートアクセス
• エージェント API と MCP サーバー
• アーキテクチャと設計上の判断
• テスト記録とリリース
• すべてのドキュメント：docs/README.md

ソースからのビルド

必要条件：macOS 14 以降、Xcode 16 以降、Rust（stable、rustup 経由）、brew install xcodegen swiftlint。

make build        # Rust core + ClawTank.app (app/build/Build/Products/Release/)
make dev-signing  # one-time: a local signing identity so permissions survive rebuilds
make test         # cargo test + XCTest
make lint         # clippy -D warnings, rustfmt, swiftlint
make release      # versioned DMG + SHA256SUMS + release notes in dist/

Xcode で作業するには、make core project を実行してから、app/ClawTank.xcodeproj を開いてください。アーキテクチャ：docs/architecture.md。設計上の判断：docs/decisions.md。

コントリビューション

コントリビューションを歓迎します。クリーンルームルールを含むセットアップと規約については、CONTRIBUTING.mdをご覧ください。行動規範に従ってください。サポートについては、SUPPORT.mdをご覧ください。脆弱性を非公開で報告するには、SECURITY.mdをご覧ください。

ライセンス

Apache-2.0。LICENSE と THIRD_PARTY_NOTICES.mdをご覧ください。ClawTank は IronRDP を基盤として構築されています。