Repository navigation
OpenRyoko v2026.10.13
gateway を止めずに長く動かすための変更をまとめたバージョンです。設定・人格・記憶を毎日バックアップし、再起動で打ち切られたターンを次の起動で再開します。cron の実行履歴は、セッションが実際にどう終わったかを記録するようになりました。
このバージョンは、設定しなくても有効になる機能と、これまでと違う動きをする箇所を含みます。更新の手順に入る前に、次の節を読んでください。
更新の前に知っておくこと
設定しなくても有効になるもの
- 日次のバックアップ。起動の約15秒後に最初の分を取り、以後は1日1回取ります。保存先は
<ホーム>/backupsです。- ホームのアーカイブ(
config.yaml・.env・cron・人格と記憶・org・skills・docs・knowledge)と、セッション DB・workflow DB のコピーを保存します。以前からあるbackups/sessions-YYYY-MM-DD.dbは、そのまま世代として数えます。 - アーカイブには
config.yamlの token と.envの鍵がそのまま入ります。ファイルは所有者だけが読める権限で作ります。持ち出すときは秘密として扱ってください。 - symlink は、リンクとして記録するだけです。リンクの先にある中身(ホームの外に置いたスキルなど)は入りません。認証の状態、
logs/、tmp/、アップロードされたファイルも入りません。 - アーカイブに入れるファイルの合計は 512 MB、件数は 50,000 件までです。超えると、その日のアーカイブは書かずに失敗として報告します(DB のコピーは続きます)。残すのは14日分で、同じ日の分は直近3個までです。DB のコピーは7世代です。
- 保存先を変えるには
backup.directory、止めるにはbackup.enabled: falseを設定します。
- ホームのアーカイブ(
- 再起動で打ち切られたターンの再開。gateway が止まったときに実行中だったセッションへ、次の起動で通知を1回送ります。セッションは途中だった作業を確かめ、元の会話に返信します。
- 1回の起動で起こすのは10件まで、15秒おきです。120分より古い打ち切りは対象外です。同じセッションは30分以内に続けては起こさず、24時間で3回までです。cron の実行、workflow の試行、キューから自動で再実行されるターンは対象外です。
- 利用上限のリセットを待っていたターンも対象です。起こすのは、待っていたリセットの10秒後です。それより前でも、新しいメッセージが届けば、そのメッセージはすぐに実行します。
- この再開は、このバージョンに上げた直後の最初の起動から働きます。最初の起動が起こすのは、前のバージョンが止まった時点で「実行中」のまま残っていたセッションです。前のバージョンが停止の処理の中で「中断」と記録し終えたターンには、再開のための目印が無いので、最初の起動では起こしません。2回目からの再起動では、停止のときに目印を付けます。
- 止めるには
sessions.resumeInterruptedOnBoot: falseを設定します。
- 同梱スキルの同期。gateway の起動時と
ryoko migrateの実行時に、パッケージに入っているスキルをホームへ同期します。最初の同期(更新後に、gateway の起動とryoko migrateのどちらか先に行われたほう)で、次のことが起きます。- ホームに無い同梱スキルを追加します。以前に自分で削除した同梱スキルも、削除の記録がまだ無いため、この1回だけ戻ります。要らなければもう一度削除してください。以後は戻りません。
- 過去のバージョンが同梱したものと1ファイルも違わないコピーは、新しいバージョンに置き換えます。置き換える前の中身は
.migration-backups/<バージョン>-<時刻>/skills/<名前>/に残します(<バージョン>は、同期を行った側のryokoのバージョンです)。 - 編集したスキル、symlink のスキル、どのバージョンとも一致しないスキルには触れません。
skills/そのものが symlink のホームでは、同期しません。 - 何を置き換え、何に触れず、それがなぜかは、同期を行った側が報告します。gateway の起動時なら
logs/gateway.logに残り、ryoko migrate(ryoko update)なら、そのコマンドの出力に[new skill]・[updated skill]・[skill kept]の行として出ます。gateway のログでは、対処が要るもの(どのバージョンとも一致しないもの、あとから編集したもの、読めないもの)の報告は、バージョンごとに1回です。ryoko migrateは、実行のたびに出します。 - このバージョンは、修復の手順を教える
self-healスキルを書き直しています(「変更点」の「同梱のスキルと資料」)。self-healを自分で編集している環境では、編集したコピーが残ります。古い手順(tmp/を空にする、読めないcron/jobs.jsonを空のリストで作り直す、DB のセッションの状態を書き換える)が残っていないかを見てください。 - 止めるには
skills.autoSync: falseを設定します(ryoko migrateは設定に関係なく同期します)。
これまでと違う動きをするもの
-
緑だった cron が赤になることがあります。 これまで、ターンが失敗しても、結果が配信されなくても、実行履歴には
successと記録していました。このバージョンから、次の場合はerrorと記録し、cron.alertConnector/cron.alertChannelを設定していればアラートを送ります。- セッションがエラーで終わった(ログイン切れ、利用上限、エンジンのプロセスの異常終了など)
- 結果が配信されなかった(配信先のコネクタが動いていない、送信を拒否された)
- ジョブが、gateway に登録されていないエンジンを名指ししている
更新のあとにアラートが増えた場合、多くは以前から起きていた失敗が見えるようになったものです。同じ失敗が続く間、アラートは60分に1回です(
cron.alertThrottleMinutes)。待たない利用上限が理由の失敗は、ジョブと上限の期間ごとに1回です。アラートが来ないことは復旧を意味しません。実行履歴で確かめてください。 -
チャットのメッセージを、CLI のコマンドとして実行しなくなりました。 Slack・Discord・Telegram・WhatsApp から届いた
/・-・!で始まるメッセージは、テキストとしてアシスタントに渡します。チャットから Claude Code のコマンドを実行できるのは、オペレータ本人(portal.operatorSlackId/portal.operatorDiscordIdと ID が一致する相手)の/compactと/clearだけです。/usage・/costを含め、ほかのコマンドはオペレータが送ってもテキストとして届きます。オペレータ ID を設定していない環境では、誰もチャットから実行できません。/new・/status・/doctor・/cron list・/goal・/<スキル名>は、これまでどおりです。 -
/model <名前>と/cron run|enable|disableは、オペレータ ID を設定した環境ではオペレータだけが使えます。 Telegram と WhatsApp には送信者をオペレータと確かめる手段が無いため、そうした環境では、この2つのコネクタからは使えなくなります。オペレータ ID を1つも設定していない環境は、これまでどおりです。 -
トップレベルの
connectors.slackに書いたrespondToが、このバージョンで初めて効きます。 これまでのバージョンは、この設定をコネクタに渡していませんでした。トップレベルの Slack の bot は、respondToを書いていないのと同じ動き(どの場面もalways)をしていました。config.yamlにこの設定がある環境では、更新のあと、書いてあるとおりに動きます。たとえばchannel: mentionなら、メンションの無いチャンネルの投稿には応答しなくなり、チャンネルでのリアクションも扱わなくなります。respondToを書いていない環境と、connectors.instances[]の Slack は、これまでどおりです。更新の前に、config.yamlのconnectors.slack.respondToを確かめてください。 -
リセットが6時間より先の利用上限は、待たずに失敗します。 エラーにはリセットの時刻が入ります。
sessions.rateLimitStrategy: waitでも同じです。6時間以内のリセットと、時刻が分からない上限は、これまでどおり待ちます。 -
エンジンのプロセスが途中で落ちたターンは、失敗として扱います。 会話にはエラーが返信として届き、セッションは
errorになります。これまでは、返信なしで終わっていました。 -
届かなかった送信を「送信済み」にしなくなりました。 Discord・Telegram・WhatsApp で送信に失敗したとき、
POST /api/connectors/:name/sendは 500 と理由を返します。長い返信が途中で止まった場合も同じです(Slack を含みます)。{"status":"sent"}を前提にしたスクリプトがあれば、見直してください。 -
添付に上限が付きました。 200 MB を超える添付は取得せず、どの添付をなぜ取得しなかったかをセッションに伝えます。上限は、コネクタごとの
maxAttachmentMbで変えられます(connectors.slack・connectors.discord・connectors.whatsappと、connectors.instances[]の各エントリ)。Slack に共有された、Slack 以外のホストにあるファイル(Google Drive などのリモートファイル)は取得しなくなりました。 -
設定画面の保存が、あとから入った変更を上書きしなくなりました。 画面を開いたあとに
config.yamlが変わっていると、保存を断って再読み込みを促します。gateway の再起動をまたいで開いたままの画面は、最初の保存が1回断られます。 -
ryoko updateは、AI か所有者の作業が要る migration を適用済みにしなくなりました。 そうした migration が残っていると、ryoko update(ryoko migrate --auto)はバージョンを進めず、ryoko migrateの実行を求めます。このバージョンの migration もryoko migrateが必要です。
廃止したもの
POST /api/files/transferと、config.yamlのトップレベルのremotes。remotes:が残っていても、読み込みには影響しません(無視します)。POST /api/filesのpath・url・open。指定すると 400 を返します。アップロードは gateway の保存領域に入り、GET /api/files/:idで読み出します。
Docker で動かしている場合
ryoko のコマンドは、gateway が動いているコンテナの中で実行してください。ホームをコンテナに bind mount している構成で、ホスト側の ryoko をそのホームに向けて実行しないでください。
- ホスト側からは、コンテナの中の gateway が見えません。プロセスの番号は通じず、gateway が握っている DB のロックも見えません。ホスト側の CLI が DB を開くと、DB の索引ファイルを作り直してしまい、動いている gateway の記録を壊すことがあります。DB のコピー(
ryoko backup run --include-databases)と DB の復元は、特に危険です。 - バージョンの違う
ryokoが同じホームでスキルを同期すると、古い側は「より新しいバージョンがこのホームを同期した」と判断して、同期をやめます。
Slack の bot token
これまでのバージョンは、Slack に共有されたファイルを取得するとき、そのファイルの URL へ bot token を送っていました。Slack 以外のホストにあるファイル(Google Drive など、アプリが登録するリモートファイル)では、その送り先が外部のホストになります。bot が読めるチャンネルや DM にそうしたファイルが共有されたことがある環境では、bot token の再発行を検討してください。このバージョンからは、token を files.slack.com 以外へ送りません。
変更点
バックアップと復元
ryoko backup run|list|verify|restore を追加しました。
ryoko backup list # 新しい順の一覧。左端が id
ryoko backup restore <id> --only config --dry-run # 何が変わるかだけ表示する
ryoko backup restore <id> --only config # 実際に戻す- 復元は上書きだけです。バックアップに無いファイルは消しません。上書きするファイルは、直前の状態を
pre-restore-…として退避します。 - ファイルの復元は、gateway が動いたままで構いません。DB の復元は、gateway を止めてから
--gateway-stoppedを付けて実行します。 ryoko backup runが取るのはファイルだけです。DB は、gateway が1日1回、自分でコピーします。- 失敗は gateway のログと、
GET /api/statusのbackupに出ます。
対象・戻し方・DB の復元の手順は、同梱の docs/backup.md にあります。
cron
- 実行履歴が、セッションの実際の結果を記録します(前節)。
- 設定の変更が、再起動なしで定時の発火に効きます。アラートの宛先、既定の配信先、エンジンの既定は、発火のたびに読みます。
- 既定と違うエンジンの社員に割り当てたジョブへ、既定のエンジンのモデルを渡していた不具合を直しました。
- 同じジョブの前の発火が利用上限のリセットを待っている間、次の発火は見送ります(履歴には
skippedと理由を記録します)。待たない上限の通知が配信先に届くのは、上限の期間ごとに1回です。アラートも、ジョブと上限の期間ごとに1回です。 - 画面の「Recent Runs」が、直近の実行を表示します。これまでは、最初の5件を表示し続けていました。
GET /api/cron/:id/runs?limit=Nで、新しい方から N 件を取得できます。
セッションとエンジン
- 利用上限中と分かっているエンジンを、新しいセッションが最初から避けます。上限を最初に見つけたセッションのあと、続くセッションは、失敗するターンなしで切替先から始まります。コネクタから届いた会話、cron の発火、API で作ったセッション(委任した子セッション、Web の新しいチャット)のどれも同じです。エンジンやモデルを名指ししたジョブと呼び出しは、対象外です。
- 利用上限のリセットを待っているターンは、gateway を再起動しても、リセットのあとに続きを実行します。これまでは、再起動すると「待機中」のまま止まり、新しいメッセージにも「まだ待機中」と答えていました。
- Claude の対話モード(PTY)で、利用上限が実際に解除される時刻を使います。切替先に留まるのは、その時刻までです(最長12時間で、元のエンジンを試し直します)。
- 切替先のエンジンがログインしていなかった場合、切替を取り消します。これまでは、最長6時間、失敗し続けるエンジンに固定されていました。
- エンジンを切り替えたあと、元のエンジンから2つ目の回答が届く不具合を直しました。
- 作業を始めていたターンを、最初から再実行しなくなりました。
- 忙しい親セッションには、子の完了通知をまとめて1ターンで届けます(1ターンに32件まで)。
errorの親に届いた通知は、捨てずに親の履歴へ残します。 - 実行中のまま固まったセッションを、成功として片づけなくなりました。理由を記録し、親のセッションにエラーとして知らせます。
- 返信を届けられなかったターンも、結果とエンジン側の会話を保存します。届かなかった返信がエラーの通知だった場合は、届かなかった理由と、ターンが失敗した理由の両方が残ります。
設定の保存
- API・設定画面・オンボーディング・モデル設定・
ryoko migrateがconfig.yamlを保存するとき、書き換えるのは、値が変わった箇所だけになりました。ほかの行は、コメントも書式もそのまま残ります。同梱のconfig.yamlを何も変えずに保存すると、ファイルは1バイトも変わりません。これまでは、こうした保存の多くがファイル全体を書き直していました。コメントは消え、見出しだけの節(cron:)も設定画面の保存で消えていました。- キーの値を変えただけなら、ふつうは、その行に書いたコメントも残ります。コメントが消えるのは、行ごと入れ替える箇所です。削除したキーは、そのキーの行と中身に書いたコメントが消えます。削除した・値を変えた・並べ替えたリストの項目は、その行のコメントと、すぐ上・字下げしたすぐ下のコメント行が消えます(
idかnameが同じままのマッピングの項目は、その場で書き換えます)。キー: 値ごと書き直す項目は、その中のコメントが残りません。値の種類が変わったとき、リストの項目が1つも残らないとき、どの項目のものか決められないコメントの隣でリストを変えたときなどです。 - その場で書き換えられないファイルは、これまでと同じくファイル全体を書き直し、コメントは残りません。約26万文字(半角の文字だけなら 256 KB)を超えるファイル、マージキー(
<<)を使うファイル、日付として読まれる値を含むファイル、エイリアスで共有している値に及ぶ変更などです。コメント行のあるファイルをこの形で書き直したときは、infoのログにconfig.yaml was rewritten in fullと出します(ryoko migrateが保存したときは、そのコマンドの出力に出ます)。
- キーの値を変えただけなら、ふつうは、その行に書いたコメントも残ります。コメントが消えるのは、行ごと入れ替える箇所です。削除したキーは、そのキーの行と中身に書いたコメントが消えます。削除した・値を変えた・並べ替えたリストの項目は、その行のコメントと、すぐ上・字下げしたすぐ下のコメント行が消えます(
- 読めない
config.yamlには書き込みません。これまでは、リクエストの内容だけで作り直していました。ryoko config interactive on|offも同じです。 config.yamlを読み込めないとき、ryoko startなどのコマンドは、何がどこで壊れているかと、バックアップから戻す方法を2行で示して終了します。これまでは、スタックトレースが続いていました。- 予算の上限(
budgets)を一度設定すると、設定画面が保存できなくなる不具合を直しました。 GET /api/configは、MCP の API キーと、カスタム MCP サーバーのenv・headersの値を伏せて返します。config.yamlが壊れているときのエラーとログは、行と桁だけを示します。ファイルの中身は引用しません。
Slack の DM からの再ログイン
Claude や Codex のログインが切れたとき、オペレータ本人が自分の DM からログインし直せます。シェルに入れないホスト(読み取り専用のコンテナなど)向けの機能で、既定では無効です。
portal:
operatorSlackId: U0123ABCDE
connectors:
slack:
providerAuth:
enabled: trueSlack アプリの Interactivity が必要です。手順と、有効にする前に知っておくことは、同梱の docs/connectors.md の「Provider Re-login」にあります。
止まりにくくするための変更
- どこにも捕まえられなかった例外で、gateway が落ちなくなりました(捕まえられなかった例外が1分間に10件続いた場合は、これまでどおり終了します)。受け止めた件数は
GET /api/statusのprocessに出ます。0 より大きい場合、gateway は例外のあとも動き続けています。ログを確かめてください。 - Slack の token が失効していたり、起動時に Slack の API に届かなかったりしても、gateway は落ちません。
- ログファイルを開けない、書けないときも、gateway は落ちません。その旨を1回出して、ファイルなしでログを続けます。
- 内蔵の gateway MCP サーバーが、認証つきの gateway と、7777 以外のポートで動くようになりました。
- gateway が起動する Claude では、
/logoutを無効にしました。ログアウトは、その機械のターミナルから行います。 - ログに出る Slack のアプリ token、Discord と Telegram の bot token を伏せ字にします。
同梱のスキルと資料
self-heal(修復の手順)を書き直しました。 壊れたファイルは、作り直す前にバックアップから戻します。tmp/を空にする、読めないcron/jobs.jsonを空のリストで置き換える、DB のセッションの状態を書き換える、という手順は無くなりました。セッションは API(/api/sessions/<id>/stop・/reset)で扱い、DB の復元はオペレータに任せます。managementスキルは、ターンの中で子セッションをポーリングして待つ手順をやめました。onboarding・cron-manager・migrateと、設定を案内するopenryoko-configの参照資料も、このバージョンの動作に合わせています。- 資料(
docs/)は、backup.mdを追加し、connectors.md・cron.md・architecture.md・overview.md・self-modification.md・skills.md・memory.mdを実装に合わせて直しました。 - 未編集のスキルは、最初の同期で置き換わります。資料は、
ryoko migrateで届きます。資料には起動時の同期が無いので、このバージョンの migration は、docs/の12本すべてを最新の内容に置き換えます。
更新
npm install -g openryoko@2026.10.13
ryoko migrate
ryoko stop
ryoko startryoko migrateは、同梱スキルを同期したあと、既定のエンジンで AI のセッションを起動し、このバージョンの資料(docs/)の差し替えと、所有者への確認事項を進めます。ryoko migrate --autoだけでは、このバージョンの migration は完了しません。- Docker で動かしている場合は、イメージを更新してコンテナを再作成し、コンテナの中で
ryoko migrateを実行します。ローカルの tarball を組み込む構成では、そのファイルも同じバージョンへ更新します。 - 更新のあと、次のものが書かれます。2回目からは、変わったものが無ければ書き直しません。
skills/.shipped-skills.json(同梱スキルを置いた記録)と、置き換えたスキルの、置き換える前の中身(.migration-backups/)。最初の同期が書きます。上の順序ではryoko migrate、コンテナを再作成した場合は gateway の起動です。backups/の最初のバックアップ(gateway の起動の約15秒後)- セッション DB の
queue_itemsの列1つ(gateway の最初の起動)
更新のあと、次を見てください。
- 同梱スキルの同期の報告。置き換えたスキル、触れなかったスキルが分かります。
ryoko migrate(ryoko update)を先に実行した場合は、その出力の[new skill]・[updated skill]・[skill kept]の行です(gateway のログには出ません)。gateway の起動が先だった場合(コンテナを再作成した場合など)は、logs/gateway.log(画面の Logs)のBundled skills synced: …と、スキルについての警告です。 ryoko api GET /api/statusのbackup。最初のバックアップが済むと、levelがokになります。warningの場合は、targetsに理由が入っています。- cron の実行履歴とアラート。
errorに変わったジョブがあれば、errorの理由を確かめます。 - トップレベルの
connectors.slack.respondToを書いている場合、チャンネルでの応答が設定どおりになっていること。
既知の制限
- 再開の通知で起きたターンは、打ち切られたターンに付いていた添付を読めません。添付は、ターンの終わりに消えるためです。必要なら、もう一度送ってください。
- Slack で、実行中のターンの後ろに並んだメッセージは、メモリの上にしかありません。gateway を再起動すると失われ、再開の対象にもなりません。以前のバージョンからの挙動です。
- gateway を止めたとき(SIGTERM)、
Shutting down gateway...より後のログの行は、logs/gateway.logに残りません。標準出力には出ます。ターンの実行中に止めた場合のMarked session … as interrupted for resumeも、この中に入ります。以前のバージョンからの挙動で、このバージョンでは直していません。停止のときに何が起きたかは、標準出力(コンテナやサービスのログ)で確かめてください。
検証
本体(backend)378ファイル・5,649件、Web 23ファイル・147件のテストが通過しました。ベース(v2026.10.9)は、本体 197ファイル・2,502件、Web 19ファイル・128件です。
クリーンな checkout から、Node 22.20.0(typecheck・build・全テスト・runtime smoke)と Node 24.11.1(build・backend のテスト・runtime smoke)で確かめました。全テストは、低い優先度での実行と、複数同時の実行でも通しています。CI の結果は、PR #103 を参照してください。
v2026.10.9 で作ったホームを複製した隔離環境で、このバージョンの gateway を起動して確かめました。
- 最初の起動で、同梱スキルを置いた記録、置き換えたスキルの写し、起動の約15秒後のホームのバックアップ、セッション DB の列の追加が行われます。
- 再起動で打ち切られたターンの再開は、このバージョンに上げた直後の最初の起動から働きます。
- 応答の時間とメモリの使用量は、これまでのバージョンと同じ水準です。
Linux のコンテナ(読み取り専用のルート、ホームはホスト側からの bind mount)でも、v2026.10.9 が作って動かしたホームで、このバージョンの起動を確かめました。
- 同梱スキルの同期と、起動の約15秒後のバックアップ(DB のコピーを含みます)が行われます。
- ホスト側から
config.yamlを編集すると、gateway が読み直します。 - SIGTERM で正常に止まり、2回目の起動は何も書き直しません。
確かめていないこと:
- Slack の DM からの再ログインを、実物の
claude auth login・codex loginで通すこと。CLI の出力の読み取りは、テスト用の偽の CLI で確かめています。初めて使うときは、ターミナルからもログインできる状態で試してください。
- 配布物:
openryoko-2026.10.13.tgz、shasumb1511b927099af0313cb1600208e49b566047a9a(npm の公開物と一致) - ソース: 65da07f
- PR: #103
- 変更の一覧: CHANGELOG.md
