程式工具
Hermes Agent
將 Hermes Agent 接入 TokenLab
將 TokenLab 新增為 Hermes 的獨立模型供應商,保留既有帳戶、設定與工具權限。
交給我的 Agent 處理
閱讀本頁,協助我將 Hermes 接入 TokenLab:
https://tokenlab.sh/docs/zh-TW/integrations/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 套件。
"$HERMES_PYTHON" "$SKILL_DIR/scripts/configure_hermes.py" --model gpt-5.6-luna
"$HERMES_PYTHON" "$SKILL_DIR/scripts/configure_hermes.py" --model gpt-5.6-luna --apply& $HermesPython "$SkillDir/scripts/configure_hermes.py" --model gpt-5.6-luna
& $HermesPython "$SkillDir/scripts/configure_hermes.py" --model gpt-5.6-luna --apply套用後跳過下方的手動合併,依工具列出的實際目錄與載入命令繼續;工具會識別 active_profile。讀取設定不會驗證金鑰。以 --restore 預覽,再加 --apply 還原原始位元組。名稱衝突、後續編輯、受管理設定或 WSL 會停止自動設定;保留原設定並使用手動流程。
設定獨立供應商
先確認 Hermes 目錄:若設定了 HERMES_HOME,使用該目錄;否則為 ~/.hermes(Windows:%LOCALAPPDATA%\hermes)。備份 config.yaml 後合併以下項目,保留其他設定。此範例使用 Chat Completions,請選擇目前支援此格式及工具呼叫的模型。
先備份目前設定。只新增 TokenLab 項目,保留既有供應商、帳戶、預設模型與權限。如果名稱已被使用,另選名稱並同步修改指令。還原時只移除本次新增的項目,或還原其原始備份。
providers:
tokenlab:
api: https://api.tokenlab.sh/v1
key_env: TOKENLAB_API_KEY
transport: chat_completions
default_model: gpt-5.6-luna在 API 金鑰建立金鑰,再於本機將 TOKENLAB_API_KEY 存入 Hermes 目錄的 .env 或啟動 Hermes 的程序環境。請勿將金鑰貼入對話或供應商 YAML。
先檢查設定,再發出請求
執行 hermes config get providers.tokenlab.api 檢查新增供應商,應顯示 https://api.tokenlab.sh/v1。保留原有 model 區段,以以下指令明確指定供應商與模型並開啟新工作階段;不加這些選項正常啟動時仍使用原預設設定。讀取設定不能驗證金鑰有效性。
hermes chat --provider custom:tokenlab --model gpt-5.6-luna準備好使用 TokenLab 餘額後,發送簡短文字請求,核對回覆及請求記錄,再嘗試唯讀工具任務。輔助模型及選用工具可能使用其他供應商或金鑰。
還原與疑難排解
若顯示未知供應商,核對版本與目前設定格式。驗證失敗時檢查本機環境及金鑰狀態,不要印出金鑰。要撤銷設定,還原原模型選擇,僅移除本次加入的 TokenLab 項目。
MCP 與 Skills 為獨立擴充:MCP 教程提供 API 工具;Skill 教程提供接入指引。此供應商設定不依賴它們。