智能體與開發者

完整的本機智能體平台，
對外開放介面。

OpenMiRA 自帶智能體執行環境、長期記憶與人工驗收，並透過 MCP 與 HTTP API 向外部智能體和應用開放同一套能力。本機模型為預設，雲端模型可選；資料不出裝置，有副作用的操作由人確認。

01 · 架構

智能體平台，介面對外開放。

OpenMiRA 自帶完整的智能體與應用；同一套介面也向外部智能體開放，模型可以替換。資料、記憶與驗收記錄始終在你的裝置上。

調用方
Agents · Apps
Claude Code · 已接通支援 MCP 的智能體自有應用(HTTP API)OpenMiRA 應用(同一套介面)
MCP · HTTP
智能體平台
Agent platform
OpenMiRA資料與記憶留在裝置上
智能體執行環境
規劃、工具呼叫與長任務；自帶的 OpenMiRA 應用即建在其上
記憶
長期多模態記憶：人物、地點、事件與偏好，跨年份關聯同一人物
檢索與出處
文件、圖片、音訊、影片統一檢索，結論附出處
人來驗收
有副作用的操作須經人確認後執行
出裝置帳本
每次呼叫雲端均記帳，可匯出
本機預設 · 雲端可選
模型
Inference
本機模型：llama.cpp · MLX · ComfyUI雲端模型(可選)：OpenAI 相容的服務商
運行在
Your hardware
x86ARMRISC-V預覽
可呼叫的範圍
同一條閉環裡的每一站，
都能被你的智能體呼叫。
已開放的範圍如下；有副作用的部分按「預設只讀，寫入須人確認」處理。
閉環中的站API可呼叫的內容狀態
資料庫 · 知識庫MCP · HTTP API檢索、附出處的問答、讀取資料已有
創作生成HTTP API出圖與出片；超出本機可完成的時長即時拒絕已有
創作生成MCP經「提案 → 人批」呼叫，批准後按原參數執行規劃中
發布營運—外部智能體提交發布請求，由人批准規劃中
02 · 接入方式

三種接入方式。

01 · 智能體
經 MCP 接入
支援 MCP 的智能體(如 Claude Code)可呼叫檢索、附出處的問答與資料庫。啟動時同步服務端的工具清單；刪除、外發、改資料等有副作用的工具不經 MCP 暴露。
Claude Code
# 令牌位於資料目錄的 token 檔
claude mcp add --env OWNWARD_TOKEN=$TOKEN ownward -- ownward-mcp \
  --url http://127.0.0.1:8090
02 · 應用
經 HTTP API 接入
檢索、問答、長任務與生成共用同一個本機介面，串流結果走 SSE；每個請求須攜帶令牌。
終端機
curl http://127.0.0.1:8090/api/v1/search \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"query": "供應商合約裡的付款條件"}'
03 · 場景
場景包
一個 JSON 檔：若干待填參數加一段預置提示詞。安裝後即新增一個場景；安裝前可查看完整內容。
場景目錄
# 場景目錄與單個場景包,都是普通的 JSON 檔案
GET /hub/index.json
GET /hub/packs/<id>.json
03 · 模型

本機預設，雲端可選。

每類任務均有本機預設模型；是否啟用雲端、選用哪一家服務商，由你決定。啟用雲端對話時，自動抽取的記憶不會發往雲端。

做什麼預設可選狀態
對話與規劃本機對話模型雲端對話服務商(OpenAI 相容)，整段對話切換已有
識別公眾人物不連網雲端視覺模型，僅在手動觸發「聯網查」時呼叫已有
生成圖片與影片本機生成—已有
按任務路由—對話、規劃、視覺分別指定本機或雲端；可配置多家服務商規劃中
相容清單
本機是預設，雲端是可選項。名單按「已有 / 待驗證 / 規劃中」分開標示。
本機模型與推論引擎
預設 · 全部在本機執行
內建已有
llama.cppMLXONNX RuntimeComfyUI
外部本機服務規劃中
OllamaLM StudiovLLMSGLangLocalAIJanXinference
內建引擎涵蓋對話、視覺、向量、重排與出圖出片。外部本機服務指你已經在跑的模型服務，經 OpenAI 相容介面接入。
雲端模型服務商
可選 · 由你逐類開啟
國際待驗證
OpenAIAnthropicGoogle GeminixAIMistralCoherePerplexity
國內待驗證
DeepSeek通義千問(阿里雲)Kimi(月之暗面)GLM(智譜)豆包(火山引擎)MiniMax文心(百度)混元(騰訊)階躍星辰
聚合與託管待驗證
OpenRouterSiliconFlowTogether AIGroqFireworksAzure OpenAI
經 OpenAI 相容介面：填入端點與 Key 即可。具體相容程度以各服務商文件為準，尚未逐家驗證；預置範本規劃中。
智能體與用戶端
經 MCP · HTTP API
已驗證已驗證
Claude Code
MCP 標準待驗證
CodexCursorWindsurfGemini CLIVS CodeClineZedClaude DesktopOpenClawHermes AgentGoose
只有 Claude Code 完成了實測，其餘依據 MCP 標準接入，尚未逐個驗證。你自己的應用走 HTTP API。
04 · 邊界

預設只讀，
寫入須人確認。

智能體可執行的範圍越大，出錯的代價越高。因此預設只讀，有副作用的操作須人確認，所有外發均記帳。

預設只讀
經 MCP 的智能體只能呼叫無副作用的工具：檢索、問答、讀取資料。
已有
寫入須人確認
刪除、外發、修改資料的工具對外部呼叫一律拒絕；僅可在工作台由人核對真實參數、確認後執行。
已有
外發記帳
每次呼叫雲端，記錄服務商、模型、發送位元組數與成敗；可匯出 CSV。
已有
外部智能體提交請求，由人批准
智能體提交擬執行的操作及完整參數，在 OpenMiRA 中等待人工批准；批准後按原參數執行。
規劃中
按資料類別攔截外發
記憶、人臉與聲紋、原始檔預設不出裝置；其餘按規則放行，被攔下時明確提示。
規劃中

加入開發者預覽。

取得預覽版文件與範例；接入方式與規劃中的能力上線時，第一批收到通知。

閱讀文件場景目錄