OpenRyoko 調査レポート

1. 基本情報

• ツール名: OpenRyoko
• ツールの読み方: オープンリョウコ
• 開発元: TEKION Group
• 公式サイト: https://tekion.jp/openryoko
• 関連リンク:
  • GitHub: https://github.com/rsensui2/OpenRyoko
• カテゴリ: 自律型AIエージェント
• 概要: Slackに常駐し、呼ばれた時だけ反応して頼まれた仕事を最後までやり遂げる「AI同僚」を構築するためのオープンソース基盤。Claude Codeなどをバックエンドとして利用し、チームの業務フローに自然に組み込むことができる。

2. 目的と主な利用シーン

• 解決する課題: AIエージェントがSlackなどのチャットツールで不要に割り込んでしまう問題や、長時間タスクの進捗が不透明になる課題を解決する。
• 想定利用者: 開発チーム、非エンジニア、AIを業務に組み込みたい組織
• 利用シーン:
  • Slack上からAIエージェントに自律的なリサーチやコーディングタスクを依頼する
  • 定期的なタスク（PR状況報告、競合調査、Sentry監視など）をCronで自動実行させる
  • Slack Canvas上でチームのAIタスク進行状況をリアルタイムに確認する

3. 主要機能

• 空気読みトリアージ: 雑談には介入せず、AIが呼ばれた時や確信度が高い時のみ反応する（確信度60%未満はsilentにする保守的設計）。
• 自律タスク実行（最後までやり切る）: Claude Codeの /goal Stop hookを利用し、設定された完了条件を満たすまでセッションを継続する。進捗はSlackに継続的に投稿される。
• Ryoko Agents View (Slack Canvas同期): Slack Canvasを30秒ごとに更新し、実行中や待機中のAIエージェントセッションを可視化する。
• AI組織・Skills・Cron・Knowledge管理: MarkdownやYAMLでAI組織を定義し、ディレクトリにファイルを置くだけでスキル追加や定期タスク実行、知識の蓄積が可能。
• MCP（マルチコネクタ基盤）対応: GitHub、Notion、Google Driveなど、Claude Codeが対応する外部ツール（MCPサーバー）に接続可能。
• Web Dashboard: Webブラウザからセッション履歴、コスト、カンバン、インサイトを確認・管理できるUIを提供する。
• PTYエンジンによる課金最適化: Interactive Claude PTYエンジン（v2026.6.5以降）により、Claude CLIを対話モードで起動。Maxの定額枠を利用することで、Agent SDKクレジットやAPI従量課金を消費しない。

4. 動作原理・システム構成

• アーキテクチャ: Slack等のフロントエンドとClaude Code等のAI CLIバックエンドを繋ぐ常駐デーモン。
• 主要コンポーネントとデータフロー:
  • OpenRyoko本体がSlackからのメッセージを受信し、軽量LLMを用いて反応すべきか（silent / react / reply）を判断。
  • 反応する場合は、自然言語を解析して目標（/goal）を抽出し、バックエンドのClaude Codeプロセスにタスクを渡す。
  • Claude Codeプロセスの標準入出力を監視（PTYエンジン等を利用）し、進捗状況をSlackへフィードバック。
  • SQLiteを用いて複数インスタンスのセッション状態などを管理。
• 特筆すべき要素技術:
  • 疑似ターミナル（PTY）エンジンを活用したClaude CLIの対話モード起動による課金回避。
  • Jinn by Hristo Stoyanovをベースにしたマルチエンジン・マルチコネクタ基盤。

5. 開始手順・セットアップ

• 前提条件:
  • Node.js環境（npmが利用可能であること）
  • Claude Code (v2.1.139以降推奨)
  • Slack APIの設定

• インストール/導入:

  # npmパッケージとしてグローバルインストール
  npm install -g openryoko
  

• 初期設定:
  • 端末で ryoko setup を実行し、Slackトークンなどの初期設定を行う。
• クイックスタート:
  • ryoko start コマンドで起動。
  • ブラウザで http://localhost:7777 を開き、Slackトークンを保存すれば30秒以内にSlack上でRyokoが動作を開始する。

6. 特徴・強み (Pros)

• AIエージェントをSlackに統合する際によくある「不要な割り込み」を防ぐ実用的な設計。
• Claude Codeの強力な機能（ファイル編集、推論、MCP利用）をそのままSlack上から呼び出せる。
• 長時間の自律実行（/goal）中も、Slack上で進捗を可視化できるため安心感がある。
• PTYエンジンによるMaxサブスクリプション定額枠の活用により、運用コストを大幅に抑えられる。

7. 弱み・注意点 (Cons)

• マルチテナントSaaSのバックエンドとしての利用は想定されていない。
• 外部LANや公開ネットワークに直接公開する構成はセキュリティ上非推奨（信頼境界内での運用が求められる）。
• Claude Code等の外部CLIツールに依存しているため、それらの仕様変更の影響を受ける可能性がある。

8. 料金プラン

プラン名	料金	主な特徴
オープンソース (OSS)	無料	すべての機能が利用可能（実行環境や各種API、Claude Max等の利用料は別途ユーザー負担）

• 課金体系: ツール自体は無料。バックエンドとして利用するLLMやAI CLI（Claude Pro/Max、OpenAI等）のアカウント・API利用料が別途必要。
• 無料トライアル: オープンソースであるため、環境さえあればすぐに利用可能。

9. 導入実績・事例

• 導入企業: 公開事例なし。ただし、TEKION Groupが提供する「Vibe Coder Bootcamp」などの研修やAI顧問プログラムの基盤として活用されている。
• 対象業界: ソフトウェア開発、非エンジニアのアウトプット向上を目指す組織。

10. サポート体制

• ドキュメント: 公式サイトおよびGitHubのリポジトリ内READMEによる提供。
• コミュニティ: GitHub Issues、オープンソースとしてのコミュニティ参加。
• 公式サポート: 法人向けにはTEKION Groupのコンサルティング・開発支援サービス（有償）が存在する。

11. エコシステムと連携

11.1 API・外部サービス連携

• API: 外部からの操作インターフェースとしてWebhookや各種コネクタが実装されている。
• 外部サービス連携: Slack, Discord, WhatsApp, Telegram, Notion, GitHub, Linear, Google Drive (MCP経由)

11.2 技術スタックとの相性

技術スタック	相性	メリット・推奨理由	懸念点・注意点
Node.js / npm	◎	ツール自体がnpmパッケージとして提供されている	特になし
Claude Code	◎	メインの実行エンジンとして最適化（PTYエンジン対応等）	Claude Codeのバージョン要件に注意
Slack	◎	メインのUIとして想定されており、Canvas連携など高度に統合されている	ワークスペースの権限設定が必要

12. セキュリティとコンプライアンス

• 認証: Slack APIトークン等による連携認証。
• データ管理: セッションデータ等はローカルのSQLiteに保存される（ローカルファーストな構成）。
• 準拠規格: オープンソースツールのため、導入組織のポリシーに依存する。公式サイトではセキュリティ運用上の注意として、外部ネットワークへの直接公開を避けるよう警告している。

13. 操作性 (UI/UX) と学習コスト

• UI/UX: ユーザーは主に普段利用しているSlackから自然言語で対話するため、新たに覚えるUIが少なく直感的。Canvasを用いた進捗可視化もSlack内で完結する。
• 学習コスト: 導入や初期セットアップ（サーバー構築、トークン設定）にはエンジニアリング知識が必要だが、セットアップ完了後のエンドユーザーの学習コストは非常に低い。

14. ベストプラクティス

• 効果的な活用法 (Modern Practices):
  • スキル（~/.ryoko/skills にMarkdownを配置）を定義し、チーム固有の業務フローをAIに学習させる。
  • Cron機能を活用して、毎朝の監視レポート作成やPRレビューを自動化する。
• 陥りやすい罠 (Antipatterns):
  • allowFrom 設定を空にしたまま公開ネットワークで動作させ、不正アクセスのリスクを招くこと。
  • Claude Code等のバックエンドCLIツールをアップデートせず、互換性問題を引き起こすこと。

15. ユーザーの声（レビュー分析）

• 調査対象: 公式サイト、GitHub、SNS等
• 総合評価: 新規ツールのためレビューサイト等でのスコアは未確立。
• ポジティブな評価:
  • 「Slackの雑談にAIが割り込んでこないトリアージ機能が優秀」
  • 「PTYエンジンの追加でAPIコストを気にせず自律エージェントを動かせるようになったのが画期的」
• ネガティブな評価 / 改善要望:
  • 「初期のセットアップで少し環境依存のエラーに遭遇した」
• 特徴的なユースケース:
  • マネージャーがSlackから自然言語で指示を出し、長時間の競合調査を任せておく使い方。

16. 直近半年のアップデート情報

• 2026-06-05: Interactive Claude PTYエンジンを追加し、Agent SDKクレジット課金問題を解消（v2026.6.5）

(出典: OpenRyoko リポジトリ など)

17. 類似ツールとの比較

17.1 機能比較表 (星取表)

機能カテゴリ	機能項目	本ツール	ツールA	ツールB	ツールC
基本機能	Slack連携	◎ 空気読みトリアージ機能搭載	◯ 通知のみ等の機能	◯ 通知のみ等の機能	△ 非対応
カテゴリ特定	自律タスク実行	◎ Claude Code連携	◎ 専用エンジンで高度な推論	◎ 専用エンジンで高度な推論	◯ 限定的
エンタープライズ	定額課金対応	◎ PTYエンジンでMax枠利用	× API従量課金	× API従量課金	- 不明
非機能要件	オープンソース	◎ ソース公開	× クローズドソース	× クローズドソース	◎ ソース公開

(注: ツールA、B、Cは一般的な自律型エージェントとの比較例)

17.2 詳細比較

ツール名	特徴	強み	弱み	選択肢となるケース
本ツール	Slackに常駐する自律型AI同僚	Slackでの高度な空気読み、PTYエンジンによるコスト削減	セルフホスト運用の手間	チームのチャットツールでAIを同僚のように使いたい場合
Devin	完全自律型のソフトウェアエンジニア	高度なコーディング能力	非常に高価、Slack等との密結合は薄い	大規模なリファクタリングなど複雑な自律作業が必要な場合
GitHub Copilot	IDE統合型アシスタント	IDE内でのシームレスな体験	Slack等での自律タスク実行には不向き	主にコーディング中のインライン支援を求める場合

18. 総評

• 総合的な評価: OpenRyokoは、既存の強力なAI CLI（Claude Codeなど）を、チームのコミュニケーションハブであるSlackに違和感なく統合するための極めて実用的な基盤である。特に、不要な割り込みを防ぐ「空気読みトリアージ」や、PTYエンジンを用いたコスト最適化のアプローチは、現場の課題を的確に捉えている。
• 推奨されるチームやプロジェクト: 日常的なコミュニケーションをSlackで行っており、AIにリサーチや簡単な運用タスク（Cron等）を自律的に任せたいチーム。
• 選択時のポイント: SaaS型のエージェントツールに比べて導入のハードル（セルフホスト）は少しあるものの、ランニングコストを抑えつつチームのコミュニケーションフローにAIを密接に組み込みたい場合に有力な選択肢となる。