thClaws: GUI・CLI・Webを1バイナリに収めたRust製AIエージェント基盤

1つのバイナリ、4つのフロントエンド

READMEはthClawsを、ネイティブRustで書かれたオープンソースのAIエージェントハーネスであり、単一のバイナリとしてパッケージ化され、4つのインターフェースを提供すると説明している。デスクトップGUIはthclawsコマンドで起動し、Terminal、Chat、Files、およびオプションのTeamタブを備える。CLI REPLはthclaws --cliで実行され、SSHセッション、ヘッドレスサーバー、GUIなしのワークフローを対象とする。非対話モードのthclaws -p "prompt"は1ターン実行して終了し、READMEはスクリプトやCIに適したパイプフレンドリーなモードと述べている。-vフラグはトークン使用量をstderrに出力する。Webアプリのthclaws --serve --port 7878は、WebSocketとHTTP経由で同じエンジンを実行する。READMEは、すべてのインターフェースが同じAgentループ、Session、ToolRegistryを共有し、GUIビルドはコンパイル時にinclude_str!を使ってフロントエンドをバイナリに埋め込むと述べている。

v0.61.0で追加されたもの

READMEはv0.61.0の2つの追加機能を強調している。Media Studioは、Google Gemini、OpenAI gpt-image-2、Alibaba Qwen、Veo、DashScope HappyHorseを対象とした、テキストから画像、画像編集、テキストから動画、画像から動画のためのポイントアンドクリックシェルである。同じツール（TextToImage、ImageToImage、TextToVideo、ImageToVideo、MediaJobStatus）はチャットからも呼び出せ、非同期動画も含む。OpenRouter Fusionは、最大8つのモデルのパネルに質問を並列で送り（各モデルはウェブ検索が可能）、その後ジャッジが回答を評価してコンセンサスを総合し、単一のモデルIDとしてパッケージ化する。openrouter/fusion+バリアントは、パネル、ジャッジ、モデルごとのツール呼び出し予算、温度、推論努力、ツール選択をモデルピッカーから設定でき、READMEはプラットフォームで目的のモデルが利用できない場合の実用的な代替手段と呼んでいる。

プロバイダー対応とオープン標準

READMEのプロバイダーリストは、Anthropic（ネイティブおよびClaude Code認証によるClaude Agent SDK）、OpenAI（Chat Completionsに加えてResponsesとCodex）、Google GeminiとGemma、Alibaba DashScope（Qwen）、DeepSeek、Z.ai（GLM Coding Plan）、NVIDIA NIM、NSTDAタイ語LLM（OpenThaiGPT、Typhoon、Pathumma、THaLLE）、OpenRouter、Agentic Press、Azure AI Foundry、Ollama、LMStudio、およびLiteLLM、Portkey、Helicone、vLLM、内部プロキシのための汎用OpenAI互換スロットをカバーしている。セッション中の切り替えは/modelまたは/providerコマンドで行う。プロジェクトはオープン標準も採用している。ツールにはModel Context Protocol、プロジェクト指示にはAGENTS.md、パッケージ化されたワークフローにはYAMLフロントマター付きのSKILL.mdである。READMEはこれをthClawsと他の互換エージェント間で移植可能な設定と位置づけている。

Rustの変更を必要としない拡張

READMEに記載された拡張ポイントはRustコードの変更を必要としない。スキルはSKILL.mdを含むフォルダである。プラグインはスキル、コマンド、エージェント定義、MCPサーバーを1つのマニフェストにまとめる。MCPは、OAuth 2.1とPKCEを備えたstdioまたはHTTP-Streamableトランスポートを介して、GitHub、ファイルシステム、ブラウザ、Slackなどのサードパーティツールを導入する。フックはpre_tool_use、permission_denied、session_startなどのライフサイクルイベントでシェルスクリプトを実行する。設定の優先順位は、CLIフラグ、プロジェクトの.thclaws/settings.json、ユーザーの~/.config/thclaws/settings.json、~/.claude/settings.jsonのフォールバック、そしてコンパイル済みのデフォルト値の順に記載されている。READMEは、APIキーが設定ファイルに保存されることは決してなく、デフォルトではOSのキーチェーンにのみ保存され、CIでは.envに保存されると述べている。

3層のオーケストレーション

READMEはエージェントオーケストレーションの3つの層を記録している。モデル駆動のサブエージェントはTaskツールで実行され、メインフローをブロックし、最大3階層まで深く進む。ユーザー駆動の並行サイドチャネルは/agentコマンドで起動され、メインセッションと並行して実行され、独自のキャンセルトークンを持つ。エージェントチームはマルチプロセスで、共有メールボックス、タスクキュー、tmuxペイン、オプションのgit worktreesを備える。スケジューリングは/schedule addで処理され、cron、固定間隔、またはwatchWorkspaceによるファイルシステム変更でエージェントを実行する。一時的なジョブにはプロセス内スケジューラが対応し、launchdまたはsystemd-userを使用するネイティブデーモンは再起動後も存続する。/loopは固定間隔で反復し、/goalは監査ベースの完了を駆動し、/goal --autoは目標が満たされるまで動き続ける一晩中のビルダーと説明されている。

メモリ、知識ベース、安全性

知識ベースは.thclaws/kms/<name>/pages/の下にあり、1行のindex.mdで索引付けされ、grepと読み取りで検索される。READMEは埋め込みを使用せず、Andrej KarpathyのLLM-wikiパターンを引用している。/dreamコマンドは最近のセッションをバックグラウンドで掘り起こし、git diffでレビューできる日付入りの監査記録ページを書き込む。永続メモリストアはuser、feedback、project、referenceに分類され、読み取り、編集、コミットが可能なmarkdownとして保存される。セッションは.thclaws/sessions/の下のJSONLファイルで、thclaws --resume lastまたは--resume <id>で再開できる。安全対策には、作業ディレクトリに限定されたファイルシステムサンドボックス、破壊的なシェルコマンドへのフラグ、自動承認を選択しない限りすべての変更ツール呼び出しへの承認が含まれる。複数のエージェントが実行されている場合、権限要求はどのエージェントが要求しているかを示す。

ビルド、貢献、ライセンス

貢献者の前提条件はRust 1.85+、Node.js 20+、pnpm 9+である。ビルドヘルパースクリプトはmacOSとLinuxでは./scripts/build.sh、Windowsでは./scripts/build.ps1で、GUIがコンパイル時にfrontend/dist/index.htmlを埋め込むため、最初にフロントエンドをビルドする。--checkフラグはcargo fmt --check、clippy、tsc、cargo testを実行する。READMEは具体的な貢献ターゲットを列挙している。Discord、Slack、WhatsAppアダプター、Windows ARMの仕上げ、オプションのKMS埋め込み、現在英語とタイ語のみのマニュアル章とUI文字列の国際化である。ライセンスに関して、READMEはプロジェクトがMITとApache-2.0のデュアルライセンスであり、読者が選択でき、貢献も同じデュアルライセンスで受け入れられると述べている。本記事で提供されたリポジトリメタデータに添付されたライセンス抜粋にはライセンス文面が含まれておらず、そのソースから実際の付与条件を検証することはできなかった。

編集部の結論

READMEはthClawsを、4つのインターフェースと広範なプロバイダー対応、Rustの変更を必要としない拡張ポイントを備えた単一バイナリのエージェントハーネスとして説明しており、ThaiGPT Co., Ltd.が開発し、ほぼ毎週リリースしている。宣言されたv1.0の目標は、Telegram、Discord、Slack、WhatsApp、Facebook Messenger、LINEに橋渡しするマルチプラットフォームエージェントであり、Telegram、LINE、Messengerはすでにリリース済み。READMEはMITとApache-2.0のデュアルライセンスを主張しているが、本記事で提供されたライセンス抜粋にはライセンス文面が含まれていない。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes