WSL2 Ubuntu 安装Hermes Agent-Seo优化-塔城地区网站建设公司

一、相关链接

官网
https://hermes-agent.nousresearch.com/
国内镜像站
https://hermes-agent.ac.cn/

文档
https://hermes-agent.nousresearch.com/docs/
中文文档
https://hermes-agent.ac.cn/docs

github
https://github.com/NousResearch/hermes-agent

二、安装Ubuntu

wsl --install -d Ubuntu-24.04 --name hermes --location E:\wsl2\hermes

三、安装hermes

3.1 官方安装命令（失败）

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Install ripgrep for faster file search ffmpeg for TTS voice messages? [Y/n]Y

已经在hosts配置了raw.githubusercontent.com，不开网络代理，比较慢，还报错。

admin@UD26:~$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash ┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Installer │ ├─────────────────────────────────────────────────────────┤ │ An open source AI agent by Nous Research. │ └─────────────────────────────────────────────────────────┘ ✓ Detected: linux (ubuntu) → Installing managed uv into /home/uadmin/.hermes/bin ... ✓ Managed uv installed (uv 0.11.28 (x86_64-unknown-linux-gnu)) → Checking Python 3.11... → Python 3.11 not found, installing via uv... Installed Python 3.11.15 in 22.58s + cpython-3.11.15-linux-x86_64-gnu (python3.11) warning: `/home/uadmin/.local/bin` is not on your PATH. To use installed Python executables, run `export PATH="/home/uadmin/.local/bin:$PATH"` or `uv python update-shell`. ✓ Python installed: Python 3.11.15 → Checking Git... ✓ Git 2.43.0 found → Checking Node.js (for browser tools)... → Node.js not found — installing Node.js 22 LTS... → Downloading node-v22.23.1-linux-x64.tar.xz... → Extracting to ~/.hermes/node/... ✓ Node.js v22.23.1 installed to ~/.hermes/node/ → Checking internet connectivity for package install and web tools... ⚠ Could not reach https://duckduckgo.com/ ⚠ Network checks failed. Hermes install may complete, but web search and dependency downloads can fail. → Verify internet/DNS and retry if pip install fails. → Checking ripgrep (fast file search)... → Checking ffmpeg (TTS voice messages)... → sudo is needed ONLY to install optional system packages (ripgrep ffmpeg) via your package manager. → Hermes Agent itself does not require or retain root access. Install ripgrep for faster file search ffmpeg for TTS voice messages? [Y/n] Y ⚠ ripgrep not installed (file search will use grep fallback) → To install ripgrep manually: → sudo apt install ripgrep ⚠ ffmpeg not installed (TTS voice messages will be limited) → To install ffmpeg manually: → sudo apt install ffmpeg → Installing to /home/uadmin/.hermes/hermes-agent... → Trying SSH clone... → SSH failed, trying HTTPS... Cloning into '/home/uadmin/.hermes/hermes-agent'... fatal: unable to access 'https://github.com/NousResearch/hermes-agent.git/': Recv failure: Connection timed out ✗ Failed to clone repository

就算开了网络代理，下载也很慢，最后还报错。

admin@UD26:~$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash ┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Installer │ ├─────────────────────────────────────────────────────────┤ │ An open source AI agent by Nous Research. │ └─────────────────────────────────────────────────────────┘ ✓ Detected: linux (ubuntu) ✓ Managed uv found (uv 0.11.28 (x86_64-unknown-linux-gnu)) → Checking Python 3.11... ✓ Python found: Python 3.11.15 → Checking Git... ✓ Git 2.43.0 found → Checking Node.js (for browser tools)... ✓ Node.js v22.23.1 found (Hermes-managed) → Checking internet connectivity for package install and web tools... ⚠ Could not reach https://duckduckgo.com/ ⚠ Network checks failed. Hermes install may complete, but web search and dependency downloads can fail. → Verify internet/DNS and retry if pip install fails. → Checking ripgrep (fast file search)... → Checking ffmpeg (TTS voice messages)... → sudo is needed ONLY to install optional system packages (ripgrep ffmpeg) via your package manager. → Hermes Agent itself does not require or retain root access. Install ripgrep for faster file search ffmpeg for TTS voice messages? [Y/n] Y [sudo] password for uadmin: Reading package lists... Done Building dependency tree... Done Reading state information... Done E: Unable to locate package ripgrep E: Unable to locate package ffmpeg ⚠ ripgrep not installed (file search will use grep fallback) → To install ripgrep manually: → sudo apt install ripgrep ⚠ ffmpeg not installed (TTS voice messages will be limited) → To install ffmpeg manually: → sudo apt install ffmpeg → Installing to /home/uadmin/.hermes/hermes-agent... → Trying SSH clone... → SSH failed, trying HTTPS... Cloning into '/home/uadmin/.hermes/hermes-agent'... remote: Enumerating objects: 7030, done. remote: Counting objects: 100% (7030/7030), done. remote: Compressing objects: 100% (6693/6693), done. error: RPC failed; curl 56 Recv failure: Connection reset by peer error: 2575 bytes of body are still expected fetch-pack: unexpected disconnect while reading sideband packet fatal: early EOF fatal: fetch-pack: invalid index-pack output ✗ Failed to clone repository

3.2 国内镜像安装

curl -fsSL https://hermes-agent.ac.cn/install.sh | bash

开开网络代理，安装报错

admin@UD26:~$ curl -fsSL https://hermes-agent.ac.cn/install.sh | bash ┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Installer │ ├─────────────────────────────────────────────────────────┤ │ An open source AI agent by Nous Research. │ └─────────────────────────────────────────────────────────┘ ✓ Detected: linux (ubuntu) ✓ Managed uv found (uv 0.11.28 (x86_64-unknown-linux-gnu)) → Checking Python 3.11... ✓ Python found: Python 3.11.15 → Checking Git... ✓ Git 2.43.0 found → Checking Node.js (for browser tools)... ✓ Node.js v22.23.1 found (Hermes-managed) → Checking internet connectivity for package install and web tools... ⚠ Could not reach https://duckduckgo.com/ ⚠ Network checks failed. Hermes install may complete, but web search and dependency downloads can fail. → Verify internet/DNS and retry if pip install fails. → Checking ripgrep (fast file search)... ✓ ripgrep 14.1.0 found → Checking ffmpeg (TTS voice messages)... ✓ ffmpeg 6.1.1-3ubuntu5 found → Installing to /home/uadmin/.hermes/hermes-agent... → Trying SSH clone... → SSH failed, trying HTTPS... Cloning into '/home/uadmin/.hermes/hermes-agent'... fatal: unable to access 'https://github.com/NousResearch/hermes-agent.git/': GnuTLS recv error (-110): The TLS connection was non-properly terminated. ✗ Failed to clone repository

开了网络代理，也报错

admin@UD26:~$ curl -fsSL https://hermes-agent.ac.cn/install.sh | bash ┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Installer │ ├─────────────────────────────────────────────────────────┤ │ An open source AI agent by Nous Research. │ └─────────────────────────────────────────────────────────┘ ✓ Detected: linux (ubuntu) ✓ Managed uv found (uv 0.11.28 (x86_64-unknown-linux-gnu)) → Checking Python 3.11... ✓ Python found: Python 3.11.15 → Checking Git... ✓ Git 2.43.0 found → Checking Node.js (for browser tools)... ✓ Node.js v22.23.1 found (Hermes-managed) → Checking internet connectivity for package install and web tools... ⚠ Could not reach https://duckduckgo.com/ ⚠ Network checks failed. Hermes install may complete, but web search and dependency downloads can fail. → Verify internet/DNS and retry if pip install fails. → Checking ripgrep (fast file search)... ✓ ripgrep 14.1.0 found → Checking ffmpeg (TTS voice messages)... ✓ ffmpeg 6.1.1-3ubuntu5 found → Installing to /home/uadmin/.hermes/hermes-agent... → Trying SSH clone... → SSH failed, trying HTTPS... Cloning into '/home/uadmin/.hermes/hermes-agent'... remote: Enumerating objects: 7030, done. remote: Counting objects: 100% (7030/7030), done. remote: Compressing objects: 100% (6693/6693), done. error: RPC failed; curl 92 HTTP/2 stream 5 was not closed cleanly: CANCEL (err 8) error: 5656 bytes of body are still expected fetch-pack: unexpected disconnect while reading sideband packet fatal: early EOF fatal: fetch-pack: invalid index-pack output ✗ Failed to clone repository

3.3 手动git安装

先解决ripgrep、ffmpeg部分安装错误

# 启用universe官方仓库（ripgrep、ffmpeg均在此仓库） sudo add-apt-repository universe -y # 更新包索引 sudo apt update -y # 安装缺失依赖 sudo apt install -y ripgrep ffmpeg

手动git安装

# 创建目录 mkdir -p ~/.hermes/hermes-agent # 进入目标目录 cd ~/.hermes/hermes-agent # 初始化Git仓库 git init # 绑定官方远程仓库 git remote add origin https://github.com/NousResearch/hermes-agent.git # 拉取main分支代码 git fetch --depth 1 origin main # git checkout main

git fetch --depth 1 origin main，这句很快，一点都不卡。

3.4 再使用国内镜像安装

curl -fsSL https://hermes-agent.ac.cn/install.sh | bash

这回就能正常安装了，

3.4.1安装向导选择

日志:开始安装向导 → Starting setup wizard... ┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Setup Wizard │ ├─────────────────────────────────────────────────────────┤ │ Let's configure your Hermes Agent installation. │ │ Press Ctrl+C at any time to exit. │ └─────────────────────────────────────────────────────────┘ -------------------------------------------------------------------------------------------- 选择默认，回车 How would you like to set up Hermes? ↑↓ navigate ENTER/SPACE select ESC cancel → (●) Quick Setup (Nous Portal) — free OAuth login, no API keys, model + tools (recommended) (○) Full setup — configure every provider, tool & option yourself (bring your own keys) (○) Blank Slate — everything off except the bare minimum; opt in to each capability --------------------------------------------------------------------------------------------- 日志： Skipped (keeping current) ◆ Nous Portal One subscription, 300+ models, plus the Tool Gateway: web search, image generation, TTS, browser automation. Sign up: https://portal.nousresearch.com/manage-subscription Not logged into Nous Portal. Starting login... Starting Hermes login via Nous Portal... Portal: https://portal.nousresearch.com To continue: 1. Open: https://portal.nousresearch.com/manage-subscription?user_code=EXLM-R3XQ 2. If prompted, enter code: EXLM-R3XQ (Opened browser for verification) Waiting for approval (polling every 1s)... gio: https://portal.nousresearch.com/manage-subscription?user_code=EXLM-R3XQ: Operation not supported 操作: 访问：https://portal.nousresearch.com/manage-subscription?user_code=EXLM-R3XQ，订阅0美元的，（使用的邮箱+验证码） 日志: Login successful! Auth state: /home/uadmin/.hermes/auth.json ----------------------------------------------------------------------------------------------------------- 选择默认，回车 Your free Nous tool pool — pick the tools to enable: ↑↓ navigate SPACE toggle ENTER confirm ESC cancel → [✓] Web search & extract (Firecrawl) [✓] Image generation (FAL) [✓] Text-to-speech (OpenAI TTS) [✓] Speech-to-text (OpenAI Whisper) [✓] Browser automation (Browser Use) ------------------------------------------------------------------------ 日志： Showing 2 curated models — use "Enter custom model name" for others. Default model set to: tencent/hy3:free Config updated: /home/uadmin/.hermes/config.yaml (model.provider=nous) ✓ Browser automation (Browser Use): enabled via free tool pool ✓ Image generation (FAL): enabled via free tool pool ✓ Speech-to-text (OpenAI Whisper): enabled via free tool pool ✓ Text-to-speech (OpenAI TTS): enabled via free tool pool ✓ Web search & extract (Firecrawl): enabled via free tool pool ------------------------------------------------------------------------ 选择默认，回车 Select terminal backend: ↑↓ navigate ENTER/SPACE select ESC cancel (○) Local - run directly on this machine (default) (○) Docker - isolated container with configurable resources (○) Modal - serverless cloud sandbox (○) SSH - run on a remote machine (○) Daytona - persistent cloud development environment (○) Singularity/Apptainer - HPC-friendly container → (●) Keep current (local) -------------------------------------------------------------- 日志： ◆ Terminal Backend Choose where Hermes runs shell commands and code. This affects tool execution, file access, and isolation. Guide: https://hermes-agent.nousresearch.com/docs/user-guide/configuration#terminal-backend-configuration Skipped (keeping current) Keeping current backend: local ✓ Applied recommended defaults: Max iterations: 150 Tool progress: all Compression threshold: 0.50 Session reset: never (use /reset or compression) Run `hermes setup agent` later to customize. ✓ Setup complete! You're ready to go. Configure all settings: hermes setup Connect Telegram/Discord: hermes setup gateway ------------------------------------------------------- ↓选择跳过（Skip），回车 Connect a messaging platform? (Telegram, Discord, etc.) ↑↓ navigate ENTER/SPACE select ESC cancel → (●) Set up messaging now (recommended) (○) Skip — set up later with 'hermes setup gateway' ------------------------------------------------------- 日志： ◆ Tool Availability Summary 10/11 tool categories available: ✓ Vision (image analysis) ✓ Web Search & Extract (Nous subscription) ✓ Browser Automation (Nous Browser Use) ✓ Image Generation (Nous subscription) ✓ Video Generation (FAL) ✓ Text-to-Speech (OpenAI via Nous subscription) ✓ Modal Execution (optional via Nous subscription) ✗ Skills Hub (GitHub) (missing GITHUB_TOKEN) ✓ Terminal/Commands ✓ Task Planning (todo) ✓ Skills (view, create, edit) ⚠ Some tools are disabled. Run 'hermes setup tools' to configure them, ⚠ or edit ~/.hermes/.env directly to add the missing API keys.

3.4.2 安装日志

admin@UD26:~$ curl -fsSL https://hermes-agent.ac.cn/install.sh | bash ┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Installer │ ├─────────────────────────────────────────────────────────┤ │ An open source AI agent by Nous Research. │ └─────────────────────────────────────────────────────────┘ ✓ Detected: linux (ubuntu) ✓ Managed uv found (uv 0.11.28 (x86_64-unknown-linux-gnu)) → Checking Python 3.11... ✓ Python found: Python 3.11.15 → Checking Git... ✓ Git 2.43.0 found → Checking Node.js (for browser tools)... ✓ Node.js v22.23.1 found → Checking internet connectivity for package install and web tools... ✓ Internet connectivity looks good → Checking ripgrep (fast file search)... ✓ ripgrep 14.1.0 found → Checking ffmpeg (TTS voice messages)... ✓ ffmpeg 6.1.1-3ubuntu5 found → Installing to /home/uadmin/.hermes/hermes-agent... → Existing installation found, updating... → Local changes detected, stashing before update... Saved working directory and index state On main: hermes-install-autostash-20260711-114507 From https://github.com/NousResearch/hermes-agent * branch main -> FETCH_HEAD Already on 'main' Your branch is up to date with 'origin/main'. From https://github.com/NousResearch/hermes-agent * branch main -> FETCH_HEAD Already up to date. → Restoring local changes... Already up to date. On branch main Your branch is up to date with 'origin/main'. Untracked files: (use "git add <file>..." to include in what will be committed) .install_method nothing added to commit but untracked files present (use "git add" to track) ⚠ Local changes were restored on top of the updated codebase. ⚠ Review git diff / git status if Hermes behaves unexpectedly. ✓ Repository ready → Creating virtual environment with Python 3.11... → Virtual environment already exists, recreating... Using CPython 3.11.15 Creating virtual environment at: venv Activate with: source venv/bin/activate ✓ Virtual environment ready (Python 3.11) → Installing dependencies... → Trying tier: hash-verified (uv.lock) ... → (this resolves + downloads the curated [all] set — first run on a → fresh venv can take 1-5 minutes; uv prints progress below) Resolved 233 packages in 2ms Installed 95 packages in 52ms + agent-client-protocol==0.9.0 + aiohappyeyeballs==2.6.1 + aiohttp==3.14.1 + aiosignal==1.4.0 + annotated-doc==0.0.4 + annotated-types==0.7.0 + anyio==4.12.1 + attrs==25.4.0 + certifi==2026.5.20 + cffi==2.0.0 + charset-normalizer==3.4.4 + click==8.3.1 + croniter==6.0.0 + cryptography==46.0.7 + defusedxml==0.7.1 + distro==1.9.0 + fastapi==0.133.1 + fire==0.7.1 + frozenlist==1.8.0 + google-api-core==2.30.3 + google-api-python-client==2.194.0 + google-auth==2.55.1 + google-auth-httplib2==0.3.1 + google-auth-oauthlib==1.3.1 + googleapis-common-protos==1.73.0 + h11==0.16.0 + hermes-agent==0.18.2 (from file:///home/uadmin/.hermes/hermes-agent) + httpcore==1.0.9 + httplib2==0.31.2 + httptools==0.7.1 + httpx==0.28.1 + httpx-sse==0.4.3 + idna==3.15 + jinja2==3.1.6 + jiter==0.13.0 + jsonschema==4.26.0 + jsonschema-specifications==2025.9.1 + markdown==3.10.2 + markdown-it-py==4.0.0 + markupsafe==3.0.3 + mcp==1.26.0 + mdurl==0.1.2 + multidict==6.7.1 + oauthlib==3.3.1 + openai==2.24.0 + packaging==26.0 + pathspec==1.1.1 + pillow==12.2.0 + prompt-toolkit==3.0.52 + propcache==0.4.1 + proto-plus==1.27.2 + protobuf==6.33.5 + psutil==7.2.2 + ptyprocess==0.7.0 + pyasn1==0.6.3 + pyasn1-modules==0.4.2 + pycparser==3.0 + pydantic==2.13.4 + pydantic-core==2.46.4 + pydantic-settings==2.13.1 + pygments==2.19.2 + pyjwt==2.13.0 + pyparsing==3.3.2 + python-dateutil==2.9.0.post0 + python-dotenv==1.2.2 + python-multipart==0.0.27 + pytz==2025.2 + pyyaml==6.0.3 + referencing==0.37.0 + requests==2.33.0 + requests-oauthlib==2.0.0 + rich==14.3.3 + rpds-py==0.30.0 + ruamel-yaml==0.18.17 + ruamel-yaml-clib==0.2.15 + simple-term-menu==1.6.6 + six==1.17.0 + sniffio==1.3.1 + socksio==1.0.0 + sse-starlette==3.3.2 + starlette==1.0.1 + tenacity==9.1.4 + termcolor==3.3.0 + tqdm==4.67.3 + typing-extensions==4.15.0 + typing-inspection==0.4.2 + uritemplate==4.2.0 + urllib3==2.7.0 + uvicorn==0.41.0 + uvloop==0.22.1 + watchfiles==1.1.1 + wcwidth==0.6.0 + websockets==15.0.1 + yarl==1.22.0 + youtube-transcript-api==1.2.4 ✓ Main package installed (hash-verified via uv.lock) ✓ All dependencies installed → Installing Node.js dependencies (browser tools)... ✅ Browser tools ready. Run: python run_agent.py --help ✓ Node.js dependencies installed → Installing browser engine (Playwright Chromium)... ⚠ No sudo available — skipping system-library install (--with-deps). → Ask an administrator to run, one time, as root: → sudo npx playwright install-deps chromium → (from /home/uadmin/.hermes/hermes-agent, after Node.js deps are installed) → Installing Chromium binary into this user's Playwright cache... ✓ Browser engine setup complete → Installing TUI dependencies... ✅ Browser tools ready. Run: python run_agent.py --help ✓ TUI dependencies installed → Setting up hermes command... ✓ Installed hermes launcher → ~/.local/bin/hermes → ~/.local/bin already on PATH ✓ hermes command ready → Setting up configuration files... → ~/.hermes/.env already exists, keeping it → ~/.hermes/config.yaml already exists, keeping it ✓ Configuration directory ready: ~/.hermes/ → Syncing bundled skills to ~/.hermes/skills/ ... Syncing bundled skills into ~/.hermes/skills/ ... Done: 0 new, 0 updated, 72 unchanged. 72 total bundled. ✓ Skills synced to ~/.hermes/skills/ → Starting setup wizard... ┌─────────────────────────────────────────────────────────┐ │ ⚕ Hermes Agent Setup Wizard │ ├─────────────────────────────────────────────────────────┤ │ Let's configure your Hermes Agent installation. │ │ Press Ctrl+C at any time to exit. │ └─────────────────────────────────────────────────────────┘ Skipped (keeping current) ◆ Nous Portal One subscription, 300+ models, plus the Tool Gateway: web search, image generation, TTS, browser automation. Sign up: https://portal.nousresearch.com/manage-subscription Not logged into Nous Portal. Starting login... Starting Hermes login via Nous Portal... Portal: https://portal.nousresearch.com To continue: 1. Open: https://portal.nousresearch.com/manage-subscription?user_code=5RAN-NHRD 2. If prompted, enter code: 5RAN-NHRD (Opened browser for verification) Waiting for approval (polling every 1s)... gio: https://portal.nousresearch.com/manage-subscription?user_code=5RAN-NHRD: Operation not supported Login successful! Auth state: /home/uadmin/.hermes/auth.json Showing 2 curated models — use "Enter custom model name" for others. Default model set to: tencent/hy3:free Config updated: /home/uadmin/.hermes/config.yaml (model.provider=nous) ✓ Browser automation (Browser Use): enabled via free tool pool ✓ Image generation (FAL): enabled via free tool pool ✓ Speech-to-text (OpenAI Whisper): enabled via free tool pool ✓ Text-to-speech (OpenAI TTS): enabled via free tool pool ✓ Web search & extract (Firecrawl): enabled via free tool pool ◆ Terminal Backend Choose where Hermes runs shell commands and code. This affects tool execution, file access, and isolation. Guide: https://hermes-agent.nousresearch.com/docs/user-guide/configuration#terminal-backend-configuration Skipped (keeping current) Keeping current backend: local ✓ Applied recommended defaults: Max iterations: 150 Tool progress: all Compression threshold: 0.50 Session reset: never (use /reset or compression) Run `hermes setup agent` later to customize. ✓ Setup complete! You're ready to go. Configure all settings: hermes setup Connect Telegram/Discord: hermes setup gateway ◆ Tool Availability Summary 10/11 tool categories available: ✓ Vision (image analysis) ✓ Web Search & Extract (Nous subscription) ✓ Browser Automation (Nous Browser Use) ✓ Image Generation (Nous subscription) ✓ Video Generation (FAL) ✓ Text-to-Speech (OpenAI via Nous subscription) ✓ Modal Execution (optional via Nous subscription) ✗ Skills Hub (GitHub) (missing GITHUB_TOKEN) ✓ Terminal/Commands ✓ Task Planning (todo) ✓ Skills (view, create, edit) ⚠ Some tools are disabled. Run 'hermes setup tools' to configure them, ⚠ or edit ~/.hermes/.env directly to add the missing API keys. ┌─────────────────────────────────────────────────────────┐ │ ✓ Setup Complete! │ └─────────────────────────────────────────────────────────┘ 📁 All your files are in ~/.hermes/: Settings: /home/uadmin/.hermes/config.yaml API Keys: /home/uadmin/.hermes/.env Data: /home/uadmin/.hermes/cron/, sessions/, logs/ ──────────────────────────────────────────────────────────── 📝 To edit your configuration: hermes setup Re-run the full wizard hermes setup model Change model/provider hermes setup terminal Change terminal backend hermes setup gateway Configure messaging hermes setup tools Configure tool providers hermes config View current settings hermes config edit Open config in your editor hermes config set <key> <value> Set a specific value Or edit the files directly: nano /home/uadmin/.hermes/config.yaml nano /home/uadmin/.hermes/.env ──────────────────────────────────────────────────────────── 🚀 Ready to go! hermes Start chatting hermes gateway Start messaging gateway hermes doctor Check for issues ┌─────────────────────────────────────────────────────────┐ │ ✓ Installation Complete! │ └─────────────────────────────────────────────────────────┘ 📁 Your files: Config: /home/uadmin/.hermes/config.yaml API Keys: /home/uadmin/.hermes/.env Data: /home/uadmin/.hermes/cron/, sessions/, logs/ Code: /home/uadmin/.hermes/hermes-agent ───────────────────────────────────────────────────────── 🚀 Commands: hermes Start chatting hermes setup Configure API keys & settings hermes config View/edit configuration hermes config edit Open config in editor hermes gateway install Install gateway service (messaging + cron) hermes update Update to latest version ───────────────────────────────────────────────────────── ⚡ Reload your shell to use 'hermes' command: source ~/.bashrc

四、使用

source ~/.bashrc

4.1 开始聊天hermes

admin@UD26~$ hermes

4.1.1 聊天日志

admin@UD26:~$ hermes ██╗ ██╗███████╗██████╗ ███╗ ███╗███████╗███████╗ █████╗ ██████╗ ███████╗███╗ ██╗████████╗ ██║ ██║██╔════╝██╔══██╗████╗ ████║██╔════╝██╔════╝ ██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝ ███████║█████╗ ██████╔╝██╔████╔██║█████╗ ███████╗█████╗███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║ ██╔══██║██╔══╝ ██╔══██╗██║╚██╔╝██║██╔══╝ ╚════██║╚════╝██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ██║ ██║███████╗██║ ██║██║ ╚═╝ ██║███████╗███████║ ██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚══════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╭──────────────────────────────────────────────────────────────────────────── Hermes Agent v0.18.2 (2026.7.7.2) · upstream 5ecc0798 ────────────────────────────────────────────────────────────────────────────╮ │ Available Tools │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⡀⠀⣀⣀⠀⢀⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ browser: browser_back, browser_click, ... │ │ ⠀⠀⠀⠀⠀⠀⢀⣠⣴⣾⣿⣿⣇⠸⣿⣿⠇⣸⣿⣿⣷⣦⣄⡀⠀⠀⠀⠀⠀⠀ clarify: clarify │ │ ⠀⢀⣠⣴⣶⠿⠋⣩⡿⣿⡿⠻⣿⡇⢠⡄⢸⣿⠟⢿⣿⢿⣍⠙⠿⣶⣦⣄⡀⠀ code_execution: execute_code │ │ ⠀⠀⠉⠉⠁⠶⠟⠋⠀⠉⠀⢀⣈⣁⡈⢁⣈⣁⡀⠀⠉⠀⠙⠻⠶⠈⠉⠉⠀⠀ computer_use: computer_use │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣴⣿⡿⠛⢁⡈⠛⢿⣿⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ cronjob: cronjob │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠿⣿⣦⣤⣈⠁⢠⣴⣿⠿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ delegation: delegate_task │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠉⠻⢿⣿⣦⡉⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ file: patch, read_file, search_files, write_file │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⢷⣦⣈⠛⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ image_gen: image_generate │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣴⠦⠈⠙⠿⣦⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ (and 9 more toolsets...) │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠸⣿⣤⡈⠁⢤⣿⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠛⠷⠄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ Available Skills │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⠑⢶⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ autonomous-ai-agents: claude-code, codex, hermes-agent, opencode │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⠁⢰⡆⠈⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ creative: architecture-diagram, ascii-art, ascii-video, baoyu-infographic, claude-design, comfyui, +10 more │ │ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠳⠈⣡⠞⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ >4.1.2 聊天截图1
4.1.3 聊天截图2
4.1.4 聊天失败
没开网络代理的可能会失败
⚠️ API call failed (attempt 1/3): APIConnectionError 🔌 Provider: nous Model: tencent/hy3:free 🌐 Endpoint: https://inference-api.nousresearch.com/v1 📝 Error: Connection error. ⏱️ Elapsed: 4.98s Context: 2 msgs, ~4,372 tokens ⏳ Retrying in 2.5s (attempt 1/3)... ⚠️ API call failed (attempt 2/3): APIConnectionError 🔌 Provider: nous Model: tencent/hy3:free 🌐 Endpoint: https://inference-api.nousresearch.com/v1 📝 Error: Connection error. ⏱️ Elapsed: 12.36s Context: 2 msgs, ~4,372 tokens ⏳ Retrying in 4.6s (attempt 2/3)... ⚠️ API call failed (attempt 3/3): APIConnectionError 🔌 Provider: nous Model: tencent/hy3:free 🌐 Endpoint: https://inference-api.nousresearch.com/v1 📝 Error: Connection error. ⏱️ Elapsed: 23.27s Context: 2 msgs, ~4,372 tokens ❌ API failed after 3 retries — Connection error. 💀 Final error: Connection error. ─ ⚕ Hermes
4.1.5 切换主题和语言
4.2 查看帮助/help
聊天输入：/help
4.3 退出/quit
聊天输入：/quit
4.4 控制台 hermes dashboard
执行命令：hermes dashboard
浏览器访问：Hermes Web UI → http://127.0.0.1:9119
默认界面SESSIONS
聊天CHAT
聊天失败的看命令行，看日志，（没开网络代理）
聊天成功
4.5 第三方增强控制台
包含内置 Web 终端、日志查看、定时任务管理、技能浏览等进阶功能：
1.安装命令（需提前安装 Node.js 环境）：
npm install -g hermes-web-ui
2.启动控制台服务：
hermes-web-ui start
命令行启动会显示登录TOKEN
默认访问地址：http://localhost:8648
这个默认是中文的，看起来好一些。
五、查看日志
5.1. 日志文件路径
所有日志统一存放在 Hermes 配置目录的logs文件夹下：
macOS / Linux / WSL2：~/.hermes/logs/
Windows：%USERPROFILE%\.hermes\logs\（即C:\Users\你的用户名\.hermes\logs）
核心日志文件：
agent.log：主日志，记录所有模型调用、工具执行、会话流转，API 失败的详细堆栈在这里
errors.log：仅记录错误和异常，快速排错优先看这个
5.2. 快速查看命令（推荐）
直接在终端执行 CLI 命令，无需手动找文件：
# 查看最近50行主日志 hermes logs # 实时跟踪日志（发消息时会实时打印请求错误详情） hermes logs -f # 实时只看错误日志 hermes logs errors -f # 查看最近100行错误日志 hermes logs errors -n 100
5.3. 一键自动诊断
优先执行官方诊断命令，会自动检测配置、网络、依赖问题并给出修复提示：
hermes doctor