Chuyển tới nội dung chính

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ể thiết lập 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 | | Hermes_OpenRouter_CACHE | Bật bộ nhớ đệm phản hồi OpenRouter ( `1

/ `true

/ `yes

/ `on

). Ghi đè OpenRouter.response_cache trong config.yaml. Xem Response Caching. | | Hermes_OpenRouter_CACHE_TTL | Bộ nhớ đệm TTL sau vài giây (1-86400). Ghi đè OpenRouter.response_cache_ttl trong config.yaml. | | NOUS_BASE_URL | Ghi đè URL cơ sở của Nous Portal (hiếm khi cần thiết; chỉ phát triển/thử nghiệm) | | NOUS_INFERENCE_BASE_URL | Ghi đè trực tiếp điểm cuối suy luận Nous | | AI_GATEWAY_API_KEY | Khóa API Vercel AI Gateway (ai-gateway.vercel.sh) | | AI_GATEWAY_BASE_URL | Ghi đè URL cơ sở của Cổng AI (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 GitHub_pat_* chi tiết; 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

) | | Kimi_CN_API_KEY | Khóa API Kimi / Moonshot Trung Quốc (Moonshot.cn) | | ARCEEAI_API_KEY | Khóa API Arcee AI (chat.arcee.ai) | | ARCEE_BASE_URL | Ghi đè URL cơ sở Arcee (mặc định: `https://API.arcee.ai/API/v1

) | | GMI_API_KEY | Khóa API đám mây GMI (gmicloud.ai) | | GMI_BASE_URL | Ghi đè URL cơ sở đám mây GMI (mặc định: `https://API.gmi-serving.com/v1

) | | MiniMax_API_KEY | Khóa API MiniMax - điểm cuối toàn cầu (MiniMax.io). ** MiniMax-OAuth không được sử dụng** (đường dẫn OAuth sử dụng thông tin đăng nhập trình duyệt thay thế). | | MiniMax_BASE_URL | Ghi đè URL cơ sở MiniMax (mặc định: `https://API.MiniMax.io/Anthropic

  • Hermes sử dụng điểm cuối tương thích với Thông điệp Anthropic của MiniMax). **Không được sử dụng bởi `MiniMax-OAuth

. | | MiniMax_CN_API_KEY | Khóa API MiniMax — Điểm cuối Trung Quốc (MiniMaxi.com). ** MiniMax-OAuth không được sử dụng (đường dẫn OAuth sử dụng thông tin đăng nhập trình duyệt thay thế). | | MiniMax_CN_BASE_URL | Ghi đè URL cơ sở MiniMax China (mặc định: `https://API.MiniMaxi.com/Anthropic

). **Không được sử dụng bởi `MiniMax-OAuth

**. | | 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

) | | XIAOMI_API_KEY | Khóa API Xiaomi MiMo (platform.xiaomimimo.com) | | XIAOMI_BASE_URL | Ghi đè URL cơ sở Xiaomi MiMo (mặc định: `https://API.xiaomimimo.com/v1

) | | TOKENHUB_API_KEY | Khóa API Tencent TokenHub (tokenhub.tencentmaas.com) | | TOKENHUB_BASE_URL | Ghi đè URL cơ sở Tencent TokenHub (mặc định: `https://tokenhub.tencentmaas.com/v1

) | | AZURE_FOUNDRY_API_KEY | Khóa API Microsoft Foundry / Azure OpenAI (ai.azure.com). Không cần thiết khi model.auth_mode: entra_id | | AZURE_FOUNDRY_BASE_URL | URL điểm cuối của Microsoft Foundry (ví dụ: https://<resource>.OpenAI.azure.com/OpenAI/v1 cho kiểu OpenAI hoặc https://<resource>.services.ai.azure.com/Anthropic cho kiểu Anthropic) | | AZURE_Anthropic_KEY | Khóa API Azure Anthropic cho `provider: Anthropic

base_url trỏ vào triển khai Claude của Microsoft Foundry (thay thế cho Anthropic_API_KEY khi cả Anthropic và Azure Anthropic đều được định cấu hình) | | AZURE_TENANT_ID | ID đối tượng thuê ID (luồng dịch vụ chính; được azure-identity vinh danh khi `model.auth_mode: entra_id

) | | AZURE_CLIENT_ID | ID ứng dụng khách Entra ID (chính dịch vụ, nhận dạng khối lượng công việc hoặc nhận dạng được quản lý do người dùng chỉ định) ||

AZURE_CLIENT_SECRET | Bí mật chính của dịch vụ được EnvironmentCredential sử dụng | | AZURE_CLIENT_CERTIFICATE_PATH | Chứng chỉ chính dịch vụ (thay thế cho AZURE_CLIENT_SECRET

) | | AZURE_FEDERATED_TOKEN_FILE | Đường dẫn tệp mã thông báo được liên kết cho các luồng Nhận dạng khối lượng công việc AKS / OIDC | | AZURE_AUTHORITY_HOST | Ghi đè quyền có chủ quyền trên đám mây (ví dụ: https://login.Microsoftonline.us dành cho Chính phủ Azure). Xem Azure Foundry guide | | IDENTITY_ENDPOINT / MSI_ENDPOINT | Điểm cuối nhận dạng được quản lý cho Dịch vụ ứng dụng, Chức năng và Ứng dụng vùng chứa; Thay vào đó, máy ảo thường sử dụng IMDS và không đặt các | | 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 | | Hermes_Gemini_CLIENT_ID | ID ứng dụng khách OAuth để đăng nhập Google-Gemini-CLI PKCE (tùy chọn; mặc định là ứng dụng khách Gemini-CLI công khai của Google) | | Hermes_Gemini_CLIENT_SECRET | Bí mật ứng dụng khách OAuth cho Google-Gemini-CLI (tùy chọn) | | Hermes_Gemini_PROJECT_ID | ID dự án GCP cho các cấp độ Gemini trả phí (cung cấp tự động cấp độ miễn phí) | | 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 Qwen Cloud (Alibaba DashScope) cho các mẫu Qwen (modelstudio.console.alibabacloud.com) | | DASHSCOPE_BASE_URL | URL cơ sở DashScope tùy chỉnh (mặc định: `https://dashscope-intl.aliyuncs.com/compatible-mode/v1

; sử dụng https://dashscope.aliyuncs.com/compatible-mode/v1 cho khu vực Trung Quốc đại lục) | | 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 | | NOVITA_API_KEY | Khóa API NovitaAI - Đám mây gốc AI cho API mô hình, Hộp cát tác nhân và Đám mây GPU (novita.ai/settings/key-management) | | NOVITA_BASE_URL | Ghi đè URL cơ sở NovitaAI (mặc định: `https://API.novita.ai/OpenAI/v1

) | | NVIDIA_API_KEY | Khóa API NVIDIA NIM - Nemotron và các mô hình mở (build.nvidia.com) | | NVIDIA_BASE_URL | Ghi đè URL cơ sở NVIDIA (mặc định: `https://integrate.API.nvidia.com/v1

; được đặt thành http://localhost:8000/v1 cho điểm cuối NIM cục bộ) | | STEPFUN_API_KEY | Khóa API StepFun - Mô hình chuỗi bước (platform.stepfun.com) | | STEPFUN_BASE_URL | Ghi đè URL cơ sở StepFun (mặc định: `https://API.stepfun.com/v1

) | | OLlama_API_KEY | Khóa API đám mây OLlama - danh mục OLlama được quản lý không có GPU cục bộ (OLlama.com/settings/keys) | | OLlama_BASE_URL | Ghi đè URL cơ sở của Đám mây OLlama (mặc định: `https://OLlama.com/v1

) | | XAI_API_KEY | Khóa API xAI (Grok) để trò chuyện + TTS + tìm kiếm trên web (console.x.ai) | | XAI_BASE_URL | Ghi đè URL cơ sở xAI (mặc định: `https://API.x.ai/v1

) | | Mistral_API_KEY | Khóa API Mistral cho Voxtral TTS và Voxtral STT (console.Mistral.ai) | | AWS_REGION | Khu vực AWS dành cho suy luận Bedrock (ví dụ: `us-east-1

, `eu-central-1

). Đọc bởi boto3. | | AWS_PROFILE | Hồ sơ được đặt tên AWS để xác thực Bedrock (đọc

~/.aws/credentials

). Không đặt để sử dụng chuỗi thông tin xác thực boto3 mặc định. | | BEDROCK_BASE_URL | Ghi đè URL cơ sở thời gian chạy Bedrock (mặc định: `https://bedrock-runtime.us-east-1.amazonaws.com

; thường không đặt và sử dụng AWS_REGION thay thế) | | Hermes_QWEN_BASE_URL | Ghi đè URL cơ sở của Cổng thông tin Qwen (mặc định: `https://portal.qwen.ai/v1

) | | 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 | Ghi đè tên mô hình ở cấp quy trình (được sử dụng bởi bộ lập lịch cron; thích config.yaml để sử dụng bình thường) | | 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 whisper cục bộ được phát hiện tự động (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 | | Hermes_GIT_BASH_PATH | Chỉ dành cho Windows. Ghi đè khám phá bash.exe cho công cụ đầu cuối. Trỏ vào bất kỳ bash nào - cài đặt Git-for-Windows đầy đủ, bash WSL thông qua liên kết tượng trưng, ​​MSYS2, Cygwin. Trình cài đặt sẽ tự động đặt cài đặt này cho PortableGit mà nó đã cung cấp. Xem Windows (Native) Guide | | Hermes_DISABLE_Windows_UTF8 | Chỉ dành cho Windows. Đặt thành 1 để tắt miếng đệm stdio UTF-8 ( `configure_Windows_stdio()

) và quay lại trang mã ngôn ngữ của bảng điều khiển. Hữu ích cho việc chia đôi các lỗi mã hóa; hiếm khi cài đặt đúng trong hoạt động bình thường | | Hermes_KANBAN_HOME | Ghi đè gốc Hermes được chia sẻ neo bảng kanban (db + không gian làm việc + nhật ký công nhân). Quay trở lại get_default_Hermes_root() (mẹ của bất kỳ hồ sơ đang hoạt động nào). Hữu ích cho các thử nghiệm và triển khai bất thường | | Hermes_KANBAN_BOARD | Ghim bảng Kanban đang hoạt động cho quá trình này. Được ưu tiên hơn

~/.Hermes/kanban/current

; người điều phối đưa phần này vào env quy trình con của công nhân để công nhân thực sự không thể nhìn thấy các nhiệm vụ trên các bảng khác. Mặc định là `default

. Xác thực sên: chữ và số viết thường + dấu gạch ngang + dấu gạch dưới, 1-64 ký tự | | Hermes_KANBAN_DB | Ghim trực tiếp đường dẫn tệp cơ sở dữ liệu kanban (mức độ ưu tiên cao nhất; đánh bại Hermes_KANBAN_BOARD và `Hermes_KANBAN_HOME

). Người điều phối đưa phần này vào env quy trình con của công nhân để các công nhân hồ sơ hội tụ trên bảng của người điều phối | | Hermes_KANBAN_WORKSPACES_ROOT | Ghim trực tiếp gốc không gian làm việc Kanban (ưu tiên cao nhất cho không gian làm việc; đánh bại `Hermes_KANBAN_HOME

). Người điều phối đưa cái này vào worker subprocess env | | Hermes_KANBAN_DISPATCH_IN_GATEWAY | Ghi đè thời gian chạy cho `kanban.dispatch_in_gateway

. Đặt thành `0

, `false

, no hoặc off để ngăn cổng khởi động bộ điều phối Kanban được nhúng; bất kỳ giá trị không trống nào khác đều cho phép nó. Hữu ích khi một quy trình điều phối riêng biệt sở hữu bảng. |## 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. OAuth chống lại Anthropic yêu cầu gói Claude Max với các khoản tín dụng sử dụng bổ sung đã mua — Hermes định tuyến dưới dạng Mã Claude, chỉ rút từ các khoản tín dụng bổ sung/vượt mức của gói Max chứ không phải khoản trợ cấp Max cơ bản và không hoạt động trên Claude Pro. Nếu không có Max + tín dụng bổ sung, thay vào đó hãy sử dụng khóa API. 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 Max.

BiếnMô tả
`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) | | SEARXNG_URL | URL phiên bản SearXNG để tìm kiếm trên web tự lưu trữ miễn phí — không cần khóa API (searxng.GitHub.io) | | TAVILY_BASE_URL | Ghi đè điểm cuối API Tavily. Hữu ích cho các proxy của công ty và các chương trình phụ trợ tìm kiếm tương thích với Tavily tự lưu trữ. Mẫu tương tự như `GROQ_BASE_URL

. | | 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

) | | CAMOFOX_USER_ID | ID người dùng Camofox được quản lý bên ngoài tùy chọn cho các phiên hiển thị được chia sẻ | | CAMOFOX_SESSION_KEY | Khóa phiên Camofox tùy chọn được sử dụng khi tạo tab cho CAMOFOX_USER_ID | | CAMOFOX_ADOPT_EXISTING_TAB | Đặt thành true để sử dụng lại tab Camofox hiện có trước khi tạo tab mới | | 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 | | AGENT_BROWSER_ARGS | Cờ khởi chạy Chrome bổ sung (được phân tách bằng dấu phẩy hoặc dòng mới). Hermes tự động chèn

--no-sandbox,--disable-dev-shm-usage khi chạy bằng root hoặc trên không gian tên người dùng không có đặc quyền bị hạn chế bởi AppArmor (Ubuntu 23.10+, DGX Spark, nhiều hình ảnh vùng chứa); chỉ đặt thủ công này để ghi đè hoặc thêm các cờ khác. | | FAL_KEY | Tạo hình ảnh ([fal.ai](https://fal.ai/)) | | GROQ_API_KEY | Khóa API Groq Whisper STT ([groq.com](https://groq.com/)) | | ELEVENLABS_API_KEY | Giọng nói TTS cao cấp của ElevenLabs ([elevenlabs.io](https://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 | Mô hình hóa người dùng nhiều 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ộ | | HINDSIGHT_TIMEOUT | Thời gian chờ tính bằng giây cho lệnh gọi API của nhà cung cấp bộ nhớ Hindsight (mặc định: `60

). Hãy khắc phục điều này nếu phiên bản Hindsight của bạn phản hồi chậm trong

/sync hoặc on_session_switch và bạn thấy thời gian chờ trong errors.log

. | | 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) | | DAYTONA_API_KEY | Hộp cát đám mây Daytona (daytona.io) | | VERCEL_TOKEN | Mã thông báo truy cập Vercel Sandbox (vercel.com) | | VERCEL_PROJECT_ID | ID dự án Vercel (bắt buộc với `VERCEL_TOKEN

) | | VERCEL_TEAM_ID | ID nhóm Vercel (bắt buộc với `VERCEL_TOKEN

) | | VERCEL_OIDC_TOKEN | Mã thông báo OIDC tồn tại trong thời gian ngắn của Vercel (thay thế chỉ dành cho phát triển) |

Khả năng quan sát Langfuse

Các biến môi trường cho plugin XPROTECTX242XPROTECTX đi kèm. Đặt những thứ này trong

~/.Hermes/.env

. Plugin cũng phải được bật ( Hermes plugins enable observability/Langfuse hoặc chọn hộp trong `Hermes plugins

) trước khi bất kỳ plugin nào trong số này có hiệu lực.| Biến | Mô tả | |----------|-------------| | Hermes_Langfuse_PUBLIC_KEY | Khóa công khai của dự án Langfuse ( `pk-lf-...

). Yêu cầu. | | Hermes_Langfuse_SECRET_KEY | Khóa bí mật của dự án Langfuse ( `sk-lf-...

). Yêu cầu. | | Hermes_Langfuse_BASE_URL | URL máy chủ Langfuse (mặc định: `https://cloud.Langfuse.com

). Đặt để tự lưu trữ. | | Hermes_Langfuse_ENV | Thẻ môi trường trên dấu vết ( `production

, `staging

, …) | | Hermes_Langfuse_RELEASE | Thẻ phát hành/phiên bản trên dấu vết | | Hermes_Langfuse_SAMPLE_RATE | Tốc độ lấy mẫu SDK 0,0–1,0 (mặc định: `1.0

) | | Hermes_Langfuse_MAX_CHARS | Cắt ngắn trên mỗi trường cho các tải trọng được tuần tự hóa (mặc định: `12000

) | | Hermes_Langfuse_DEBUG | true cho phép ghi nhật ký plugin chi tiết vào agent.log | | Langfuse_PUBLIC_KEY / Langfuse_SECRET_KEY / Langfuse_BASE_URL | Tên SDK Langfuse tiêu chuẩn. Được chấp nhận làm phương án dự phòng khi giá trị tương đương Hermes_Langfuse_* chưa được đặt. |

Cổng công cụ Nous

Các biến này định cấu hình Tool Gateway cho người đăng ký Nous trả phí hoặc triển khai cổng tự lưu trữ. Hầu hết người dùng không cần thiết lập những cài đặt này — cổng được định cấu hình tự động thông qua Hermes model hoặc `Hermes tools

.

BiếnMô tả
`TOOL_GATEWAY_DOMAIN
`Miền cơ sở cho định tuyến Cổng công cụ (mặc định:
`NousResearch.com

) | | TOOL_GATEWAY_SCHEME | Lược đồ HTTP hoặc HTTPS cho URL cổng (mặc định: `https

) | | TOOL_GATEWAY_USER_TOKEN | Mã thông báo xác thực cho Cổng công cụ (thường được tự động điền từ Nous auth) | | FIRECRAWL_GATEWAY_URL | Ghi đè URL dành riêng cho điểm cuối cổng Firecrawl |

Phần cuối của terminal

BiếnMô tả
`TERMINAL_ENV
`Phần cuối:
`local

, `Docker

, `SSH

, `singularity

, `modal

, `daytona

, vercel_sandbox | | Hermes_Docker_BINARY | Ghi đè hệ nhị phân vùng chứa Hermes thành (ví dụ: `podman

,

/usr/local/bin/Docker

). Khi không được đặt, Hermes tự động phát hiện Docker hoặc podman trên `PATH

. Cần thiết khi cả hai đã được cài đặt và bạn muốn cài đặt không mặc định hoặc khi tệp nhị phân nằm ngoài `PATH

. | | 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 sẽ đượ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 bất kỳ kỹ năng nào khai báo. | | TERMINAL_Docker_VOLUMES | Các ổ đĩ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_VERCEL_RUNTIME | Thời gian chạy Vercel Sandbox (node24

, `node22

, `Python3.13

) | | 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 các phiên cuối (chỉ cổng/cron; CLI sử dụng thư mục khởi chạy) | | 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 dẹp 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ếnMô 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 vùng chứa qua các phiên (mặc định: `true

) | | TERMINAL_SANDBOX_DIR | Thư mục máy chủ cho không gian làm việc và lớp phủ (mặc định:

~/.Hermes/sandboxes/

) |

Vỏ liên tục

BiếnMô 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| Biến | Mô tả |

|----------|-------------| | Telegram_BOT_TOKEN | Mã thông báo bot Telegram (từ @BotFather) | | Telegram_ALLOWED_USERS | ID người dùng được phân tách bằng dấu phẩy được phép sử dụng bot (áp dụng cho DM, nhóm và diễn đàn) | | Telegram_GROUP_ALLOWED_USERS | ID người dùng người gửi được phân tách bằng dấu phẩy chỉ được ủy quyền trong nhóm/diễn đàn (KHÔNG cấp quyền truy cập DM). Các giá trị có hình ID trò chuyện (bắt đầu bằng

) vẫn được coi là ID trò chuyện để tương thích ngược với cấu hình trước #17686, kèm theo cảnh báo không dùng nữa. | | Telegram_GROUP_ALLOWED_CHATS | ID trò chuyện nhóm/diễn đàn được phân tách bằng dấu phẩy; bất kỳ thành viên nào được ủy quyền | | Telegram_HOME_CHANNEL | Kênh/trò chuyện Telegram mặc định để phân phối cron | | Telegram_HOME_CHANNEL_NAME | Tên hiển thị cho kênh chủ Telegram | | Telegram_CRON_THREAD_ID | ID chủ đề diễn đàn để nhận giao hàng định kỳ; ghi đè Telegram_HOME_CHANNEL_THREAD_ID chỉ dành cho cron. Sử dụng ở chế độ chủ đề để trả lời tin nhắn cron sẽ mở một phiên mới thay vì nhấn vào sảnh hệ thống (#24409). | | Telegram_WEBHOOK_URL | URL HTTPS công khai cho chế độ webhook (bật webhook thay vì bỏ phiếu) | | Telegram_WEBHOOK_PORT | Cổng nghe cục bộ cho máy chủ webhook (mặc định: `8443

) | | Telegram_WEBHOOK_SECRET | Mã thông báo bí mật Telegram lặp lại trong mỗi bản cập nhật để xác minh. Bắt buộc bất cứ khi nào Telegram_WEBHOOK_URL được đặt — cổng từ chối khởi động nếu không có nó (GHSA-3vpc-7q5r-276h). Tạo bằng `openSSL rand -hex 32

. | | Telegram_REACTIONS | Bật phản ứng biểu tượng cảm xúc trên tin nhắn trong quá trình xử lý (mặc định: `false

) | | Telegram_REQUIRE_MENTION | Yêu cầu kích hoạt rõ ràng trước khi phản hồi trong nhóm Telegram. Tương đương với Telegram.require_mention trong `config.yaml

. | | Telegram_MENTION_PATTERNS | Mảng JSON, danh sách được phân tách bằng dòng mới hoặc danh sách các mẫu từ đánh thức biểu thức chính quy được phân tách bằng dấu phẩy được chấp nhận khi tính năng kiểm soát đề cập của nhóm Telegram được bật. Tương đương với `Telegram.mention_patterns

. | | Telegram_EXCLUSIVE_BOT_MENTIONS | Khi được bật, các đề cập rõ ràng về

@...bot trong nhóm Telegram chỉ định tuyến đến tên người dùng bot được đề cập trước khi chạy dự phòng trả lời hoặc từ đánh thức. Mặc định: true

. Tương đương với `Telegram.exclusive_bot_mentions

. | | Telegram_REPLY_TO_MODE | Hành vi tham chiếu trả lời: `off

, first (mặc định) hoặc `all

. Phù hợp với mẫu Discord. | | Telegram_IGNORED_THREADS | ID chủ đề/chuỗi diễn đàn Telegram được phân tách bằng dấu phẩy trong đó bot không bao giờ phản hồi | | Telegram_PROXY | URL proxy cho kết nối Telegram — ghi đè `HTTPS_PROXY

. Hỗ trợ `http://

, `https://

, socks5:// | | Discord_BOT_TOKEN | Mã thông báo bot discord | | Discord_ALLOWED_USERS | ID người dùng Discord được phân tách bằng dấu phẩy được phép sử dụng bot | | Discord_ALLOWED_ROLES | ID vai trò Discord được phân tách bằng dấu phẩy được phép sử dụng bot (HOẶC với `Discord_ALLOWED_USERS

). Tự động kích hoạt ý định của Thành viên. Hữu ích khi nhóm kiểm duyệt rời bỏ — việc cấp vai trò sẽ tự động được phổ biến. | | Discord_ALLOWED_CHANNELS | ID kênh Discord được phân tách bằng dấu phẩy. Khi được đặt, bot chỉ phản hồi trong các kênh này (cộng với DM nếu được phép). Ghi đè config.yaml `Discord.allowed_channels

. | | Discord_PROXY | URL proxy cho kết nối Discord - ghi đè `HTTPS_PROXY

. Hỗ trợ `http://

, `https://

, socks5:// | | Discord_HOME_CHANNEL | Kênh Discord mặc định để phân phối cron | | Discord_HOME_CHANNEL_NAME | Tên hiển thị cho kênh chính Discord | | Discord_COMMAND_SYNC_POLICY | Chính sách đồng bộ hóa khởi động lệnh gạch chéo discord: safe (khác biệt và đối chiếu), bulk ( tree.sync() cũ) hoặc off | | Discord_REQUIRE_MENTION | Yêu cầu @mention trước khi phản hồi trong các kênh máy chủ | | Discord_FREE_RESPONSE_CHANNELS | ID kênh được phân tách bằng dấu phẩy trong đó không cần đề cập | | Discord_AUTO_THREAD | Tự động phân luồng các câu trả lời dài khi được hỗ trợ | | Discord_ALLOW_ANY_ATTACHMENT | Khi `true

, chấp nhận tệp đính kèm thuộc bất kỳ loại tệp nào (không chỉ danh sách cho phép PDF/văn bản/zip/office tích hợp sẵn). Các loại không xác định được lưu vào bộ nhớ đệm và hiển thị cho tác nhân dưới dạng đường dẫn cục bộ để tác nhân có thể kiểm tra chúng thông qua terminal / read_file / `ffprobe

. false mặc định. | | Discord_MAX_ATTACHMENT_BYTES | Số byte tối đa cho mỗi tệp đính kèm mà cổng sẽ lưu vào bộ đệm. 33554432 mặc định (32 MiB). Đặt thành 0 để không có giới hạn (các tệp đính kèm được giữ trong bộ nhớ khi được ghi). || Discord_REACTIONS | Bật phản ứng biểu tượng cảm xúc trên tin nhắn trong khi xử lý (mặc định: `true

) | | Discord_IGNORED_CHANNELS | ID kênh được phân tách bằng dấu phẩy nơi bot không bao giờ phản hồi | | Discord_NO_THREAD_CHANNELS | ID kênh được phân tách bằng dấu phẩy trong đó bot phản hồi mà không tự động phân luồng | | Discord_REPLY_TO_MODE | Hành vi tham chiếu trả lời: `off

, first (mặc định) hoặc all | | Discord_ALLOW_MENTION_EVERYONE | Cho phép bot ping

@everyone

/

@here (mặc định: false

). Xem Mention Control. | | Discord_ALLOW_MENTION_ROLES | Cho phép bot ping đề cập

@role (mặc định: false

). | | Discord_ALLOW_MENTION_USERS | Cho phép bot ping các đề cập

@user riêng lẻ (mặc định: true

). | | Discord_ALLOW_MENTION_REPLIED_USER | Ping tác giả khi trả lời tin nhắn của họ (mặc định: `true

). | | Slack_BOT_TOKEN | Mã thông báo bot Slack ( `xoxb-...

) | | Slack_APP_TOKEN | Mã thông báo cấp ứng dụng Slack ( `xapp-...

, bắt buộc đối với Chế độ ổ cắm) | | Slack_ALLOWED_USERS | ID người dùng Slack được phân tách bằng dấu phẩy | | Slack_HOME_CHANNEL | Kênh Slack mặc định để phân phối cron | | Slack_HOME_CHANNEL_NAME | Tên hiển thị cho kênh trang chủ Slack | | Google_CHAT_PROJECT_ID | Dự án GCP lưu trữ chủ đề Pub/Sub (quay lại `Google_CLOUD_PROJECT

) | | Google_CHAT_SUBSCRIPTION_NAME | Đường dẫn đăng ký Pub/Sub đầy đủ, projects/\{proj}/subscriptions/\{sub} (bí danh kế thừa: `Google_CHAT_SUBSCRIPTION

) | | Google_CHAT_SERVICE_ACCOUNT_JSON | Đường dẫn đến tài khoản dịch vụ JSON hoặc nội tuyến JSON (quay lại `Google_APPLICATION_CREDENTIALS

) | | Google_CHAT_ALLOWED_USERS | Email người dùng được phân tách bằng dấu phẩy được phép trò chuyện với bot | | Google_CHAT_ALLOW_ALL_USERS | Cho phép bất kỳ người dùng Google Chat nào kích hoạt bot (chỉ dành cho nhà phát triển) | | Google_CHAT_HOME_CHANNEL | Không gian mặc định (ví dụ: `spaces/AAAA...

) để phân phối định kỳ | | Google_CHAT_HOME_CHANNEL_NAME | Tên hiển thị cho không gian nhà Google Chat | | Google_CHAT_MAX_MESSAGES | Thông báo tối đa trong chuyến bay Pub/Sub FlowControl (mặc định: `1

) | | Google_CHAT_MAX_BYTES | Pub/Sub FlowControl byte trong chuyến bay tối đa (mặc định: `16777216

, 16 MiB) | | Google_CHAT_BOOTSTRAP_SPACES | Các ID khoảng trống bổ sung được phân tách bằng dấu phẩy để thăm dò khi khởi động khi giải quyết users/\{id} của chính bot | | Google_CHAT_DEBUG_RAW | Đặt thành bất kỳ giá trị nào để ghi lại các phong bì Pub/Sub đã được xử lý lại ở cấp độ GỠ LỖI (chỉ gỡ lỗi) | | WhatsApp_ENABLED | Kích hoạt cầu WhatsApp ( `true

/ `false

) | | WhatsApp_MODE | bot (số riêng) hoặc self-chat (nhắn tin cho chính bạn) | | WhatsApp_ALLOWED_USERS | Số điện thoại được phân tách bằng dấu phẩy (có mã quốc gia, không có

) hoặc

để cho phép tất cả người gửi | | WhatsApp_ALLOW_ALL_USERS | Cho phép tất cả người gửi WhatsApp không có danh sách cho phép (true

/ `false

) | | WhatsApp_DEBUG | Ghi lại các sự kiện tin nhắn thô trong cầu nối để khắc phục sự cố ( `true

/ `false

) | | Signal_HTTP_URL | Điểm cuối HTTP daemon Signal-CLI (ví dụ `http://127.0.0.1:8080

) | | Signal_ACCOUNT | Số điện thoại bot ở định dạng E.164 | | Signal_ALLOWED_USERS | Số điện thoại hoặc UUID E.164 được phân tách bằng dấu phẩy | | Signal_GROUP_ALLOWED_USERS | ID nhóm được phân tách bằng dấu phẩy hoặc

cho tất cả các nhóm | | Signal_HOME_CHANNEL_NAME | Tên hiển thị kênh chủ Signal | | Signal_IGNORE_STORIES | Bỏ qua các câu chuyện/cập nhật trạng thái của Signal | | Signal_ALLOW_ALL_USERS | Cho phép tất cả người dùng Signal không có danh sách cho phép | | TWILIO_ACCOUNT_SID | SID tài khoản Twilio (được chia sẻ với kỹ năng điện thoại) | | TWILIO_AUTH_TOKEN | Mã thông báo xác thực Twilio (được chia sẻ với kỹ năng điện thoại; cũng được sử dụng để xác thực chữ ký webhook) | | TWILIO_PHONE_NUMBER | Số điện thoại Twilio định dạng E.164 (chia sẻ với kỹ năng điện thoại) | | SMS_WEBHOOK_URL | URL công khai để xác thực chữ ký Twilio - phải khớp với URL webhook trong Bảng điều khiển Twilio (bắt buộc) | | SMS_WEBHOOK_PORT | Cổng nghe Webhook cho SMS gửi đến (mặc định: 8080

) | | SMS_WEBHOOK_HOST | Địa chỉ liên kết Webhook (mặc định: `0.0.0.0

) | | SMS_INSECURE_NO_SIGNATURE | Đặt thành true để tắt xác thực chữ ký Twilio (chỉ dành cho nhà phát triển cục bộ - không dành cho sản xuất) | | SMS_ALLOWED_USERS | Số điện thoại E.164 phân cách bằng dấu phẩy được phép trò chuyện | | SMS_ALLOW_ALL_USERS | Cho phép tất cả người gửi SMS không có danh sách cho phép ||

SMS_HOME_CHANNEL | Số điện thoại gửi thông báo/cron job | | SMS_HOME_CHANNEL_NAME | Tên hiển thị cho kênh SMS home | | EMAIL_ADDRESS | Địa chỉ email của bộ điều hợp cổng Email | | EMAIL_PASSWORD | Mật khẩu hoặc mật khẩu ứng dụng cho tài khoản email | | EMAIL_IMAP_HOST | Tên máy chủ IMAP cho bộ điều hợp email | | EMAIL_IMAP_PORT | Cổng IMAP | | EMAIL_SMTP_HOST | Tên máy chủ SMTP cho bộ điều hợp email | | EMAIL_SMTP_PORT | Cổng SMTP | | EMAIL_ALLOWED_USERS | Địa chỉ email được phân tách bằng dấu phẩy được phép nhắn tin cho bot | | EMAIL_HOME_ADDRESS | Người nhận mặc định để gửi email chủ động | | EMAIL_HOME_ADDRESS_NAME | Tên hiển thị cho mục tiêu email home | | EMAIL_POLL_INTERVAL | Khoảng thời gian bỏ phiếu qua email tính bằng giây | | EMAIL_ALLOW_ALL_USERS | Cho phép tất cả người gửi email đến | | DingTalk_CLIENT_ID | DingTalk bot AppKey từ cổng thông tin dành cho nhà phát triển ([open.DingTalk.com](https://open.DingTalk.com)) | | DingTalk_CLIENT_SECRET | DingTalk bot AppSecret từ cổng thông tin dành cho nhà phát triển | | DingTalk_ALLOWED_USERS | ID người dùng DingTalk được phân tách bằng dấu phẩy được phép nhắn tin cho bot | | Feishu_APP_ID | ID ứng dụng bot Feishu/Lark từ [open.Feishu.cn](https://open.Feishu.cn/) | | Feishu_APP_SECRET | Bí mật ứng dụng Feishu/Lark bot | | Feishu_DOMAIN | Feishu (Trung Quốc) hoặc lark (quốc tế). Mặc định: Feishu | | Feishu_CONNECTION_MODE | websocket (được khuyến nghị) hoặc webhook

. Mặc định: websocket | | Feishu_ENCRYPT_KEY | Khóa mã hóa tùy chọn cho chế độ webhook | | Feishu_VERIFICATION_TOKEN | Mã thông báo xác minh tùy chọn cho chế độ webhook | | Feishu_ALLOWED_USERS | ID người dùng Feishu được phân tách bằng dấu phẩy được phép nhắn tin cho bot | | Feishu_ALLOW_BOTS | none (mặc định) / mentions / `all

  • chấp nhận tin nhắn gửi đến từ các bot khác. Xem bot-to-bot messaging | | Feishu_REQUIRE_MENTION | true (mặc định) / false — liệu các tin nhắn trong nhóm có phải @đề cập đến bot hay không. Ghi đè mỗi cuộc trò chuyện qua `group_rules.<chat_id>.require_mention

. | | Feishu_HOME_CHANNEL | ID trò chuyện Feishu để gửi thông báo và gửi cron | | WeCom_BOT_ID | ID Bot AI của WeCom từ bảng điều khiển dành cho quản trị viên | | WeCom_SECRET | Bí mật WeCom AI Bot | | WeCom_WEBSOCKET_URL | URL WebSocket tùy chỉnh (mặc định: `wss://openws.work.weixin.qq.com

) | | WeCom_ALLOWED_USERS | ID người dùng WeCom được phân tách bằng dấu phẩy được phép nhắn tin cho bot | | WeCom_HOME_CHANNEL | ID trò chuyện WeCom để phân phối và thông báo định kỳ | | WeCom_CALLBACK_CORP_ID | ID tập đoàn doanh nghiệp WeCom cho ứng dụng tự xây dựng gọi lại | | WeCom_CALLBACK_CORP_SECRET | Bí mật tập đoàn cho ứng dụng tự xây dựng | | WeCom_CALLBACK_AGENT_ID | ID tác nhân của ứng dụng tự xây dựng | | WeCom_CALLBACK_TOKEN | Mã thông báo xác minh gọi lại | | WeCom_CALLBACK_ENCODING_AES_KEY | Khóa AES để mã hóa gọi lại | | WeCom_CALLBACK_HOST | Địa chỉ liên kết máy chủ gọi lại (mặc định: `0.0.0.0

) | | WeCom_CALLBACK_PORT | Cổng máy chủ gọi lại (mặc định: `8645

) | | WeCom_CALLBACK_ALLOWED_USERS | ID người dùng được phân tách bằng dấu phẩy cho danh sách cho phép | | WeCom_CALLBACK_ALLOW_ALL_USERS | Đặt true để cho phép tất cả người dùng không có danh sách cho phép | | WEIXIN_ACCOUNT_ID | ID tài khoản Weixin có được thông qua đăng nhập QR thông qua iLink Bot API | | WEIXIN_TOKEN | Mã thông báo xác thực Weixin thu được thông qua đăng nhập QR thông qua API iLink Bot | | WEIXIN_BASE_URL | Ghi đè URL cơ sở API Weixin iLink Bot (mặc định: `https://ilinkai.weixin.qq.com

) | | WEIXIN_CDN_BASE_URL | Ghi đè URL cơ sở Weixin CDN cho phương tiện (mặc định: `https://novac2c.cdn.weixin.qq.com/c2c

) | | WEIXIN_DM_POLICY | Chính sách tin nhắn trực tiếp: `open

, `allowlist

, `pairing

, disabled (mặc định: `open

) | | WEIXIN_GROUP_POLICY | Chính sách tin nhắn nhóm: `open

, `allowlist

, disabled (mặc định: `disabled

) | | WEIXIN_ALLOWED_USERS | ID người dùng Weixin được phân tách bằng dấu phẩy được phép DM bot | | WEIXIN_GROUP_ALLOWED_USERS | Weixin được phân tách bằng dấu phẩy ID trò chuyện nhóm (không phải ID người dùng thành viên) được phép tương tác với bot. Tên biến là kế thừa — nó yêu cầu ID nhóm. Chỉ có hiệu lực khi iLink thực sự cung cấp các sự kiện nhóm; Nhận dạng bot iLink đăng nhập QR (

...@im.bot

) thường không nhận được tin nhắn nhóm WeChat thông thường. | | WEIXIN_HOME_CHANNEL | ID trò chuyện Weixin để gửi thông báo và gửi cron | | WEIXIN_HOME_CHANNEL_NAME | Tên hiển thị cho kênh chủ Weixin ||

WEIXIN_ALLOW_ALL_USERS | Cho phép tất cả người dùng Weixin không có danh sách cho phép (true

/ `false

) | | BlueBubbles_SERVER_URL | URL máy chủ BlueBubbles (ví dụ: `http://192.168.1.10:1234

) | | BlueBubbles_PASSWORD | Mật khẩu máy chủ BlueBubbles | | BlueBubbles_WEBHOOK_HOST | Địa chỉ liên kết trình nghe Webhook (mặc định: `127.0.0.1

) | | BlueBubbles_WEBHOOK_PORT | Cổng trình nghe Webhook (mặc định: `8645

) | | BlueBubbles_HOME_CHANNEL | Điện thoại/email để gửi cron/thông báo | | BlueBubbles_ALLOWED_USERS | Người dùng được ủy quyền được phân tách bằng dấu phẩy | | BlueBubbles_ALLOW_ALL_USERS | Cho phép tất cả người dùng ( `true

/ `false

) | | QQ_APP_ID | ID ứng dụng QQ Bot từ q.qq.com | | QQ_CLIENT_SECRET | Bí mật ứng dụng QQ Bot từ q.qq.com | | QQ_STT_API_KEY | Khóa API cho nhà cung cấp dự phòng STT bên ngoài (tùy chọn, được sử dụng khi ASR tích hợp QQ không trả về văn bản) | | QQ_STT_BASE_URL | URL cơ sở cho nhà cung cấp STT bên ngoài (tùy chọn) | | QQ_STT_MODEL | Tên mẫu cho nhà cung cấp STT bên ngoài (tùy chọn) | | QQ_ALLOWED_USERS | OpenID của người dùng QQ được phân tách bằng dấu phẩy được phép nhắn tin cho bot | | QQ_GROUP_ALLOWED_USERS | ID nhóm QQ được phân tách bằng dấu phẩy để truy cập tin nhắn @ nhóm | | QQ_ALLOW_ALL_USERS | Cho phép tất cả người dùng ( `true

/ `false

, ghi đè `QQ_ALLOWED_USERS

) | | QQBOT_HOME_CHANNEL | OpenID của người dùng/nhóm QQ để phân phối và thông báo cron | | QQBOT_HOME_CHANNEL_NAME | Tên hiển thị cho kênh chủ QQ | | QQ_PORTAL_HOST | Ghi đè máy chủ cổng thông tin QQ (đặt thành sandbox.q.qq.com để định tuyến qua cổng hộp cát; mặc định: `q.qq.com

). | | Mattermost_URL | URL máy chủ quan trọng nhất (ví dụ: `https://mm.example.com

) | | Mattermost_TOKEN | Mã thông báo bot hoặc mã thông báo truy cập cá nhân cho Matter Extreme | | Mattermost_ALLOWED_USERS | ID người dùng quan trọng nhất được phân tách bằng dấu phẩy được phép nhắn tin cho bot | | Mattermost_HOME_CHANNEL | ID kênh để gửi tin nhắn chủ động (cron, thông báo) | | Mattermost_REQUIRE_MENTION | Yêu cầu

@mention trong các kênh (mặc định: true

). Đặt thành false để trả lời tất cả tin nhắn. | | Mattermost_FREE_RESPONSE_CHANNELS | ID kênh được phân tách bằng dấu phẩy trong đó bot phản hồi mà không có

@mention | | Mattermost_REPLY_MODE | Kiểu trả lời: thread (trả lời theo chuỗi) hoặc off (tin nhắn phẳng, mặc định) | | Matrix_HOMESERVER | URL máy chủ gia đình ma trận (ví dụ: https://Matrix.org

) | | Matrix_ACCESS_TOKEN | Mã thông báo truy cập ma trận để xác thực bot | | Matrix_USER_ID | ID người dùng ma trận (ví dụ:

@Hermes:Matrix.org

) - bắt buộc để đăng nhập bằng mật khẩu, tùy chọn với mã thông báo truy cập | | Matrix_PASSWORD | Mật khẩu ma trận (thay thế cho mã thông báo truy cập) | | Matrix_ALLOWED_USERS | ID người dùng Ma trận được phân tách bằng dấu phẩy được phép nhắn tin cho bot (ví dụ:

@alice:Matrix.org

) | | Matrix_HOME_ROOM | ID phòng để gửi tin nhắn chủ động (ví dụ

!abc123:Matrix.org

) | | Matrix_ENCRYPTION | Bật mã hóa đầu cuối ( `true

/ `false

, mặc định: `false

) | | Matrix_DEVICE_ID | ID thiết bị Ma trận ổn định để duy trì tính bền vững của E2EE khi khởi động lại (ví dụ: `Hermes_BOT

). Nếu không có điều này, các khóa E2EE sẽ xoay vòng mỗi lần khởi động và giải mã phòng lịch sử. | | Matrix_REACTIONS | Bật phản ứng biểu tượng cảm xúc trong vòng đời xử lý trên tin nhắn gửi đến (mặc định: `true

). Đặt thành false để tắt. | | Matrix_REQUIRE_MENTION | Yêu cầu

@mention trong phòng (mặc định: true

). Đặt thành false để trả lời tất cả tin nhắn. | | Matrix_FREE_RESPONSE_ROOMS | ID phòng được phân tách bằng dấu phẩy trong đó bot phản hồi mà không có

@mention | | Matrix_AUTO_THREAD | Tự động tạo chủ đề cho tin nhắn phòng (mặc định: true

) | | Matrix_DM_MENTION_THREADS | Tạo chủ đề khi bot là

@mentioned trong DM (mặc định: false

) | | Matrix_RECOVERY_KEY | Khóa khôi phục để xác minh ký chéo sau khi xoay khóa thiết bị. Được khuyến nghị cho các thiết lập E2EE có bật ký chéo. | | HASS_TOKEN | Home Assistant Mã thông báo truy cập tồn tại lâu dài (cho phép nền tảng HA + công cụ) | | HASS_URL | URL Trợ lý Trang chủ (mặc định: `http://homeassistant.local:8123

) | | WEBHOOK_ENABLED | Kích hoạt bộ điều hợp nền tảng webhook ( `true

/ `false

) | | WEBHOOK_PORT | Cổng máy chủ HTTP để nhận webhook (mặc định: `8644

) || WEBHOOK_SECRET | Bí mật HMAC toàn cầu để xác thực chữ ký webhook (được sử dụng làm dự phòng khi các tuyến không chỉ định riêng) | | API_SERVER_ENABLED | Kích hoạt máy chủ API tương thích OpenAI ( `true

/ `false

). Chạy cùng với các nền tảng khác. | | API_SERVER_KEY | Mã thông báo mang để xác thực máy chủ API. Được thực thi đối với ràng buộc không lặp lại. | | API_SERVER_CORS_ORIGINS | Nguồn gốc trình duyệt được phân tách bằng dấu phẩy được phép gọi trực tiếp máy chủ API (ví dụ `http://localhost:3000

). Mặc định: bị vô hiệu hóa. | | API_SERVER_PORT | Cổng dành cho máy chủ API (mặc định: `8642

) | | API_SERVER_HOST | Địa chỉ máy chủ/liên kết cho máy chủ API (mặc định: `127.0.0.1

). Sử dụng 0.0.0.0 để truy cập mạng — yêu cầu API_SERVER_KEY và danh sách cho phép API_SERVER_CORS_ORIGINS hẹp. | | API_SERVER_MODEL_NAME | Tên model được quảng cáo trên

/v1/models

. Mặc định là tên hồ sơ (hoặc Hermes-agent cho hồ sơ mặc định). Hữu ích cho các thiết lập nhiều người dùng trong đó các giao diện người dùng như Open WebUI cần tên mô hình riêng biệt cho mỗi kết nối. | | GATEWAY_PROXY_URL | URL của máy chủ API Hermes từ xa để chuyển tiếp tin nhắn tới (proxy mode). Khi được đặt, cổng chỉ xử lý I/O nền tảng — tất cả công việc của tổng đài viên sẽ được ủy quyền cho máy chủ từ xa. Cũng có thể định cấu hình thông qua gateway.proxy_url trong `config.yaml

. | | GATEWAY_PROXY_KEY | Mã thông báo mang để xác thực với máy chủ API từ xa ở chế độ proxy. Phải khớp API_SERVER_KEY trên máy chủ từ xa. | | MESSAGING_CWD | Thư mục làm việc cho các lệnh đầu cuối trong chế độ nhắn tin (mặc định:

~

) | | GATEWAY_ALLOWED_USERS | ID người dùng được phân tách bằng dấu phẩy được phép trên tất cả các nền tảng | | GATEWAY_ALLOW_ALL_USERS | Cho phép tất cả người dùng không có danh sách cho phép ( `true

/ `false

, mặc định: `false

) |### Microsoft Graph (Cuộc họp nhóm)

Thông tin xác thực chỉ dành cho ứng dụng dành cho ứng dụng khách Microsoft Graph REST được sử dụng trong quy trình tóm tắt cuộc họp Teams sắp tới. Xem Register a Microsoft Graph application để biết hướng dẫn về cổng thông tin Azure và các quyền API chính xác cần có.

BiếnMô tả
`MSGRAPH_TENANT_ID
`ID đối tượng thuê Azure AD (GUID thư mục) để đăng ký ứng dụng Đồ thị.
`MSGRAPH_CLIENT_ID
`ID ứng dụng (khách hàng) của đăng ký ứng dụng Azure.
`MSGRAPH_CLIENT_SECRET
`Giá trị bí mật của khách hàng để đăng ký ứng dụng. Lưu trữ trong

~/.Hermes/.env với chmod 600

; xoay vòng định kỳ thông qua cổng Azure. | | MSGRAPH_SCOPE | Phạm vi OAuth2 cho yêu cầu mã thông báo thông tin xác thực ứng dụng khách (mặc định: `https://graph.Microsoft.com/.default

). | | MSGRAPH_AUTHORITY_URL | Cơ quan quản lý nền tảng nhận dạng của Microsoft (mặc định: `https://login.Microsoftonline.com

). Chỉ ghi đè đối với các đám mây quốc gia/có chủ quyền (ví dụ: https://login.Microsoftonline.us dành cho GCC High). |

Trình nghe Webhook của Microsoft Graph

Trình xử lý thông báo thay đổi gửi đến cho các sự kiện Graph (Cuộc họp nhóm, lịch, trò chuyện, v.v.). Xem Microsoft Graph Webhook Listener để biết cách thiết lập và tăng cường bảo mật.

BiếnMô tả
`MSGRAPH_WEBHOOK_ENABLED
`Kích hoạt nền tảng cổng
`msgraph_webhook
` (
`true

/ `1

/ `yes

). | | MSGRAPH_WEBHOOK_PORT | Cổng mà người nghe liên kết tới (mặc định: `8646

). | | MSGRAPH_WEBHOOK_CLIENT_STATE | Đồ thị bí mật được chia sẻ vang vọng trong mọi thông báo; so với `hmac.compare_digest

. Tạo bằng `openSSL rand -hex 32

. | | MSGRAPH_WEBHOOK_ACCEPTED_RESOURCES | Danh sách cho phép được phân tách bằng dấu phẩy của các đường dẫn/mẫu tài nguyên đồ thị (ví dụ: `communications/onlineMeetings,chats/*/messages

). Trailing

là khớp tiền tố. Trống = chấp nhận tất cả. | | MSGRAPH_WEBHOOK_ALLOWED_SOURCE_CIDRS | Phạm vi CIDR được phân tách bằng dấu phẩy được phép POST tới trình nghe (ví dụ: 52.96.0.0/14,52.104.0.0/14

). Trống = cho phép tất cả (mặc định). Hạn chế phạm vi đầu ra được công bố của Microsoft Graph trong sản xuất. |

Gửi bản tóm tắt cuộc họp nhóm

Chỉ được sử dụng khi XPROTECTX699XPROTECTX plugin được bật. Các cài đặt cũng có thể được định cấu hình trong platforms.teams.extra trong `config.yaml

BiếnMô tả
`TEAMS_DELIVERY_MODE
`
`graph
` hoặc
`incoming_webhook

. | | TEAMS_INCOMING_WEBHOOK_URL | URL webhook do nhóm tạo; được yêu cầu khi `TEAMS_DELIVERY_MODE=incoming_webhook

. | | TEAMS_GRAPH_ACCESS_TOKEN | Mã thông báo truy cập được ủy quyền đã được mua trước để phân phối Đồ thị. Hiếm khi cần thiết - người viết quay lại thông tin xác thực ứng dụng MSGRAPH_* khi không được đặt. | | TEAMS_TEAM_ID | ID nhóm mục tiêu để phân phối kênh (chế độ `graph

). | | TEAMS_CHANNEL_ID | ID kênh mục tiêu (được ghép nối với `TEAMS_TEAM_ID

). | | TEAMS_CHAT_ID | Mục tiêu 1:1 hoặc ID trò chuyện nhóm (thay thế cho nhóm+kênh cho chế độ `graph

). |

API nhắn tin LINE

Được sử dụng bởi plugin nền tảng LINE đi kèm ( `plugins/platforms/line/

). Xem Messaging Gateway → LINE để biết thiết lập đầy đủ.| Biến | Mô tả | |----------|-------------| | LINE_CHANNEL_ACCESS_TOKEN | Mã thông báo truy cập kênh tồn tại lâu dài từ Bảng điều khiển dành cho nhà phát triển LINE (tab API nhắn tin). Yêu cầu. | | LINE_CHANNEL_SECRET | Bí mật kênh (tab Cài đặt cơ bản); được sử dụng để xác minh chữ ký webhook HMAC-SHA256. Yêu cầu. | | LINE_HOST | Máy chủ liên kết Webhook (mặc định: `0.0.0.0

). | | LINE_PORT | Cổng liên kết Webhook (mặc định: `8646

). | | LINE_PUBLIC_URL | URL cơ sở HTTPS công khai (ví dụ: `https://my-tunnel.example.com

). Bắt buộc để gửi hình ảnh/âm thanh/video — LINE chỉ chấp nhận các URL có thể truy cập bằng HTTPS. | | LINE_ALLOWED_USERS | ID người dùng được phân tách bằng dấu phẩy được phép gửi tin nhắn trực tiếp cho bot (có tiền tố `U

). | | LINE_ALLOWED_GROUPS | ID nhóm được phân tách bằng dấu phẩy mà bot sẽ phản hồi (có tiền tố `C

). | | LINE_ALLOWED_ROOMS | ID phòng được phân tách bằng dấu phẩy mà bot sẽ phản hồi (có tiền tố `R

). | | LINE_ALLOW_ALL_USERS | Cửa thoát hiểm chỉ dành cho nhà phát triển - chấp nhận bất kỳ nguồn nào. Mặc định: `false

. | | LINE_HOME_CHANNEL | Mục tiêu phân phối mặc định cho các công việc định kỳ với `deliver: line

. | | LINE_SLOW_RESPONSE_THRESHOLD | Vài giây trước khi đăng lại Nút mẫu LLM chậm kích hoạt (mặc định: `45

). Đặt 0 để tắt và luôn Dự phòng đẩy. | | LINE_PENDING_TEXT | Văn bản bong bóng hiển thị dọc theo nút đăng lại. | | LINE_BUTTON_LABEL | Nhãn nút đăng lại (mặc định: `Get answer

). | | LINE_DELIVERED_TEXT | Trả lời khi một bài đăng lại đã gửi được nhấn lại (mặc định: `Already replied ✅

). | | LINE_INTERRUPTED_TEXT | Trả lời khi nhấn vào nút đăng lại mồ côi

/stop (mặc định: Run was interrupted before completion.

). |

ntfy (thông báo đẩy)

ntfy là dịch vụ thông báo đẩy dựa trên HTTP nhẹ. Đăng ký một chủ đề từ ntfy mobile app, xuất bản chủ đề đó để nói chuyện với đại lý.

BiếnMô tả
`NTFY_TOPIC
`Chủ đề để đăng ký (tin nhắn đến). Yêu cầu.
`NTFY_SERVER_URL
`URL máy chủ (mặc định:
`https://ntfy.sh

). Chỉ vào một ntfy tự lưu trữ để đảm bảo quyền riêng tư. | | NTFY_TOKEN | Mã thông báo xác thực tùy chọn. Mã thông báo mang (ví dụ: `tk_xyz

) hoặc user:pass cho xác thực cơ bản. | | NTFY_PUBLISH_TOPIC | Chủ đề cho các câu trả lời gửi đi (mặc định là `NTFY_TOPIC

). | | NTFY_MARKDOWN | Đặt true để gửi trả lời với tiêu đề `X-Markdown: true

. Mặc định: `false

. | | NTFY_ALLOWED_USERS | Danh sách cho phép (được coi là ID người dùng; trên ntfy đây là tên chủ đề). Thường được đặt thành cùng giá trị với `NTFY_TOPIC

. | | NTFY_ALLOW_ALL_USERS | Cửa thoát hiểm chỉ dành cho nhà phát triển - chỉ an toàn đối với các chủ đề riêng tư được kiểm soát quyền truy cập. Mặc định: `false

. | | NTFY_HOME_CHANNEL | Mục tiêu phân phối mặc định cho các công việc định kỳ với `deliver: ntfy

. | | NTFY_HOME_CHANNEL_NAME | Nhãn con người cho kênh chủ (mặc định là tên chủ đề). |

Xem the ntfy messaging guide — đặc biệt là phần mô hình nhận dạng — trước khi triển khai với các chủ đề không đáng tin cậy.

Điều chỉnh tin nhắn nâng cao

Các nút bấm nâng cao trên mỗi nền tảng để điều chỉnh bộ xử lý tin nhắn gửi đi. Hầu hết người dùng không bao giờ cần chạm vào những thứ này; mặc định được đặt để tôn trọng giới hạn tốc độ của mỗi nền tảng mà không gây cảm giác chậm chạp.| Biến | Mô tả | |----------|-------------| | Hermes_Telegram_TEXT_BATCH_DELAY_SECONDS | Cửa sổ ân hạn trước khi xóa đoạn văn bản Telegram đang xếp hàng đợi (mặc định: `0.6

). | | Hermes_Telegram_TEXT_BATCH_SPLIT_DELAY_SECONDS | Độ trễ giữa các phần được chia khi một tin nhắn Telegram vượt quá giới hạn độ dài (mặc định: `2.0

). | | Hermes_Telegram_MEDIA_BATCH_DELAY_SECONDS | Cửa sổ ân hạn trước khi xóa phương tiện Telegram đã xếp hàng đợi (mặc định: `0.6

). | | Hermes_Telegram_FOLLOWUP_GRACE_SECONDS | Trì hoãn trước khi gửi thông tin theo dõi sau khi tổng đài viên kết thúc, để tránh chạy đua ở đoạn luồng cuối cùng. | | Hermes_Telegram_HTTP_CONNECT_TIMEOUT / _READ_TIMEOUT / _WRITE_TIMEOUT / _POOL_TIMEOUT | Ghi đè thời gian chờ HTTP Python-Telegram-bot cơ bản (giây). | | Hermes_Telegram_HTTP_POOL_SIZE | Kết nối HTTP đồng thời tối đa với API Telegram. | | Hermes_Telegram_DISABLE_FALLBACK_IPS | Vô hiệu hóa IP dự phòng Cloudflare được mã hóa cứng được sử dụng khi DNS bị lỗi ( `true

/ `false

). | | Hermes_Discord_TEXT_BATCH_DELAY_SECONDS | Cửa sổ ân hạn trước khi xóa đoạn văn bản Discord đã xếp hàng đợi (mặc định: `0.6

). | | Hermes_Discord_TEXT_BATCH_SPLIT_DELAY_SECONDS | Độ trễ giữa các phần được chia khi tin nhắn Discord vượt quá giới hạn độ dài (mặc định: `2.0

). | | Hermes_Matrix_TEXT_BATCH_DELAY_SECONDS / _SPLIT_DELAY_SECONDS | Ma trận tương đương với các nút bấm hàng loạt của Telegram. | | Hermes_Feishu_TEXT_BATCH_DELAY_SECONDS / _SPLIT_DELAY_SECONDS / _MAX_CHARS / _MAX_MESSAGES | Điều chỉnh bộ trộn Feishu - độ trễ, độ trễ phân chia, ký tự tối đa trên mỗi tin nhắn, số tin nhắn tối đa trên mỗi lô. | | Hermes_Feishu_MEDIA_BATCH_DELAY_SECONDS | Độ trễ xả phương tiện truyền thông Feishu. | | Hermes_Feishu_DEDUP_CACHE_SIZE | Kích thước của bộ nhớ đệm trích xuất webhook Feishu (mặc định: `1024

). | | Hermes_WeCom_TEXT_BATCH_DELAY_SECONDS / _SPLIT_DELAY_SECONDS | Điều chỉnh hàng loạt WeCom. | | Hermes_VISION_DOWNLOAD_TIMEOUT | Thời gian chờ tính bằng giây để tải xuống hình ảnh trước khi chuyển nó cho các mô hình thị giác (mặc định: `30

). | | Hermes_RESTART_DRAIN_TIMEOUT | Cổng: vài giây để chờ các lần chạy đang hoạt động cạn kiệt trên

/restart trước khi buộc khởi động lại (mặc định: 900

). | | Hermes_GATEWAY_PLATFORM_CONNECT_TIMEOUT | Thời gian chờ kết nối trên mỗi nền tảng trong quá trình khởi động cổng (giây). | | Hermes_GATEWAY_BUSY_INPUT_MODE | Hành vi nhập bận của cổng mặc định: `queue

, steer hoặc `interrupt

. Có thể được ghi đè mỗi cuộc trò chuyện bằng

/busy

. | | Hermes_GATEWAY_BUSY_ACK_ENABLED | Cổng có gửi thông báo xác nhận (⚡/⏳/⏩) hay không khi người dùng gửi đầu vào trong khi tổng đài viên đang bận (mặc định: `true

). Đặt thành false để chặn hoàn toàn các tin nhắn này — đầu vào vẫn được xếp hàng đợi/điều khiển/ngắt như bình thường, chỉ có câu trả lời trò chuyện là ở chế độ im lặng. Được kết nối từ display.busy_ack_enabled trong `config.yaml

. | | Hermes_FILE_MUTATION_VERIFIER | Bật chân trang của trình xác minh đột biến tệp mỗi lượt (mặc định: `true

). Khi được bật, Hermes sẽ thêm một danh sách tư vấn bất kỳ lệnh gọi write_file / patch nào không thành công trong lượt và không được thay thế bằng lệnh ghi thành công. Đặt thành `0

, `false

, no hoặc off để ngăn chặn. Gương display.file_mutation_verifier trong `config.yaml

; var env thắng khi được đặt. | | Hermes_CRON_TIMEOUT | Thời gian chờ không hoạt động cho tác nhân công việc định kỳ chạy tính bằng giây (mặc định: `600

). Tác nhân có thể chạy vô thời hạn trong khi đang tích cực gọi các công cụ hoặc nhận mã thông báo luồng — điều này chỉ kích hoạt khi không hoạt động. Đặt thành 0 không giới hạn. | | Hermes_CRON_SCRIPT_TIMEOUT | Thời gian chờ cho các tập lệnh chạy trước được đính kèm với công việc định kỳ tính bằng giây (mặc định: `120

). Ghi đè đối với các tập lệnh cần thực thi lâu hơn (ví dụ: độ trễ ngẫu nhiên cho thời gian chống bot). Cũng có thể định cấu hình thông qua cron.script_timeout_seconds trong `config.yaml

. | | Hermes_CRON_MAX_PARALLEL | Các công việc định kỳ tối đa chạy song song trên mỗi tích tắc (mặc định: `4

). |

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_INFERENCE_MODEL | Ghi đè tên mô hình ở cấp quy trình (ưu tiên hơn config.yaml cho phiên). Cũng có thể giải quyết thông qua cờ

-m

/

--model

. | | Hermes_YOLO_MODE | Đặt thành 1 để bỏ qua lời nhắc phê duyệt lệnh nguy hiểm. Tương đương với

--yolo

. | | Hermes_ACCEPT_HOOKS | Tự động phê duyệt bất kỳ móc shell chưa nhìn thấy nào được khai báo trong config.yaml mà không cần lời nhắc TTY. Tương đương với

--accept-hooks hoặc hooks_auto_accept: true

. | | Hermes_IGNORE_USER_CONFIG | Bỏ qua

~/.Hermes/config.yaml ` và sử dụng các giá trị mặc định tích hợp sẵn (thông tin xác thực trong

.env ` vẫn tải). Tương đương với

--ignore-user-config

. | | Hermes_IGNORE_RULES | Bỏ qua tính năng tự động tiêm `AGENTS.md

, `SOUL.md

,

.Cursorrules

, bộ nhớ và các kỹ năng được tải sẵn. Tương đương với

--ignore-rules

. | | Hermes_MD_NAMES | Danh sách tên tệp quy tắc được phân tách bằng dấu phẩy để tự động chèn (mặc định: `AGENTS.md,Claude.md,.Cursorrules,SOUL.md

). | | 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ụ. Ưu tiên 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ụ. Ưu tiên 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

) | | Codex_HOME | Khi Codex app-server runtime được bật, hãy ghi đè thư mục Codex CLI đọc cấu hình + xác thực của nó từ (mặc định:

~/.Codex

). Quá trình di chuyển của Hermes ghi khối được quản lý vào

<Codex_HOME/config.TOML

. | | Hermes_KANBAN_TASK | Được thiết lập bởi bộ điều phối Kanban khi sinh ra một công nhân (UUID nhiệm vụ). Công nhân và quy trình con MCP Hermes-tools được sinh ra kế thừa nó để cổng công cụ Kanban chính xác. Đừng đặt thủ công. | | Hermes_API_TIMEOUT | Thời gian chờ cuộc gọi API LLM tính bằng giây (mặc định: `1800

) | | Hermes_API_CALL_STALE_TIMEOUT | Thời gian chờ cuộc gọi cũ không phát trực tuyến tính bằng giây (mặc định: `300

). Tự động tắt đối với các nhà cung cấp địa phương khi không được đặt. Cũng có thể định cấu hình thông qua providers.&lt;id.stale_timeout_seconds hoặc providers.&lt;id.models.&lt;model.stale_timeout_seconds trong `config.yaml

. | | Hermes_STREAM_READ_TIMEOUT | Thời gian chờ đọc ổ cắm phát trực tuyến tính bằng giây (mặc định: `120

). Tự động tăng lên Hermes_API_TIMEOUT cho các nhà cung cấp địa phương. Tăng nếu LLM cục bộ hết thời gian chờ trong quá trình tạo mã dài. | | Hermes_STREAM_STALE_TIMEOUT | Thời gian chờ phát hiện luồng cũ tính bằng giây (mặc định: `180

). Tự động vô hiệu hóa cho các nhà cung cấp địa phương. Kích hoạt hủy kết nối nếu không có đoạn nào đến trong cửa sổ này. | | Hermes_STREAM_RETRIES | Số lần thử kết nối lại giữa luồng do lỗi mạng tạm thời (mặc định: `3

). | | Hermes_AGENT_TIMEOUT | Thời gian chờ không hoạt động của cổng đối với tác nhân đang chạy tính bằng giây (mặc định: `900

). Đặt lại trên mỗi lệnh gọi công cụ và mã thông báo được phát trực tuyến. Đặt thành 0 để tắt. | | Hermes_AGENT_TIMEOUT_WARNING | Cổng: gửi thông báo cảnh báo sau nhiều giây không hoạt động này (mặc định: 75% `Hermes_AGENT_TIMEOUT

). | | Hermes_AGENT_NOTIFY_INTERVAL | Cổng: khoảng thời gian tính bằng giây giữa các thông báo tiến trình trên các lượt tổng đài viên chạy dài. | | Hermes_CHECKPOINT_TIMEOUT | Thời gian chờ để tạo điểm kiểm tra hệ thống tệp tính bằng giây (mặc định: `30

). | | 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/ cho cả trình tải tác nhân và máy chủ web bảng điều khiển. Chấp nhận bộ trung thực tiêu chuẩn: 1 / true / yes / on (không phân biệt chữ hoa chữ thường). Mọi thứ khác — bao gồm 0

, `false

, `no

, off và chuỗi trống — được coi là bị tắt (mặc định). Lưu ý: kể từ GHSA-5qr3-c538-wm9j (#29156), máy chủ web bảng điều khiển từ chối tự động nhập tệp Python API của plugin dự án ngay cả khi var này được bật — plugin dự án có thể mở rộng giao diện người dùng thông qua JS/CSS tĩnh nhưng các tuyến phụ trợ của chúng chỉ được tải khi được di chuyển trong

~/.Hermes/plugins/

. | | Hermes_PLUGINS_DEBUG | `1

/ true để hiển thị nhật ký khám phá plugin chi tiết trên stderr — các thư mục được quét, bảng kê khai được phân tích cú pháp, lý do bỏ qua và truy ngược đầy đủ về phân tích cú pháp hoặc lỗi `register()

. Nhằm vào các tác giả plugin. | | 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) | | 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_ALLOW_PRIVATE_URLS | `true

/ `false

  • cho phép các công cụ tìm nạp URL localhost/mạng riêng. Tắt theo mặc định ở chế độ cổng. | | Hermes_REDACT_SECRETS | `true

/ `false

  • kiểm soát việc biên tập bí mật trong đầu ra công cụ, nhật ký và phản hồi trò chuyện (mặc định: `true

). | | Hermes_WRITE_SAFE_ROOT | Tiền tố thư mục tùy chọn hạn chế ghi `write_file

/ `patch

; đường dẫn bên ngoài cần được phê duyệt. | | Hermes_DISABLE_FILE_STATE_GUARD | Đặt thành 1 để tắt tính năng bảo vệ "tệp đã thay đổi kể từ khi bạn đọc nó" trên `patch

/ `write_file

. | | Hermes_CORE_TOOLS | Ghi đè được phân tách bằng dấu phẩy cho danh sách công cụ cốt lõi chuẩn (nâng cao; hiếm khi cần thiết). | | Hermes_BUNDLED_SKILLS | Ghi đè được phân tách bằng dấu phẩy cho danh sách các kỹ năng đi kèm được tải khi khởi động. | | Hermes_OPTIONAL_SKILLS | Danh sách tên kỹ năng tùy chọn được phân tách bằng dấu phẩy để tự động cài đặt trong lần chạy đầu tiên. | | Hermes_DEBUG_INTERRUPT | Đặt thành 1 để ghi nhật ký chi tiết về ngắt/hủy theo dõi đối với `agent.log

. | | 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_DUMP_REQUEST_STDOUT | Kết xuất tải trọng yêu cầu API vào thiết bị xuất chuẩn thay vì tệp nhật ký. | | Hermes_OAuth_TRACE | Đặt thành 1 để ghi lại các lần thử làm mới và trao đổi mã thông báo OAuth. Bao gồm thông tin thời gian được biên tập lại. | | Hermes_OAuth_FILE | Ghi đè đường dẫn được sử dụng để lưu trữ thông tin xác thực OAuth (mặc định:

~/.Hermes/auth.JSON

). | | Hermes_AGENT_HELP_GUIDANCE | Nối văn bản hướng dẫn bổ sung vào lời nhắc hệ thống để triển khai tùy chỉnh. | | Hermes_AGENT_LOGO | Ghi đè biểu tượng biểu ngữ ASCII khi khởi động CLI. | | DELEGATION_MAX_CONCURRENT_CHILDREN | Các tác nhân phụ song song tối đa trên mỗi lô delegate_task (mặc định: `3

, tầng 1, không có trần). Cũng có thể định cấu hình thông qua delegation.max_concurrent_children trong `config.yaml

  • giá trị cấu hình được ưu tiên. |## Giao diện | Biến | Mô tả | |----------|-------------| | Hermes_TUI | Khởi chạy TUI thay vì CLI cổ điển khi được đặt thành `1

. Tương đương với việc vượt qua

--TUI

. | | Hermes_TUI_DIR | Đường dẫn đến thư mục ui-TUI/ dựng sẵn (phải chứa dist/entry.js node_modules được điền sẵn). Được sử dụng bởi các bản phân phối và Nix để bỏ qua npm install lần đầu ra mắt. | | Hermes_TUI_RESUME | Tiếp tục phiên TUI cụ thể theo ID khi khởi chạy. Khi được đặt, Hermes --TUI sẽ bỏ qua việc tạo phiên mới và thay vào đó chọn phiên đã đặt tên — hữu ích cho việc đính kèm lại sau khi ngắt kết nối hoặc sự cố terminal. | | Hermes_TUI_THEME | Buộc chủ đề màu TUI: `light

, dark hoặc thập lục phân nền gồm 6 ký tự thô (ví dụ: ffffff hoặc `1a1a2e

). Khi không được đặt, Hermes tự động phát hiện bằng cách sử dụng COLORFGBG và truy vấn nền terminal; biến này ghi đè phát hiện trên các terminal (Ghostty, Warp, iTerm2, v.v.) không đặt `COLORFGBG

. | | Hermes_INFERENCE_MODEL | Buộc mô hình cho Hermes -z / Hermes chat mà không làm thay đổi `config.yaml

. Ghép nối với cờ

--provider

. Hữu ích cho người gọi theo tập lệnh (trình quét, CI, trình chạy hàng loạt) cần ghi đè mô hình mặc định mỗi lần chạy. |

Cài đặt phiên

BiếnMô 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)
`Hermes_SESSION_ID
`Được tự động xuất vào mọi quy trình con của công cụ Hermes sinh ra (
`terminal

, `execute_code

, shell liên tục, chương trình phụ trợ Docker/Singularity, chạy đại lý con được ủy quyền). Được tác nhân đặt thành ID phiên hiện tại; tập lệnh người dùng được gọi từ các công cụ có thể đọc nó để so sánh kết quả đầu ra, phép đo từ xa hoặc tác dụng phụ của họ với phiên Hermes ban đầu. Bạn không nên đặt cài đặt này theo cách thủ công — việc ghi đè nó từ shell gốc chỉ có hiệu lực bên ngoài quá trình chạy tác nhân và bị ghi đè vào thời điểm tác nhân bắt đầu phiên. |

Nén ngữ cảnh (chỉ config.yaml)

Nén ngữ cảnh được định cấu hình độc quyền thông qua `config.yaml

  • không có biến môi trường nào cho nó. Cài đặt ngưỡng nằm trong khối `compression:

, trong khi mô hình/nhà cung cấp tóm tắt nằm trong `auxiliary.compression:

.

compression:
enabled: true
threshold: 0.50
target_ratio: 0.20 # fraction of threshold to preserve as recent tail
protect_last_n: 20 # minimum recent messages to keep uncompressed

`

:::info[Legacy migration]
Các cấu hình cũ hơn với
`compression.summary_model

,
`compression.summary_provider
` và
`compression.summary_base_url
` được tự động di chuyển sang
`auxiliary.compression.*
` trong lần tải đầu tiên.

:::

## 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 đó.

## Nhà cung cấp dự phòng (chỉ config.yaml)

Chuỗi dự phòng mô hình chính được định cấu hình độc quyền thông qua
`config.yaml
` — không có biến môi trường nào cho chuỗi này. Thêm danh sách
`fallback_providers
` cấp cao nhất với các khóa
`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.

``` yaml
fallback_providers:

- provider: OpenRouter
model: Anthropic/Claude-sonnet-4

`
``Hình dạng nhà cung cấp đơn
`fallback_model
` cấp cao nhất cũ hơn vẫn được đọc để tương thích ngược nhưng cấu hình mới nên sử dụng
`fallback_providers

.

Xem [Fallback Providers](/docs/user-guide/features/fallback-providers) để 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 |

:::tip
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).
:::