權威運作合約

以下規則規範使用此技能的任何代理。本文件其他地方提供的範例僅供參考，絕不凌駕於這些規則之上。

代理陳述的每個價格、百分比、金額或市場事實，必須來自同一回合中 InvestorClaw 工具調用返回的結果。InvestorClaw 返回帶有 HMAC 簽章包裹的資料；該簽章資料是唯一的事實來源。
切勿針對任何數字自行編造、估算、猜測或使用模型自身訓練知識。如果本次回合工具未返回該數字，請勿陳述——應說「InvestorClaw 未返回該數據」。
若工具輸出的文字不含具體數字，則視為無數據；切勿將其轉換為數值。

investorclaw__portfolio_market_snapshot(symbols?, benchmarks?)——即時價格 + 持倉與基準（SPX/NDX/DJI/VIX、BTC/ETH）的當日變動百分比。symbols 是一個以逗號分隔的字串（例如 "NVDA,AAPL"），而非列表。無參數則返回持倉 + 基準。對於任何「X的價格」或比較投資組合與市場的情況，請使用此工具（而非 portfolio_ask）。
investorclaw__portfolio_performance_window(period=...)——在指定時間窗口內的回報 / 損益 / 變動最大的股票。period 支援：1d、1w、1mo、1y、5y、10y、20y、max，或自然語言短語（如 "today"、"last week"、"last year"、"entire history"）。
investorclaw__portfolio_ask(question=...)——分析/解釋。

下方舊版 investorclaw.* 點命名空間的範例已過時；上述底線形式為當前工具名稱。

自主/常時監控代理

對於無人值守代理（例如排程監控與警報器，如 MarketWatch 代理），除上述合約外：

每次運行必須先進行工具調用；切勿從記憶體中回答市場問題。排程「輪詢」意味著呼叫 portfolio_market_snapshot。
門檻掃描：呼叫 portfolio_market_snapshot，然後僅在持倉或基準突破設定波動（例如持倉 ±3%、VIX ±10%）時輸出一行簡潔訊息；否則輸出單一 NO_ALERT 標記並停止。
如果所需工具出錯或返回無數據，則輸出一個固定標記，例如 OPS_FAIL market_snapshot unavailable 並停止——切勿編造一個安慰性的數字來填補空白。
無人值守模式下不提出澄清性問題；應直接理解意圖並採取行動。
定期/收盤報表：先調用 portfolio_performance_window 獲取該窗口資料，再調用 portfolio_market_snapshot 獲取指數收盤價；然後逐字報告數字。
始終在同一快照中，將持倉與基準放在一起解讀。
傳遞方式為推送式、簡潔、數字優先。提供教育性內容，而非個人化建議。

此儲存庫是 InvestorClaw 的總體專案——包含 README、授權條款、回歸測試框架及公開面貌。ClawHub 發佈的代理可讀 SKILL.md 位於運行時儲存庫中：

Docker 化 v4.x 運行時 + ClawHub 發佈的 SKILL.md： mnemos-os/mnemos-ic-runtime
Claude Code / Claude Desktop 插件（容器優先，此儲存庫）： /plugin marketplace add argonautsystems/InvestorClaw——與其他運行時相同的技能 + 容器。請參閱 docs/GETTING_STARTED.md。
引擎原始碼（Python 分析器）：argonautsystems/ic-engine

git clone https://github.com/mnemos-os/mnemos-ic-runtime.git ~/.investorclaw
cd ~/.investorclaw
mkdir -p portfolios
docker compose up -d

compose 會拉取 ghcr.io/argonautsystems/ic-engine:4.7.7-cpu（公開託管，無需驗證）並在 localhost:18090（MCP + REST）和 localhost:18092（儀表板）上運行。

如需完整的代理可讀規範（12 工具目錄、首次運行時間線、各運行時配置區塊、故障排除），請參閱已發佈的運行時儲存庫中的 SKILL.md。

此總體儲存庫包含完整的文件集：

InvestorClaw 僅供教育用途。非財務建議。