OpenClaw: 開発者が知っておくべき4つの重要課題

最近のOpenClawリポジトリ（366kスター）のオープンイシューのスキャンで、本番環境に積極的に影響を与えている4つのバグと機能不足が浮かび上がりました。そのうち2つはサイレント障害を引き起こすバグで、残りの2つはコミュニティが要求している欠落機能です。以下にそれぞれの内訳を説明します。

1. チャネル経由で送信された画像がモデルに届かない

ユーザーがDiscord、Telegram、Feishu、またはOpenWebUIを介して画像を送信すると、チャネルアダプターが画像を削除し、テキストのみをモデルに渡します。ビジョン対応モデルは、画像が提供されなかったかのように応答するか、説明を幻覚します。根本原因は、チャネルアダプターのインターフェースが画像URLやbase64ペイロードを伝播しないことです。修正には、これらの画像表現を渡すようにアダプターインターフェースを拡張する必要があります。複数のイシューがこれを追跡しており、#23452が最も明確な要約です。

2. WhatsAppとTelegramが短いDNS障害で永続的にダウンする

WhatsAppとTelegramのチャネルアダプターの再接続ロジックは、セッション中の切断のみを処理します。初期接続中にDNS障害が発生した場合、エラーはリトライループから完全に逃れ、チャネルはそれ以上の再接続試行なしに終了します。ゲートウェイは動作し続けますが、チャネルは事実上死亡します。ユーザーはそれを再起動するために外部の監視スクリプトを実行していると報告しています。イシュー#2198および#13506を参照してください。

3. セッションロックを保持しているものを確認する方法がない

セッションストアは.jsonl.lockファイルを使用しますが、大規模セッション、cron負荷、並列エージェント、設定リロードなどにより定期的にスタックします。ロックがスタックすると、すべてのモデルがsession file locked (timeout 10000ms)で失敗します。回復方法は、ロックファイルを手動で削除するか、ゲートウェイを再起動することだけです。ロックファイルにはすでにpidとcreatedAtメタデータが含まれていますが、それを表示するCLIコマンドはありません。提案されたopenclaw locksコマンドは、そのメタデータを読み取り、アクティブな待機者を表示し、運用者に実行可能な洞察を提供します。イシュー#31489および#11950を参照してください。

4. エージェント間の並列調整がない

現在のsession_spawnおよびsendツールは、階層的委任のみをサポートしています——1つのエージェントが作業を委任し、待機します。複数のエージェントが同時にタスクで協力したり、状態を共有する方法はありません。イシュー#43367は、ユーザーが並列コーディングエージェントを実行しようとし、アーキテクチャの制限に加えて設定の上書きとロックの競合に直面していることを文書化しています。

これら4つの項目は貢献を受け付けており、本番環境に直接影響を与えています。本番環境でOpenClawを実行している場合は、チャネルアダプターとセッションロック管理を確認し、修正への貢献を検討してください。