跳至主要內容

AI 代理程式

OpenClaw

開放原始碼的個人代理程式,在你自己的電腦上執行,並在你的聊天應用程式中回覆。

連結方式
登入 API 金鑰 Skill
連接器
SPREVA
方案
免費且開放原始碼。模型供應商由你自備。

開始之前

  • 已安裝 OpenClaw,且它的閘道正在執行。
  • 一組 API 金鑰,在 SPREVA 的開發人員中,於 API 金鑰建立。

設定步驟

  1. 1

    把你的 SPREVA API 金鑰放進終端機的環境變數:

    終端機
    export SPREVA_API_KEY=spreva_sk_...
  2. 2

    新增 SPREVA。保留 --transport streamable-http:少了它,OpenClaw 會使用較舊的 SSE 傳輸方式,而 SPREVA 不會回應。OpenClaw 會先檢查連線,再儲存 SPREVA。

    終端機
    openclaw mcp add spreva \
      --url https://dev-app.spreva.ai/api/mcp \
      --transport streamable-http \
      --header "Authorization=Bearer $SPREVA_API_KEY"
  3. 3

    確認 OpenClaw 能連上 SPREVA:

    終端機
    openclaw mcp doctor spreva --probe

其他連結方式

  • 連接器網址和登入

    把連接器網址貼到應用程式中,登入 SPREVA 並點選「允許」。不需要保管任何金鑰。

    終端機
    openclaw mcp add spreva \
      --url https://dev-app.spreva.ai/api/mcp \
      --transport streamable-http --auth oauth
    openclaw mcp login spreva
  • CLI 和 Agent Skill

    安裝 spreva 命令列工具和它的 Agent Skill,適合在終端機中工作的代理程式。

    終端機
    export SPREVA_API_KEY=spreva_sk_...
    npx -y @spreva/cli skill install --target openclaw

確認是否正常運作

開始新的對話,然後問:

詢問你的代理程式
這週 SPREVA 上有哪些內容要發布?

OpenClaw 會呼叫 SPREVA 的 overview 工具,並回覆工作空間的時區、接下來要發布的內容,以及需要處理的事項。第一次使用時,OpenClaw 可能會請你允許這個工具。

疑難排解

OpenClaw 無法連結到 SPREVA

執行 openclaw mcp status --verbose。如果 SPREVA 的傳輸方式是 sse,用 openclaw mcp unset spreva 移除,再加上 --transport streamable-http 重新新增。

我已經新增金鑰,OpenClaw 還是要求我登入

使用 --auth oauth 時,OpenClaw 會登入並忽略 Authorization 標頭。兩者擇一:移除 SPREVA,再用你想要的方式重新新增。

Agent Skill 顯示缺少 API 金鑰

OpenClaw 執行的指令會從閘道的環境變數讀取 SPREVA_API_KEY。在那裡設定它,然後重新啟動閘道。

遇到其他問題?疑難排解涵蓋了反覆要求登入、方案、上限和時區等狀況。