Openclaw向けStock Cache Utils

株式市場の AI エージェント向けに、市場認識型のデータキャッシングと取引ステータス検出を提供する専用ユーティリティモジュールです。

georgetao730
v1.0.0
Mar 21, 2026
0
1k
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install shared

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って shared をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

Stock Cache Utils とは?

Stock Cache Utils は、金融取引スキルに統合されたキャッシュメカニズムを提供するために設計された堅牢な技術モジュールです。アクティブな取引時間と取引時間外を区別して株式市場データをインテリジェントに管理し、不要な API 呼び出しを最小限に抑えながら AI エージェントのパフォーマンスを維持します。このユーティリティは、フィンテック分野で高度な Openclaw Skills を構築する開発者にとっての中核コンポーネントです。

このスキルは特に A-share 市場を対象としており、取引期間の自動検出と 24 時間の期限管理を提供します。このユーティリティを実装することで、開発者は市場が動いているときはリアルタイムデータを使用し、時間外は高速なキャッシュデータに切り替えるようにエージェントを構成でき、シームレスでコスト効率の高いデータ戦略を実現できます。

Stock Cache Utils のユースケース

  • 取引時間外にキャッシュされた市場スナップショットを取得することで、株式分析エージェントの API レイテンシを削減します。
  • 有効な A-share 取引時間内にのみエージェントがリアルタイム取引をトリガーする市場認識ロジックを実装します。
  • 24 時間のルックバックウィンドウを維持するために、金融調査エージェントのローカルデータ永続化を管理します。
  • リアルタイムデータソースが利用できない場合に、キャッシュされたデータに適切にフォールバックする回復力のある金融 Openclaw Skills を構築します。

Stock Cache Utils の仕組み

  1. ユーティリティは、設定可能な Time-To-Live (TTL)(デフォルトは 24 時間)を持つローカルキャッシュディレクトリを初期化します。
  2. 取引ステータスチェックを実行し、現在のシステム時間が A-share の取引時間内(取引日の 9:30 - 15:30)であるかどうかを判定します。
  3. 市場のステータスに基づいてロジックが分岐します:取引時間中は最新データを優先し、時間外は有効なローカルキャッシュを確認します。
  4. データはメタデータとともにシリアル化され、ローカルディスクに保存されるため、取得や有効期限の検証が容易です。
  5. システムは次の取引時間を自動的に計算し、エージェントが将来のタスクをスケジュールするのを支援します。

Stock Cache Utils のセットアップ

このユーティリティを Openclaw Skills 環境に統合するには、Python 3.10 以上を実行していることを確認してください。外部依存関係がないため、インストールは簡単です:

# スキルのディレクトリに移動
cd your-skill-folder

# モジュールを Python 環境にインポート
# cache_utils.py が PYTHONPATH にあることを確認

スクリプトでキャッシュを初期化します:

from cache_utils import StockDataCache
cache = StockDataCache(cache_dir='.\/.cache', cache_max_age_hours=24)

Stock Cache Utils のデータスキーマとタクソノミー

このユーティリティは、ディレクトリベースのストレージシステムを使用してデータを整理します。メタデータの分類には、以下の取引ステータスフィールドが含まれます:

フィールド 型 説明
current_time String チェック時の ISO タイムスタンプ
is_trading_day Boolean 今日が有効な市場営業日の場合は True
is_trading_time Boolean 9:30-15:30 の時間内の場合は True
next_trading_time String 次の市場開始のタイムスタンプ

Stock Cache Utils の高度な機能

  • A-share の市場時間に特化して調整されたインテリジェントな取引ステータス検出。
  • カスタマイズ可能な TTL(時間単位)による自動キャッシュ期限管理。
  • 最新の有効なキャッシュを使用してエージェントがオフラインで動作できるようにするフォールバックメカニズム。
  • 外部ライブラリへの依存ゼロで、異なる Openclaw Skills 環境間での最大限の互換性を実現する軽量な設計。

SKILL.md


ローディング

関連するOpenclawのスキル

特徴*