mirofish-predict

name	mirofish-predict
description	MiroFish 群體智能推演引擎。當用戶要求「推演」「預測」「模擬」「如果…會怎樣」時使用。透過 55 個 AI Agent 在模擬社交平台上互動推演未來趨勢。
homepage	https://github.com/666ghj/MiroFish
metadata	{"openclaw":{"emoji":"🐟","requires":{"bins":["mirofish","docker"],"env":["LLM_API_KEY"]},"primaryEnv":"LLM_API_KEY","install":[{"id":"mirofish-npm","kind":"node","package":"mirofish-cli","bins":["mirofish"],"label":"Install MiroFish CLI (npm)"}]}}

MiroFish 群體智能推演

用 55 個 AI Agent 在模擬的 Twitter/Reddit 上互動，推演未來趨勢。

一鍵推演

mirofish predict "如果比特幣突破15萬美元，加密市場會怎樣？"

自動完成：啟動 Docker 後端 → 建立專案 → 構建知識圖譜 → 生成 Agent → 運行模擬 → 輸出報告。

首次設定

需要 Docker Desktop 和 LLM API key。

# 1. 啟動（首次會自動拉 Docker image）
mirofish serve start
# → 如果沒有 ~/.mirofish/.env，會生成模板讓你填 API key

# 2. 配置 API key 後重新啟動
mirofish serve start

API Key 設定方式

• 環境變數：export LLM_API_KEY=xxx
• OpenClaw config：skills."mirofish-predict".env.LLM_API_KEY
• 檔案：~/.mirofish/.env

命令參考

命令	功能
mirofish predict "主題"	完整推演（自動啟動後端）
mirofish predict "主題" --rounds=10	指定推演輪數
mirofish serve start	啟動 Docker 後端
mirofish serve stop	停止後端
mirofish serve status	檢查後端狀態
mirofish projects	列出所有專案
mirofish status <sim_id>	查詢模擬進度
mirofish report <sim_id>	取得推演報告
mirofish chat <sim_id> "問題"	對報告追問
mirofish interview <sim_id> <agent_id> "問題"	採訪特定 Agent
mirofish env	顯示設定狀態

追問

mirofish chat <sim_id> "哪些 KOL 的觀點最極端？"
mirofish interview <sim_id> 0 "你對 BTC 破 15 萬有什麼看法？"

視覺化 Dashboard（P2）

推演完成後，可開啟互動式 Canvas Dashboard 查看結果：

mirofish canvas <sim_id>
# → 自動開啟瀏覽器，顯示：
#   - 報告總覽卡片（標題、摘要、統計）
#   - 章節導航（側邊欄）
#   - 關鍵事件高亮（看多/看空標記）
#   - Agent 觀點面板
#   - 互動追問框（直接向 Report Agent 提問）

也可以在推演時加上 --canvas 自動開啟：

mirofish predict "主題" --canvas

推演完成後會自動發送系統通知（macOS/Linux/Windows）。

注意事項

• 推演消耗大量 LLM token（55 Agent × N 輪），本地模型可節省費用
• --rounds 建議 10-20 輪先試，效果好再加到 40
• --canvas 推演完成後自動啟動視覺化 Dashboard
• 建議 LLM ≥ 14B 參數

OpenClaw Extension (高級整合)

如果需要 Canvas 報告、自動觸發、Gateway RPC 控制，安裝 MiroFish Extension：

1. 將 extensions/mirofish/ 複製到 OpenClaw 的 extensions/ 目錄
2. 執行 cd extensions/mirofish && npm install && npm run build
3. 重啟 OpenClaw Gateway

Extension 提供：

• Path B: 聊天中自動觸發推演（需設定 autoTrigger: true）
• Path C: Agent tool mirofish_predict（LLM 直接調用）
• Gateway RPC: mirofish.predict, mirofish.status, mirofish.cancel, mirofish.list
• Canvas: GET /mirofish/canvas?simId=xxx