Tham khảo biến môi trường
Tất cả các biến đều có trong ~/.hermes/.env . Bạn cũng có thể đặt chúng bằng hermes config set VAR value .
Nhà cung cấp LLM
| Biến | Mô tả |
|---|---|
OPENROUTER_API_KEY | Khóa API OpenRouter (được khuyến nghị để linh hoạt) |
OPENROUTER_BASE_URL | Ghi đè URL cơ sở tương thích với OpenRouter |
AI_GATEWAY_API_KEY | Khóa API Vercel AI Gateway (ai-gateway.vercel.sh) |
AI_GATEWAY_BASE_URL | Ghi đè URL cơ sở của AI Gateway (mặc định: https://ai-gateway.vercel.sh/v1 ) |
OPENAI_API_KEY | Khóa API cho các điểm cuối tương thích với OpenAI tùy chỉnh (được sử dụng với OPENAI_BASE_URL ) |
OPENAI_BASE_URL | URL cơ sở cho điểm cuối tùy chỉnh (VLLM, SGLang, v.v.) |
COPILOT_GITHUB_TOKEN | Mã thông báo GitHub cho API Copilot — ưu tiên hàng đầu (OAuth gho_* hoặc PAT chi tiết github_pat_* ; PAT cổ điển ghp_* không được hỗ trợ) |
GH_TOKEN | Mã thông báo GitHub — ưu tiên thứ hai cho Copilot (cũng được gh CLI sử dụng) |
GITHUB_TOKEN | Mã thông báo GitHub — ưu tiên thứ ba cho Copilot |
HERMES_COPILOT_ACP_COMMAND | Ghi đè đường dẫn nhị phân Copilot ACP CLI (mặc định: copilot ) |
COPILOT_CLI_PATH | Bí danh cho HERMES_COPILOT_ACP_COMMAND |
HERMES_COPILOT_ACP_ARGS | Ghi đè các đối số ACP của Copilot (mặc định: --acp --stdio ) |
COPILOT_ACP_BASE_URL | Ghi đè URL cơ sở Copilot ACP |
GLM_API_KEY | z.ai / Khóa API ZhipuAI GLM (z.ai) |
ZAI_API_KEY | Bí danh cho GLM_API_KEY |
Z_AI_API_KEY | Bí danh cho GLM_API_KEY |
GLM_BASE_URL | Ghi đè URL cơ sở z.ai (mặc định: https://api.z.ai/api/paas/v4 ) |
KIMI_API_KEY | Khóa API Kimi / Moonshot AI (moonshot.ai) |
KIMI_BASE_URL | Ghi đè URL cơ sở Kimi (mặc định: https://api.moonshot.ai/v1 ) |
MINIMAX_API_KEY | Khóa API MiniMax — điểm cuối toàn cầu (minimax.io) |
MINIMAX_BASE_URL | Ghi đè URL cơ sở MiniMax (mặc định: https://api.minimax.io/v1 ) |
MINIMAX_CN_API_KEY | Khóa API MiniMax — Điểm cuối Trung Quốc (minimaxi.com) |
MINIMAX_CN_BASE_URL | Ghi đè URL cơ sở MiniMax China (mặc định: https://api.minimaxi.com/v1 ) |
KILOCODE_API_KEY | Khóa API mã Kilo (kilo.ai) |
KILOCODE_BASE_URL | Ghi đè URL cơ sở KiloCode (mặc định: https://api.kilo.ai/api/gateway ) |
HF_TOKEN | Mã thông báo Ôm khuôn mặt dành cho Nhà cung cấp suy luận (huggingface.co/settings/tokens) |
HF_BASE_URL | Ghi đè URL cơ sở Hugging Face (mặc định: https://router.huggingface.co/v1 ) |
GOOGLE_API_KEY | Khóa API Google AI Studio (aistudio.google.com/app/apikey) |
GEMINI_API_KEY | Bí danh cho GOOGLE_API_KEY |
GEMINI_BASE_URL | Ghi đè URL cơ sở Google AI Studio |
ANTHROPIC_API_KEY | Khóa API bảng điều khiển Anthropic (console.anthropic.com) |
ANTHROPIC_TOKEN | Ghi đè thủ công hoặc kế thừa OAuth/mã thông báo thiết lập Anthropic |
DASHSCOPE_API_KEY | Khóa API của Alibaba Cloud DashScope cho các mô hình Qwen (modelstudio.console.alibabacloud.com) |
DASHSCOPE_BASE_URL | URL cơ sở DashScope tùy chỉnh (mặc định: https://coding-intl.dashscope.aliyuncs.com/v1 ) |
DEEPSEEK_API_KEY | Khóa API DeepSeek để truy cập DeepSeek trực tiếp (platform.deepseek.com) |
DEEPSEEK_BASE_URL | URL cơ sở API DeepSeek tùy chỉnh |
OPENCODE_ZEN_API_KEY | Khóa API OpenCode Zen — quyền truy cập trả tiền khi bạn sử dụng vào các mô hình được quản lý (opencode.ai) |
OPENCODE_ZEN_BASE_URL | Ghi đè URL cơ sở OpenCode Zen |
OPENCODE_GO_API_KEY | Khóa API OpenCode Go — đăng ký $10/tháng cho các mô hình mở (opencode.ai) |
OPENCODE_GO_BASE_URL | Ghi đè OpenCode Go URL cơ sở |
CLAUDE_CODE_OAUTH_TOKEN | Ghi đè mã thông báo Claude Code rõ ràng nếu bạn xuất thủ công |
HERMES_MODEL | Tên mẫu máy ưa thích (được chọn trước LLM_MODEL, được sử dụng bởi cổng) |
LLM_MODEL | Tên mô hình mặc định (dự phòng khi không được đặt trong config.yaml) |
VOICE_TOOLS_OPENAI_KEY | Khóa OpenAI ưa thích dành cho các nhà cung cấp dịch vụ chuyển lời nói thành văn bản và chuyển văn bản thành giọng nói OpenAI |
HERMES_LOCAL_STT_COMMAND | Mẫu lệnh chuyển giọng nói thành văn bản cục bộ tùy chọn. Hỗ trợ các phần giữ chỗ {input_path} , {output_dir} , {language} và {model} |
HERMES_LOCAL_STT_LANGUAGE | Ngôn ngữ mặc định được chuyển tới HERMES_LOCAL_STT_COMMAND hoặc dự phòng CLI cục bộ được phát hiện tự động whisper (mặc định: en ) |
HERMES_HOME | Ghi đè thư mục cấu hình Hermes (mặc định: ~/.hermes ). Đồng thời xác định phạm vi tệp PID cổng và tên dịch vụ systemd, do đó, nhiều cài đặt có thể chạy đồng thời |
Xác thực nhà cung cấp (OAuth)
Đối với xác thực Anthropic gốc, Hermes ưu tiên các tệp thông tin xác thực của riêng Claude Code khi chúng tồn tại vì những thông tin xác thực đó có thể tự động làm mới. Các biến môi trường như ANTHROPIC_TOKEN vẫn hữu ích khi ghi đè thủ công nhưng chúng không còn là đường dẫn ưu tiên để đăng nhập Claude Pro/Max.
| Biến | Mô tả |
|---|---|
HERMES_INFERENCE_PROVIDER | Ghi đè lựa chọn nhà cung cấp: auto , openrouter , nous , openai-codex , copilot , copilot-acp , anthropic , huggingface , zai , kimi-coding , minimax , minimax-cn , kilocode , alibaba , deepseek , opencode-zen , opencode-go , ai-gateway (mặc định: auto ) |
HERMES_PORTAL_BASE_URL | Ghi đè URL Nous Portal (để phát triển/thử nghiệm) |
NOUS_INFERENCE_BASE_URL | Ghi đè URL API suy luận Nous |
HERMES_NOUS_MIN_KEY_TTL_SECONDS | Khóa tác nhân tối thiểu TTL trước khi đúc lại (mặc định: 1800 = 30 phút) |
HERMES_NOUS_TIMEOUT_SECONDS | Hết thời gian chờ HTTP cho luồng thông tin xác thực / mã thông báo Nous |
HERMES_DUMP_REQUESTS | Kết xuất tải trọng yêu cầu API vào tệp nhật ký ( true / false ) |
HERMES_PREFILL_MESSAGES_FILE | Đường dẫn đến tệp JSON chứa các thông báo điền trước tạm thời được chèn vào thời điểm gọi API |
HERMES_TIMEZONE | Ghi đè múi giờ IANA (ví dụ America/New_York ) |
API công cụ
| Biến | Mô tả |
|---|---|
PARALLEL_API_KEY | Tìm kiếm trên web gốc AI (parallel.ai) |
FIRECRAWL_API_KEY | Quét web và trình duyệt đám mây (firecrawl.dev) |
FIRECRAWL_API_URL | Điểm cuối API Firecrawl tùy chỉnh cho các phiên bản tự lưu trữ (tùy chọn) |
TAVILY_API_KEY | Khóa API Tavily để tìm kiếm, trích xuất và thu thập dữ liệu trên web gốc AI (app.tavily.com) |
EXA_API_KEY | Khóa API Exa cho nội dung và tìm kiếm trên web gốc AI (exa.ai) |
BROWSERBASE_API_KEY | Tự động hóa trình duyệt (browserbase.com) |
BROWSERBASE_PROJECT_ID | ID dự án cơ sở trình duyệt |
BROWSER_USE_API_KEY | Trình duyệt Sử dụng khóa API trình duyệt đám mây (browser-use.com) |
FIRECRAWL_BROWSER_TTL | Phiên trình duyệt Firecrawl TTL tính bằng giây (mặc định: 300) |
BROWSER_CDP_URL | URL giao thức Chrome DevTools cho trình duyệt cục bộ (được đặt qua /browser connect , ví dụ: ws://localhost:9222 ) |
CAMOFOX_URL | URL trình duyệt chống phát hiện cục bộ Camofox (mặc định: http://localhost:9377 ) |
BROWSER_INACTIVITY_TIMEOUT | Thời gian chờ không hoạt động của phiên trình duyệt tính bằng giây |
FAL_KEY | Tạo hình ảnh (fal.ai) |
GROQ_API_KEY | Khóa API Groq Whisper STT (groq.com) |
ELEVENLABS_API_KEY | Giọng nói TTS cao cấp của ElevenLabs (elevenlabs.io) |
STT_GROQ_MODEL | Ghi đè mô hình Groq STT (mặc định: whisper-large-v3-turbo ) |
GROQ_BASE_URL | Ghi đè điểm cuối STT tương thích với Groq OpenAI |
STT_OPENAI_MODEL | Ghi đè mô hình OpenAI STT (mặc định: whisper-1 ) |
STT_OPENAI_BASE_URL | Ghi đè điểm cuối STT tương thích với OpenAI |
GITHUB_TOKEN | Mã thông báo GitHub cho Trung tâm kỹ năng (giới hạn tỷ lệ API cao hơn, xuất bản kỹ năng) |
HONCHO_API_KEY | Lập mô hình người dùng giữa các phiên (honcho.dev) |
HONCHO_BASE_URL | URL cơ sở cho các phiên bản Honcho tự lưu trữ (mặc định: đám mây Honcho). Không cần khóa API cho phiên bản cục bộ |
SUPERMEMORY_API_KEY | Bộ nhớ dài hạn ngữ nghĩa với tính năng thu hồi hồ sơ và nhập phiên (supermemory.ai) |
TINKER_API_KEY | Đào tạo RL (tinker-console.thinkingmachines.ai) |
WANDB_API_KEY | Số liệu đào tạo RL (wandb.ai) |
DAYTONA_API_KEY | Hộp cát đám mây Daytona (daytona.io) |
Phần cuối của terminal
| Biến | Mô tả |
|---|---|
TERMINAL_ENV | Phần cuối: local , docker , ssh , singularity , modal , daytona |
TERMINAL_DOCKER_IMAGE | Hình ảnh Docker (mặc định: nikolaik/python-nodejs:python3.11-nodejs20 ) |
TERMINAL_DOCKER_FORWARD_ENV | Mảng JSON chứa các tên var env để chuyển tiếp rõ ràng tới các phiên cuối của Docker. Lưu ý: required_environment_variables được khai báo theo kỹ năng được chuyển tiếp tự động - bạn chỉ cần điều này đối với các vars không được khai báo bởi bất kỳ kỹ năng nào. |
TERMINAL_DOCKER_VOLUMES | Các giá trị gắn kết ổ đĩa Docker bổ sung (cặp host:container được phân tách bằng dấu phẩy) |
TERMINAL_DOCKER_MOUNT_CWD_TO_WORKSPACE | Chọn tham gia nâng cao: gắn cwd khởi chạy vào Docker /workspace ( true / false , mặc định: false ) |
TERMINAL_SINGULARITY_IMAGE | Hình ảnh kỳ dị hoặc đường dẫn .sif |
TERMINAL_MODAL_IMAGE | Hình ảnh vùng chứa phương thức |
TERMINAL_DAYTONA_IMAGE | Hình ảnh hộp cát Daytona |
TERMINAL_TIMEOUT | Thời gian chờ lệnh tính bằng giây |
TERMINAL_LIFETIME_SECONDS | Thời gian tồn tại tối đa cho các phiên cuối tính bằng giây |
TERMINAL_CWD | Thư mục làm việc cho tất cả các phiên cuối |
SUDO_PASSWORD | Bật sudo mà không cần lời nhắc tương tác |
Đối với các chương trình phụ trợ hộp cát trên đám mây, tính bền vững được định hướng theo hệ thống tệp. TERMINAL_LIFETIME_SECONDS kiểm soát thời điểm Hermes dọn sạch phiên cuối không hoạt động và các lần tiếp tục sau đó có thể tạo lại hộp cát thay vì tiếp tục chạy các quy trình trực tiếp tương tự.
Phần cuối SSH
| Biến | Mô tả |
|---|---|
TERMINAL_SSH_HOST | Tên máy chủ từ xa |
TERMINAL_SSH_USER | tên người dùng SSH |
TERMINAL_SSH_PORT | Cổng SSH (mặc định: 22) |
TERMINAL_SSH_KEY | Đường dẫn đến khóa riêng |
TERMINAL_SSH_PERSISTENT | Ghi đè shell liên tục cho SSH (mặc định: tuân theo TERMINAL_PERSISTENT_SHELL ) |
Tài nguyên vùng chứa (Docker, Singularity, Modal, Daytona)
| Biến | Mô tả |
|---|---|
TERMINAL_CONTAINER_CPU | Lõi CPU (mặc định: 1) |
TERMINAL_CONTAINER_MEMORY | Bộ nhớ tính bằng MB (mặc định: 5120) |
TERMINAL_CONTAINER_DISK | Đĩa tính bằng MB (mặc định: 51200) |
TERMINAL_CONTAINER_PERSISTENT | Duy trì hệ thống tệp chứa vùng chứa qua các phiên (mặc định: true ) |
TERMINAL_SANDBOX_DIR | Thư mục máy chủ dành cho không gian làm việc và lớp phủ (mặc định: ~/.hermes/sandboxes/ ) |
Vỏ liên tục
| Biến | Mô tả |
|---|---|
TERMINAL_PERSISTENT_SHELL | Bật shell liên tục cho các chương trình phụ trợ không cục bộ (mặc định: true ). Cũng có thể giải quyết thông qua terminal.persistent_shell trong config.yaml |
TERMINAL_LOCAL_PERSISTENT | Kích hoạt shell liên tục cho chương trình phụ trợ cục bộ (mặc định: false ) |
TERMINAL_SSH_PERSISTENT | Ghi đè shell liên tục cho chương trình phụ trợ SSH (mặc định: tuân theo TERMINAL_PERSISTENT_SHELL ) |
Nhắn tin
| Variable | Description |
|---|---|
TELEGRAM_BOT_TOKEN | Telegram bot token (from @BotFather) |
TELEGRAM_ALLOWED_USERS | Comma-separated user IDs allowed to use the bot |
TELEGRAM_HOME_CHANNEL | Default Telegram chat/channel for cron delivery |
TELEGRAM_HOME_CHANNEL_NAME | Display name for the Telegram home channel |
TELEGRAM_WEBHOOK_URL | Public HTTPS URL for webhook mode (enables webhook instead of polling) |
TELEGRAM_WEBHOOK_PORT | Local listen port for webhook server (default: 8443 ) |
TELEGRAM_WEBHOOK_SECRET | Secret token for verifying updates come from Telegram |
TELEGRAM_REACTIONS | Enable emoji reactions on messages during processing (default: false ) |
DISCORD_BOT_TOKEN | Discord bot token |
DISCORD_ALLOWED_USERS | Comma-separated Discord user IDs allowed to use the bot |
DISCORD_HOME_CHANNEL | Default Discord channel for cron delivery |
DISCORD_HOME_CHANNEL_NAME | Display name for the Discord home channel |
DISCORD_REQUIRE_MENTION | Require an @mention before responding in server channels |
DISCORD_FREE_RESPONSE_CHANNELS | Comma-separated channel IDs where mention is not required |
DISCORD_AUTO_THREAD | Auto-thread long replies when supported |
DISCORD_REACTIONS | Enable emoji reactions on messages during processing (default: true ) |
DISCORD_IGNORED_CHANNELS | Comma-separated channel IDs where the bot never responds |
DISCORD_NO_THREAD_CHANNELS | Comma-separated channel IDs where bot responds without auto-threading |
SLACK_BOT_TOKEN | Slack bot token ( xoxb-... ) |
SLACK_APP_TOKEN | Slack app-level token ( xapp-... , required for Socket Mode) |
SLACK_ALLOWED_USERS | Comma-separated Slack user IDs |
SLACK_HOME_CHANNEL | Default Slack channel for cron delivery |
SLACK_HOME_CHANNEL_NAME | Display name for the Slack home channel |
WHATSAPP_ENABLED | Enable the WhatsApp bridge ( true / false ) |
WHATSAPP_MODE | bot (separate number) or self-chat (message yourself) |
WHATSAPP_ALLOWED_USERS | Comma-separated phone numbers (with country code, no + ), or * to allow all senders |
WHATSAPP_ALLOW_ALL_USERS | Allow all WhatsApp senders without an allowlist ( true / false ) |
WHATSAPP_DEBUG | Log raw message events in the bridge for troubleshooting ( true / false ) |
SIGNAL_HTTP_URL | signal-cli daemon HTTP endpoint (for example http://127.0.0.1:8080 ) |
SIGNAL_ACCOUNT | Bot phone number in E.164 format |
SIGNAL_ALLOWED_USERS | Comma-separated E.164 phone numbers or UUIDs |
SIGNAL_GROUP_ALLOWED_USERS | Comma-separated group IDs, or * for all groups |
SIGNAL_HOME_CHANNEL_NAME | Display name for the Signal home channel |
SIGNAL_IGNORE_STORIES | Ignore Signal stories/status updates |
SIGNAL_ALLOW_ALL_USERS | Allow all Signal users without an allowlist |
TWILIO_ACCOUNT_SID | Twilio Account SID (shared with telephony skill) |
TWILIO_AUTH_TOKEN | Twilio Auth Token (shared with telephony skill) |
TWILIO_PHONE_NUMBER | Twilio phone number in E.164 format (shared with telephony skill) |
SMS_WEBHOOK_PORT | Webhook listener port for inbound SMS (default: 8080 ) |
SMS_ALLOWED_USERS | Comma-separated E.164 phone numbers allowed to chat |
SMS_ALLOW_ALL_USERS | Allow all SMS senders without an allowlist |
SMS_HOME_CHANNEL | Phone number for cron job / notification delivery |
SMS_HOME_CHANNEL_NAME | Display name for the SMS home channel |
EMAIL_ADDRESS | Email address for the Email gateway adapter |
EMAIL_PASSWORD | Password or app password for the email account |
EMAIL_IMAP_HOST | IMAP hostname for the email adapter |
EMAIL_IMAP_PORT | IMAP port |
EMAIL_SMTP_HOST | SMTP hostname for the email adapter |
EMAIL_SMTP_PORT | SMTP port |
EMAIL_ALLOWED_USERS | Comma-separated email addresses allowed to message the bot |
EMAIL_HOME_ADDRESS | Default recipient for proactive email delivery |
EMAIL_HOME_ADDRESS_NAME | Display name for the email home target |
EMAIL_POLL_INTERVAL | Email polling interval in seconds |
EMAIL_ALLOW_ALL_USERS | Allow all inbound email senders |
DINGTALK_CLIENT_ID | DingTalk bot AppKey from developer portal (open.dingtalk.com) |
DINGTALK_CLIENT_SECRET | DingTalk bot AppSecret from developer portal |
DINGTALK_ALLOWED_USERS | Comma-separated DingTalk user IDs allowed to message the bot |
FEISHU_APP_ID | Feishu/Lark bot App ID from open.feishu.cn |
FEISHU_APP_SECRET | Feishu/Lark bot App Secret |
FEISHU_DOMAIN | feishu (China) or lark (international). Default: feishu |
FEISHU_CONNECTION_MODE | websocket (recommended) or webhook . Default: websocket |
FEISHU_ENCRYPT_KEY | Optional encryption key for webhook mode |
FEISHU_VERIFICATION_TOKEN | Optional verification token for webhook mode |
FEISHU_ALLOWED_USERS | Comma-separated Feishu user IDs allowed to message the bot |
FEISHU_HOME_CHANNEL | Feishu chat ID for cron delivery and notifications |
WECOM_BOT_ID | WeCom AI Bot ID from admin console |
WECOM_SECRET | WeCom AI Bot secret |
WECOM_WEBSOCKET_URL | Custom WebSocket URL (default: wss://openws.work.weixin.qq.com ) |
WECOM_ALLOWED_USERS | Comma-separated WeCom user IDs allowed to message the bot |
WECOM_HOME_CHANNEL | WeCom chat ID for cron delivery and notifications |
MATTERMOST_URL | Mattermost server URL (e.g. https://mm.example.com ) |
MATTERMOST_TOKEN | Bot token or personal access token for Mattermost |
MATTERMOST_ALLOWED_USERS | Comma-separated Mattermost user IDs allowed to message the bot |
MATTERMOST_HOME_CHANNEL | Channel ID for proactive message delivery (cron, notifications) |
MATTERMOST_REQUIRE_MENTION | Require @mention in channels (default: true ). Set to false to respond to all messages. |
MATTERMOST_FREE_RESPONSE_CHANNELS | Comma-separated channel IDs where bot responds without @mention |
MATTERMOST_REPLY_MODE | Reply style: thread (threaded replies) or off (flat messages, default) |
MATRIX_HOMESERVER | Matrix homeserver URL (e.g. https://matrix.org ) |
MATRIX_ACCESS_TOKEN | Matrix access token for bot authentication |
MATRIX_USER_ID | Matrix user ID (e.g. @hermes:matrix.org ) — required for password login, optional with access token |
MATRIX_PASSWORD | Matrix password (alternative to access token) |
MATRIX_ALLOWED_USERS | Comma-separated Matrix user IDs allowed to message the bot (e.g. @alice:matrix.org ) |
MATRIX_HOME_ROOM | Room ID for proactive message delivery (e.g. !abc123:matrix.org ) |
MATRIX_ENCRYPTION | Enable end-to-end encryption ( true / false , default: false ) |
MATRIX_REQUIRE_MENTION | Require @mention in rooms (default: true ). Set to false to respond to all messages. |
MATRIX_FREE_RESPONSE_ROOMS | Comma-separated room IDs where bot responds without @mention |
MATRIX_AUTO_THREAD | Auto-create threads for room messages (default: true ) |
HASS_TOKEN | Home Assistant Long-Lived Access Token (enables HA platform + tools) |
HASS_URL | Home Assistant URL (default: http://homeassistant.local:8123 ) |
WEBHOOK_ENABLED | Enable the webhook platform adapter ( true / false ) |
WEBHOOK_PORT | HTTP server port for receiving webhooks (default: 8644 ) |
WEBHOOK_SECRET | Global HMAC secret for webhook signature validation (used as fallback when routes don't specify their own) |
API_SERVER_ENABLED | Enable the OpenAI-compatible API server ( true / false ). Runs alongside other platforms. |
API_SERVER_KEY | Bearer token for API server authentication. Strongly recommended; required for any network-accessible deployment. |
API_SERVER_CORS_ORIGINS | Comma-separated browser origins allowed to call the API server directly (for example http://localhost:3000,http://127.0.0.1:3000 ). Default: disabled. |
API_SERVER_PORT | Port for the API server (default: 8642 ) |
API_SERVER_HOST | Host/bind address for the API server (default: 127.0.0.1 ). Use 0.0.0.0 for network access only with API_SERVER_KEY and a narrow API_SERVER_CORS_ORIGINS allowlist. |
MESSAGING_CWD | Working directory for terminal commands in messaging mode (default: ~ ) |
GATEWAY_ALLOWED_USERS | Comma-separated user IDs allowed across all platforms |
GATEWAY_ALLOW_ALL_USERS | Allow all users without allowlists ( true / false , default: false ) |
Hành vi của đại lý
| Biến | Mô tả |
|---|---|
HERMES_MAX_ITERATIONS | Số lần lặp gọi công cụ tối đa cho mỗi cuộc hội thoại (mặc định: 90) |
HERMES_TOOL_PROGRESS | Biến tương thích không dùng nữa để hiển thị tiến trình công cụ. Thích display.tool_progress trong config.yaml . |
HERMES_TOOL_PROGRESS_MODE | Biến tương thích không được dùng nữa cho chế độ tiến trình công cụ. Thích display.tool_progress trong config.yaml . |
HERMES_HUMAN_DELAY_MODE | Tốc độ phản hồi: off / natural / custom |
HERMES_HUMAN_DELAY_MIN_MS | Phạm vi độ trễ tùy chỉnh tối thiểu (ms) |
HERMES_HUMAN_DELAY_MAX_MS | Phạm vi độ trễ tùy chỉnh tối đa (ms) |
HERMES_QUIET | Ngăn chặn đầu ra không cần thiết ( true / false ) |
HERMES_API_TIMEOUT | Thời gian chờ cuộc gọi API LLM tính bằng giây (mặc định: 1800 ) |
HERMES_EXEC_ASK | Bật lời nhắc phê duyệt thực thi ở chế độ cổng ( true / false ) |
HERMES_ENABLE_PROJECT_PLUGINS | Bật tính năng tự động phát hiện các plugin repo-local từ ./.hermes/plugins/ ( true / false , mặc định: false ) |
HERMES_BACKGROUND_NOTIFICATIONS | Chế độ thông báo quá trình nền trong cổng: all (mặc định), result , error , off |
HERMES_EPHEMERAL_SYSTEM_PROMPT | Lời nhắc hệ thống tạm thời được đưa vào tại thời điểm gọi API (không bao giờ tồn tại trong phiên) |
Cài đặt phiên
| Biến | Mô tả |
|---|---|
SESSION_IDLE_MINUTES | Đặt lại phiên sau N phút không hoạt động (mặc định: 1440) |
SESSION_RESET_HOUR | Giờ reset hàng ngày ở định dạng 24h (mặc định: 4=4h sáng) |
Nén ngữ cảnh (chỉ config.yaml)
Nén ngữ cảnh được định cấu hình riêng thông qua phần compression trong config.yaml — không có biến môi trường nào cho nó.
compression:
enabled: true
threshold: 0.50
summary_model: ""
# empty = use main configured model
summary_provider: auto
summary_base_url: null
# Custom OpenAI-compatible endpoint for summaries
Ghi đè tác vụ phụ trợ
| Biến | Mô tả |
|---|---|
AUXILIARY_VISION_PROVIDER | Ghi đè nhà cung cấp cho các nhiệm vụ tầm nhìn |
AUXILIARY_VISION_MODEL | Ghi đè mô hình cho các nhiệm vụ tầm nhìn |
AUXILIARY_VISION_BASE_URL | Điểm cuối tương thích OpenAI trực tiếp cho các nhiệm vụ thị giác |
AUXILIARY_VISION_API_KEY | Khóa API được ghép nối với AUXILIARY_VISION_BASE_URL |
AUXILIARY_WEB_EXTRACT_PROVIDER | Ghi đè nhà cung cấp để trích xuất/tóm tắt web |
AUXILIARY_WEB_EXTRACT_MODEL | Mô hình ghi đè để trích xuất/tóm tắt web |
AUXILIARY_WEB_EXTRACT_BASE_URL | Điểm cuối tương thích trực tiếp với OpenAI để trích xuất/tóm tắt web |
AUXILIARY_WEB_EXTRACT_API_KEY | Khóa API được ghép nối với AUXILIARY_WEB_EXTRACT_BASE_URL |
Đối với các điểm cuối trực tiếp dành riêng cho nhiệm vụ, Hermes sử dụng khóa API được định cấu hình của nhiệm vụ hoặc OPENAI_API_KEY . Nó không sử dụng lại OPENROUTER_API_KEY cho các điểm cuối tùy chỉnh đó.
Mô hình dự phòng (chỉ config.yaml)
Dự phòng mô hình chính được định cấu hình riêng thông qua config.yaml — không có biến môi trường nào cho nó. Thêm phần fallback_model với các phím provider và model để bật chuyển đổi dự phòng tự động khi mô hình chính của bạn gặp lỗi.
fallback_model:
provider: openrouter
model: anthropic/claude-sonnet-4
Xem Nhà cung cấp dự phòng để biết chi tiết đầy đủ.
Định tuyến nhà cung cấp (chỉ config.yaml)
Chúng nằm trong ~/.hermes/config.yaml trong phần provider_routing:| Chìa khóa | Mô tả |
|------|-------------|
| sort | Sắp xếp nhà cung cấp: "price" (mặc định), "throughput" hoặc "latency" |
| only | Danh sách sên nhà cung cấp được phép (ví dụ: ["anthropic", "google"] ) |
| ignore | Danh sách sên nhà cung cấp cần bỏ qua |
| order | Danh sách các nhà cung cấp sên để thử theo thứ tự |
| require_parameters | Chỉ sử dụng các nhà cung cấp hỗ trợ tất cả các thông số yêu cầu ( true / false ) |
| data_collection | "allow" (mặc định) hoặc "deny" để loại trừ nhà cung cấp lưu trữ dữ liệu |
mẹo
Sử dụng hermes config set để đặt các biến môi trường - nó tự động lưu chúng vào đúng tệp ( .env cho bí mật, config.yaml cho mọi thứ khác).