Skip to main content
將 TokenLab 新增為 Hermes 的獨立模型供應商,保留既有帳戶、設定與工具權限。

交給我的 Agent 處理

安裝或檢查 Hermes

參閱官方安裝指南。官方提供 Apple Silicon macOS、Windows 桌面安裝程式,以及 Linux 和原生 Windows 的 CLI 安裝方式。請核對系統需求;已安裝時跳過。

選用:可還原的自動設定

官方 Hermes 0.21.3 可使用 TokenLab Skills 0.1.3 的設定工具。它先預覽並備份,只新增命名供應商,保留 YAML 註解、帳號、預設模型及權限。先閱讀設定說明 SKILL_DIR 設為已安裝的 tokenlab-api-integration 目錄,將 HERMES_PYTHON 設為 hermes --version 顯示的安裝目錄內的 Python:macOS/Linux 為 venv/bin/python,Windows 為 venv\Scripts\python.exe。PowerShell 使用 $SkillDir$HermesPython。沿用既有環境,不安裝全域 Python 套件。
套用後跳過下方的手動合併,依工具列出的實際目錄與載入命令繼續;工具會識別 active_profile。讀取設定不會驗證金鑰。以 --restore 預覽,再加 --apply 還原原始位元組。名稱衝突、後續編輯、受管理設定或 WSL 會停止自動設定;保留原設定並使用手動流程。

設定獨立供應商

先確認 Hermes 目錄:若設定了 HERMES_HOME,使用該目錄;否則為 ~/.hermes(Windows:%LOCALAPPDATA%\hermes)。備份 config.yaml 後合併以下項目,保留其他設定。此範例使用 Chat Completions,請選擇目前支援此格式及工具呼叫的模型。 先備份目前設定。只新增 TokenLab 項目,保留既有供應商、帳戶、預設模型與權限。如果名稱已被使用,另選名稱並同步修改指令。還原時只移除本次新增的項目,或還原其原始備份。
API 金鑰建立金鑰,再於本機將 TOKENLAB_API_KEY 存入 Hermes 目錄的 .env 或啟動 Hermes 的程序環境。請勿將金鑰貼入對話或供應商 YAML。

先檢查設定,再發出請求

執行 hermes config get providers.tokenlab.api 檢查新增供應商,應顯示 https://api.tokenlab.sh/v1。保留原有 model 區段,以以下指令明確指定供應商與模型並開啟新工作階段;不加這些選項正常啟動時仍使用原預設設定。讀取設定不能驗證金鑰有效性。
準備好使用 TokenLab 餘額後,發送簡短文字請求,核對回覆及請求記錄,再嘗試唯讀工具任務。輔助模型及選用工具可能使用其他供應商或金鑰。

還原與疑難排解

若顯示未知供應商,核對版本與目前設定格式。驗證失敗時檢查本機環境及金鑰狀態,不要印出金鑰。要撤銷設定,還原原模型選擇,僅移除本次加入的 TokenLab 項目。 MCP 與 Skills 為獨立擴充:MCP 教程提供 API 工具;Skill 教程提供接入指引。此供應商設定不依賴它們。