{"id":"e278183c-5974-4927-a8b8-b33c292d5221","entityType":"agent","slug":"clawhub-edwardwason-hermes-for-win","name":"Hermes For Win","canonicalUrl":"https://www.xpersona.co/agent/clawhub-edwardwason-hermes-for-win","canonicalPath":"/agent/clawhub-edwardwason-hermes-for-win","generatedAt":"2026-10-10T08:45:37.414Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T04:43:13.539Z","emptyReason":null},"description":"一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。 Skill: Hermes For Win Owner: edwardwason Summary: 一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。 Tags: latest:1.1.0 Version history: v1.1.0 | 2026-04-18T06:21:04.719Z | user v1.1.0 - Fix Port Consistency and Documentation 🔧 What's Fixed - Port consistency: Changed default port from 8788 8787 (matches hermes-webui default) - WSL2 dependency: Added clear","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s177q4wcvafq6fzfkhk2g3cwth83y01d:hermes-for-win","sourceUrl":"https://clawhub.ai/edwardwason/hermes-for-win","homepage":"https://clawhub.ai/edwardwason/skills/hermes-for-win","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/edwardwason/hermes-for-win","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/edwardwason/skills/hermes-for-win","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。 Skill: Hermes For Win Owner: edwardwason Summary"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:43:13.539Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:43:13.539Z","emptyReason":null},"stars":null,"forks":null,"downloads":1675,"packageName":null,"latestVersion":"1.1.0","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:43:13.539Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T04:43:13.539Z","lastCrawledAt":"2026-10-10T04:43:13.539Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T04:43:13.539Z","lastVerifiedAt":null,"highlights":[{"version":"1.1.0","createdAt":"2026-04-18T06:21:04.719Z","changelog":"## v1.1.0 - Fix Port Consistency and Documentation ### 🔧 What's Fixed - Port consistency: Changed default port from 8788 8787 (matches hermes-webui default) - WSL2 dependency: Added clear documentation that WSL2 is required - Third-party project: Added note that this is a third-party installer, not official ### 📦 GitHub Release Also available on GitHub: https://github.com/EdwardWason/hermes-for-win/releases/tag/v1.1.0","fileCount":4,"zipByteSize":4722},{"version":"1.0.2","createdAt":"2026-04-18T01:26:08.757Z","changelog":"- Added full documentation and usage guide in SKILL.md, detailing one-click installation, management, and features for Hermes Agent and hermes-webui on Windows. - Explained prerequisites, key features, installation steps, available management scripts, and troubleshooting tips. - Included security notes and project structure for better transparency and user onboarding. - Provided links to the project repository, releases, and issue tracker.","fileCount":5,"zipByteSize":9828}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177q4wcvafq6fzfkhk2g3cwth83y01d:hermes-for-win","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T08:45:37.413Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-hermes-for-win/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T04:43:13.539Z","emptyReason":null},"readme":"Skill: Hermes For Win\n\nOwner: edwardwason\n\nSummary: 一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。\n\nTags: latest:1.1.0\n\nVersion history:\n\nv1.1.0 | 2026-04-18T06:21:04.719Z | user\n\n## v1.1.0 - Fix Port Consistency and Documentation\n\n### 🔧 What's Fixed\n- Port consistency: Changed default port from 8788  8787 (matches hermes-webui default)\n- WSL2 dependency: Added clear documentation that WSL2 is required\n- Third-party project: Added note that this is a third-party installer, not official\n\n### 📦 GitHub Release\nAlso available on GitHub: https://github.com/EdwardWason/hermes-for-win/releases/tag/v1.1.0\n\nv1.0.2 | 2026-04-18T01:26:08.757Z | auto\n\n- Added full documentation and usage guide in SKILL.md, detailing one-click installation, management, and features for Hermes Agent and hermes-webui on Windows.\n- Explained prerequisites, key features, installation steps, available management scripts, and troubleshooting tips.\n- Included security notes and project structure for better transparency and user onboarding.\n- Provided links to the project repository, releases, and issue tracker.\n\nArchive index:\n\nArchive v1.1.0: 4 files, 4722 bytes\n\nFiles: references/README.md (4954b), skill-card.md (2191b), SKILL.md (2113b), _meta.json (133b)\n\nFile v1.1.0:SKILL.md\n\n---\nname: \"hermes-for-win\"\ndescription: \"一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。\"\n---\n\n# hermes-for-win\n\n在 Windows 系统上一键安装、部署和管理 hermes Agent 和 hermes-webui，让你轻松拥有完整的 hermes 生态！\n\n## 功能特性\n\n- 🚀 **一键安装** - 自动下载并配置 hermes Agent 和 hermes-webui\n- 🔧 **开机自启** - Windows 登录时自动启动服务\n- 💻 **后台运行** - 无窗口后台常驻运行\n- 🔄 **自动更新** - 支持一键检查并更新到最新版本\n- 📊 **状态监控** - 查看服务运行状态和日志\n\n## 快速开始\n\n### 前置要求\n\n1. Windows 10/11 (64位)\n2. WSL2 已启用并安装 Ubuntu\n3. 至少 4GB 可用内存\n\n### 安装步骤\n\n1. 下载并运行 `install-hermes.ps1`\n2. 按照提示输入配置信息\n3. 等待安装完成\n4. 访问 http://localhost:8787 即可使用\n\n## 使用指南\n\n### 查看服务状态\n\n```powershell\ncd .trae\\skills\\hermes-for-win\\scripts\n.\\check-status.ps1\n```\n\n### 手动启动/停止服务\n\n```powershell\n.\\start-services.ps1\n.\\stop-services.ps1\n```\n\n### 更新到最新版本\n\n```powershell\n.\\update-hermes.ps1\n```\n\n### 配置开机自启\n\n```powershell\n.\\setup-autostart.ps1\n```\n\n## 目录结构\n\n```\nhermes-for-win/\n├── SKILL.md              # 本文件\n├── scripts/              # 所有脚本\n│   ├── install-hermes.ps1       # 一键安装脚本\n│   ├── start-services.ps1       # 启动服务\n│   ├── stop-services.ps1        # 停止服务\n│   ├── check-status.ps1         # 查看状态\n│   ├── update-hermes.ps1        # 更新脚本\n│   └── setup-autostart.ps1      # 配置开机自启\n└── references/           # 参考文档\n    └── README.md\n```\n\n## 故障排查\n\n如果遇到问题，请检查：\n1. WSL2 是否正常运行\n2. 端口 8787 是否被占用\n3. 查看日志文件：`~/hermes_logs/`\n\n## 许可证\n\nMIT License\n\nFile v1.1.0:references/README.md\n\n# hermes-for-win - Reference Documentation\n\n## What is this?\n\n`hermes-for-win` is a complete toolkit for installing, configuring, and managing hermes Agent and hermes-webui on Windows systems. It solves the problem of complex WSL setup for Windows users.\n\n## Key Features\n\n- **One-click Installation** - Download, configure, and start both services automatically\n- **Windows Integration** - Uses Windows Task Scheduler for auto-start\n- **Background Running** - No console windows, runs silently in background\n- **Easy Management** - PowerShell scripts for start/stop/update/status\n- **Self-updating** - Check and apply updates from GitHub automatically\n\n## System Requirements\n\n- Windows 10 (version 2004+) or Windows 11\n- WSL2 enabled with Ubuntu installed\n- At least 4GB RAM\n- 5GB free disk space\n\n## Quick Start\n\n### 1. Install WSL2 (if not already installed)\n\nOpen PowerShell as Administrator:\n\n```powershell\nwsl --install\n```\n\nRestart your computer when prompted.\n\n### 2. Run the installer\n\n```powershell\ncd .trae\\skills\\hermes-for-win\\scripts\n.\\install-hermes.ps1\n```\n\n### 3. Access the WebUI\n\nOpen your browser and go to:\nhttp://localhost:8788\n\n## Script Reference\n\n### install-hermes.ps1\nThe main installation script. Downloads, configures, and starts everything.\n\n**What it does:**\n1. Checks system requirements (WSL, Ubuntu)\n2. Creates installation directory\n3. Downloads latest hermes-agent and hermes-webui\n4. Extracts and sets up files\n5. Copies startup scripts to WSL\n6. Configures Windows Task Scheduler\n7. Starts services for first time\n\n**Usage:**\n```powershell\n.\\install-hermes.ps1\n```\n\n---\n\n### check-status.ps1\nChecks if services are running and shows status.\n\n**Usage:**\n```powershell\n.\\check-status.ps1\n```\n\n**What it shows:**\n- WSL status\n- Running processes\n- Scheduled Task status\n- Log file locations\n\n---\n\n### start-services.ps1\nStarts hermes Agent and WebUI if they're not already running.\n\n**Usage:**\n```powershell\n.\\start-services.ps1\n```\n\n---\n\n### stop-services.ps1\nStops all hermes-related processes.\n\n**Usage:**\n```powershell\n.\\stop-services.ps1\n```\n\n---\n\n### update-hermes.ps1\nChecks GitHub for latest versions and updates if needed.\n\n**What it does:**\n1. Fetches latest release info from GitHub\n2. Compares with installed versions\n3. Stops running services\n4. Backs up current installation\n5. Downloads and extracts updates\n6. Restarts services\n\n**Usage:**\n```powershell\n.\\update-hermes.ps1\n```\n\n---\n\n### setup-autostart.ps1\nConfigures (or re-configures) the Windows Scheduled Task for auto-start.\n\n**Usage:**\n```powershell\n.\\setup-autostart.ps1\n```\n\n---\n\n## Directory Structure\n\n```\n%USERPROFILE%\\.hermes-for-win\\\n├── hermes-agent-<version>\\     # hermes Agent installation\n├── hermes-webui-<version>\\     # hermes WebUI installation\n├── hermes_autostart.sh          # Startup script (copied to WSL)\n└── backup-<timestamp>\\          # Backup directories (created during updates)\n\nWSL (Ubuntu):\n/root/\n├── hermes_autostart.sh          # Startup script\n└── hermes_logs\\                 # Log files\n    ├── autostart.log\n    ├── hermes_agent.log\n    └── hermes_webui.log\n```\n\n## Troubleshooting\n\n### Problem: Services won't start\n\n**Check WSL:**\n```powershell\nwsl -l -v\n```\n\n**Check logs in WSL:**\n```powershell\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_agent.log'\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_webui.log'\n```\n\n### Problem: Port 8788 is already in use\n\nFind and stop the process using the port:\n```powershell\nnetstat -ano | findstr :8788\ntaskkill /PID <process-id> /F\n```\n\n### Problem: Auto-start doesn't work\n\nCheck Task Scheduler:\n1. Press Win+R, type `taskschd.msc`\n2. Look for \"HermesForWinAutoStart\" task\n3. Check History tab for errors\n\nRe-run the setup script:\n```powershell\n.\\setup-autostart.ps1\n```\n\n### Problem: Need to completely reinstall\n\n1. Stop services: `.\\stop-services.ps1`\n2. Delete installation directory: `Remove-Item -Recurse $env:USERPROFILE\\.hermes-for-win`\n3. Remove scheduled task: `Unregister-ScheduledTask -TaskName HermesForWinAutoStart -Confirm:$false`\n4. Re-run installer: `.\\install-hermes.ps1`\n\n## Security Notes\n\n- The scheduled task runs as your user with highest privileges\n- API keys are stored in WSL in `/root/.hermes/.env`\n- Keep your Windows user account secure\n- Don't share your installation with untrusted users\n\n## Uninstall\n\nTo completely remove hermes-for-win:\n\n```powershell\n# Stop services\ncd .trae\\skills\\hermes-for-win\\scripts\n.\\stop-services.ps1\n\n# Remove scheduled task\nUnregister-ScheduledTask -TaskName HermesForWinAutoStart -Confirm:$false\n\n# Delete installation directory\nRemove-Item -Recurse -Force $env:USERPROFILE\\.hermes-for-win\n\n# Optional: Remove WSL installation (if not used for anything else)\n# wsl --unregister Ubuntu\n```\n\n## License\n\nMIT License - feel free to use and modify!\n\n## Contributing\n\nFound a bug or want to improve this? Submit an Issue or PR!\n\nFile v1.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn75zj7vzdyvap84adxa8heyyd82f5eh\",\n  \"slug\": \"hermes-for-win\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1776493264719\n}\n\nFile v1.1.0:skill-card.md\n\n## Description:\n\nInstalls, deploys, and manages hermes Agent and hermes-webui on Windows with WSL2, auto-start, background operation, updates, and status commands.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[edwardwason](https://clawhub.ai/user/edwardwason)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and Windows users use this skill to install, configure, start, stop, update, and inspect a local hermes Agent and hermes-webui deployment through PowerShell and WSL2.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill is intended to install Windows and WSL services using scripts that were not present for scanner inspection.\n\nMitigation: Install only after inspecting the PowerShell scripts from a trusted source and confirming the repositories and release artifacts they download.\n\nRisk: Automatic updates and persistent startup can change or run local services without repeated manual review.\n\nMitigation: Review update targets before applying updates and enable auto-start only when persistent local execution is required.\n\nRisk: The documented scheduled task may run with highest privileges and WSL files may contain sensitive configuration.\n\nMitigation: Use the least privilege that works, protect the Windows account and WSL files, and remove the scheduled task and WSL installation data during uninstall.\n\n## Reference(s):\n\n- [Hermes For Win ClawHub page](https://clawhub.ai/edwardwason/skills/hermes-for-win)\n- [Reference Documentation](references/README.md)\n\n## Skill Output:\n\n**Output Type(s):** [shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with PowerShell command blocks and setup guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires Windows 10/11, WSL2, Ubuntu, and local PowerShell execution.]\n\n## Skill Version(s):\n\n1.1.0 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.2: 5 files, 9828 bytes\n\nFiles: _meta.json (133b), README_CN.md (6145b), README.md (6618b), references/README.md (4954b), SKILL.md (4178b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: hermes-for-win\ndescription: One-click installation and deployment tool for Hermes Agent and hermes-webui on Windows. Enables auto-start on login, background operation, and easy management through PowerShell scripts. Perfect for Windows users who want to build AI agents without complex WSL2 setup.\n---\n\n# Hermes for Windows\n\n## What This Skill Does\n\nThis is a complete, one-click installation and deployment solution for Hermes Agent and hermes-webui on Windows systems. It provides a seamless experience for Windows users to set up, run, and manage AI agents with Hermes, without the complexity of manual WSL2 configuration.\n\n## When to Use\n\n**Use this skill when:**\n- You're on Windows and want to try Hermes Agent\n- You need a one-click solution for Hermes + hermes-webui\n- You want auto-start on Windows login\n- You want both services running silently in the background\n- You need easy management scripts for status checks, starting, stopping, and updating\n\n## Key Features\n\n### 🚀 One-Click Installation\n- Automatically downloads and configures both Hermes Agent and hermes-webui\n- Handles WSL2 setup and dependencies\n- No manual configuration required\n\n### 🔄 Auto-Start on Login\n- Windows Task Scheduler integration\n- Services start automatically when you log in\n- No need to manually start anything\n\n### 📦 Background Operation\n- Both Hermes Agent and hermes-webui run silently in the background\n- No terminal windows cluttering your desktop\n- Check status anytime with management scripts\n\n### 🛠️ Easy Management\n- PowerShell scripts for all operations\n- Check status, start, stop, update with simple commands\n- Log monitoring built-in\n\n## Quick Start\n\n### Prerequisites\n- Windows 10 or 11\n- WSL2 enabled (script will help enable if not already)\n- PowerShell (comes with Windows)\n\n### Installation\n\n```powershell\n# 1. Download the latest release from GitHub\n#    https://github.com/EdwardWason/hermes-for-win/releases\n\n# 2. Extract the zip file\n\n# 3. Run the installation script\n.\\scripts\\install-hermes.ps1\n\n# 4. Done! Open your browser and visit:\n#    http://localhost:8788\n```\n\n## Management Commands\n\nAfter installation, use these PowerShell scripts:\n\n| Script | Purpose |\n|--------|---------|\n| `scripts\\check-status.ps1` | Check if services are running |\n| `scripts\\start-hermes.ps1` | Start Hermes services |\n| `scripts\\stop-hermes.ps1` | Stop Hermes services |\n| `scripts\\update-hermes.ps1` | Update to latest versions |\n\n## Project Structure\n\n```\nhermes-for-win/\n├── LICENSE\n├── README.md              # English documentation\n├── README_CN.md           # Chinese documentation\n├── _meta.json             # Clawhub metadata\n└── scripts/\n    ├── install-hermes.ps1    # One-click installer\n    ├── check-status.ps1      # Status checker\n    ├── start-hermes.ps1      # Start services\n    ├── stop-hermes.ps1       # Stop services\n    └── update-hermes.ps1     # Update tool\n```\n\n## Security Notes\n\n- The scripts only download from official GitHub releases\n- API keys and sensitive data are stored locally only\n- No data is sent to third-party servers\n- Always review scripts before running if you have concerns\n\n## Troubleshooting\n\n### WSL2 Not Enabled\nThe install script will attempt to enable WSL2 automatically. If it fails:\n```powershell\n# Enable WSL2 manually\nwsl --install\n# Restart your computer\n```\n\n### Services Won't Start\n```powershell\n# Check the logs\n.\\scripts\\check-status.ps1\n# Look for error messages in the output\n```\n\n### Port Already in Use\nIf port 8788 is already taken, you can modify the hermes-webui configuration to use a different port.\n\n## Acknowledgments\n\nThis project wouldn't exist without:\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) - The amazing AI agent framework\n- [hermes-webui](https://github.com/nesquena/hermes-webui) - The fantastic web interface\n\n## License\n\nMIT License - See LICENSE file for details.\n\n## Links\n\n- **GitHub Repository**: https://github.com/EdwardWason/hermes-for-win\n- **Releases**: https://github.com/EdwardWason/hermes-for-win/releases\n- **Issues**: https://github.com/EdwardWason/hermes-for-win/issues\n\nFile v1.0.2:README.md\n\n# hermes-for-win\n\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![PowerShell](https://img.shields.io/badge/PowerShell-5.1+-blue.svg)](https://learn.microsoft.com/powershell/)\n[![WSL](https://img.shields.io/badge/WSL2-Ubuntu-orange.svg)](https://learn.microsoft.com/windows/wsl/)\n\n🇨🇳 [中文文档](README_CN.md) | 🇺🇸 English\n\n---\n\n## One-click installation and deployment of hermes Agent and WebUI for Windows\n\nhermes is a powerful AI Agent, but installing and configuring it on Windows is very complicated, requiring manual WSL setup, environment configuration, background process management, etc.\n\n**hermes-for-win** is designed to solve this problem: it provides one-click installation, automatic configuration, background operation, auto-start on boot, auto-update and other complete features, allowing Windows users to easily use hermes!\n\n- 🚀 **One-click Install** - Automatically download, configure and start hermes Agent and WebUI\n- 🔧 **Auto-start on Boot** - Automatically start services when Windows logs in\n- 💻 **Background Operation** - Silently runs without a window, not disturbing daily use\n- 🔄 **Auto-update** - One-click to check and update to the latest version\n- 📊 **Status Monitoring** - Check service running status and logs at any time\n\n---\n\n## Features\n\n### Management Scripts\n\n| Script | Function | Description |\n|--------|----------|-------------|\n| `install-hermes.ps1` | One-click Install | Automatically download, configure and start all services |\n| `check-status.ps1` | Check Status | Check WSL, processes and scheduled task status |\n| `start-services.ps1` | Start Services | Start hermes Agent and WebUI |\n| `stop-services.ps1` | Stop Services | Stop all hermes related processes |\n| `update-hermes.ps1` | Auto-update | Check and apply the latest GitHub version |\n| `setup-autostart.ps1` | Setup Auto-start | Configure Windows scheduled task for auto-start on boot |\n\n### System Requirements\n\n| Component | Requirement |\n|-----------|-------------|\n| **OS** | Windows 10 (2004+) / Windows 11 |\n| **WSL** | WSL2 enabled and Ubuntu installed |\n| **Memory** | At least 4GB available memory |\n| **Disk** | At least 5GB available space |\n\n---\n\n## Quick Start\n\n### One-click Install (Recommended)\n\n```powershell\n# 1. Download and extract the latest release package\n\n# 2. Enter the scripts directory\ncd scripts\n\n# 3. Run the installation script\n.\\install-hermes.ps1\n\n# 4. Access WebUI\n# Open in browser: http://localhost:8788\n```\n\n### Daily Management\n\n```powershell\n# Check service status\n.\\check-status.ps1\n\n# Start services\n.\\start-services.ps1\n\n# Stop services\n.\\stop-services.ps1\n\n# Update to the latest version\n.\\update-hermes.ps1\n```\n\n---\n\n## Installation\n\n### Prerequisites\n\n#### 1. Enable WSL2\n\nIf WSL is not installed yet, open PowerShell as Administrator:\n\n```powershell\nwsl --install\n```\n\nAfter restarting your computer, set up Ubuntu username and password.\n\n#### 2. Verify WSL\n\n```powershell\nwsl -l -v\n```\n\nYou should see output similar to:\n```\n  NAME      STATE           VERSION\n* Ubuntu    Running         2\n```\n\n---\n\n### Method 1: Install via Releases (Recommended)\n\n1. **Download Release Package**:\n   - Visit [GitHub Releases](https://github.com/EdwardWason/hermes-for-win/releases)\n   - Download the latest version of `hermes-for-win.zip`\n\n2. **Extract and Run**:\n   - Extract `hermes-for-win.zip` to any directory\n   - Open PowerShell, enter the `scripts` directory\n   - Run: `.\\install-hermes.ps1`\n\n3. **Access WebUI**:\n   - Open browser and visit: http://localhost:8788\n\n---\n\n### Method 2: Install from GitHub Repository\n\n1. **Clone Repository**:\n   ```bash\n   git clone https://github.com/EdwardWason/hermes-for-win.git\n   cd hermes-for-win\n   ```\n\n2. **Run Install Script**:\n   ```powershell\n   cd scripts\n   .\\install-hermes.ps1\n   ```\n\n---\n\n## Project Structure\n\n```\nhermes-for-win/\n├── LICENSE                     # MIT License\n├── README.md                   # This file\n├── README_CN.md                # 中文文档 / Chinese documentation\n├── scripts/\n│   ├── install-hermes.ps1      # One-click installer\n│   ├── check-status.ps1        # Status check\n│   ├── start-services.ps1      # Start services\n│   ├── stop-services.ps1       # Stop services\n│   ├── update-hermes.ps1       # Auto-update\n│   └── setup-autostart.ps1     # Setup auto-start\n└── references/\n    └── README.md               # Detailed reference\n```\n\nAfter installation, files will be created at:\n\n```\n%USERPROFILE%\\.hermes-for-win\\\n├── hermes-agent-<version>\\     # hermes Agent installation\n├── hermes-webui-<version>\\     # hermes WebUI installation\n└── backup-<timestamp>\\          # Backups during updates\n\nWSL (Ubuntu):\n/root/\n├── hermes_autostart.sh          # Startup script\n└── hermes_logs/                 # Log files\n    ├── autostart.log\n    ├── hermes_agent.log\n    └── hermes_webui.log\n```\n\n---\n\n## Security\n\n⚠️ **Security Notes**:\n\n- All configuration and API keys are stored in WSL's `/root/.hermes/` directory\n- Windows scheduled task runs with current user's highest privileges\n- Please ensure your Windows user account is secure\n- Do not commit files containing sensitive information to Git\n\n---\n\n## Troubleshooting\n\n### Problem: Services won't start\n\n**Check WSL**:\n```powershell\nwsl -l -v\n```\n\n**Check logs**:\n```powershell\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_agent.log'\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_webui.log'\n```\n\n### Problem: Port 8788 is in use\n\n```powershell\n# Find the process using the port\nnetstat -ano | findstr :8788\n\n# End the process\ntaskkill /PID <process-id> /F\n```\n\n### Problem: Auto-start not working\n\n1. Press `Win+R`, type `taskschd.msc`\n2. Find the `HermesForWinAutoStart` task\n3. Check the error information in the \"History\" tab\n4. Re-run: `.\\setup-autostart.ps1`\n\n### Complete Uninstall\n\n```powershell\n# 1. Stop services\ncd scripts\n.\\stop-services.ps1\n\n# 2. Delete scheduled task\nUnregister-ScheduledTask -TaskName HermesForWinAutoStart -Confirm:$false\n\n# 3. Delete installation directory\nRemove-Item -Recurse -Force $env:USERPROFILE\\.hermes-for-win\n\n# 4. Optional: Uninstall WSL Ubuntu (if no longer needed)\n# wsl --unregister Ubuntu\n```\n\n---\n\n## Acknowledgments\n\n- [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) - Core AI Agent\n- [nesquena/hermes-webui](https://github.com/nesquena/hermes-webui) - Web Interface\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details\n\nFile v1.0.2:references/README.md\n\n# hermes-for-win - Reference Documentation\n\n## What is this?\n\n`hermes-for-win` is a complete toolkit for installing, configuring, and managing hermes Agent and hermes-webui on Windows systems. It solves the problem of complex WSL setup for Windows users.\n\n## Key Features\n\n- **One-click Installation** - Download, configure, and start both services automatically\n- **Windows Integration** - Uses Windows Task Scheduler for auto-start\n- **Background Running** - No console windows, runs silently in background\n- **Easy Management** - PowerShell scripts for start/stop/update/status\n- **Self-updating** - Check and apply updates from GitHub automatically\n\n## System Requirements\n\n- Windows 10 (version 2004+) or Windows 11\n- WSL2 enabled with Ubuntu installed\n- At least 4GB RAM\n- 5GB free disk space\n\n## Quick Start\n\n### 1. Install WSL2 (if not already installed)\n\nOpen PowerShell as Administrator:\n\n```powershell\nwsl --install\n```\n\nRestart your computer when prompted.\n\n### 2. Run the installer\n\n```powershell\ncd .trae\\skills\\hermes-for-win\\scripts\n.\\install-hermes.ps1\n```\n\n### 3. Access the WebUI\n\nOpen your browser and go to:\nhttp://localhost:8788\n\n## Script Reference\n\n### install-hermes.ps1\nThe main installation script. Downloads, configures, and starts everything.\n\n**What it does:**\n1. Checks system requirements (WSL, Ubuntu)\n2. Creates installation directory\n3. Downloads latest hermes-agent and hermes-webui\n4. Extracts and sets up files\n5. Copies startup scripts to WSL\n6. Configures Windows Task Scheduler\n7. Starts services for first time\n\n**Usage:**\n```powershell\n.\\install-hermes.ps1\n```\n\n---\n\n### check-status.ps1\nChecks if services are running and shows status.\n\n**Usage:**\n```powershell\n.\\check-status.ps1\n```\n\n**What it shows:**\n- WSL status\n- Running processes\n- Scheduled Task status\n- Log file locations\n\n---\n\n### start-services.ps1\nStarts hermes Agent and WebUI if they're not already running.\n\n**Usage:**\n```powershell\n.\\start-services.ps1\n```\n\n---\n\n### stop-services.ps1\nStops all hermes-related processes.\n\n**Usage:**\n```powershell\n.\\stop-services.ps1\n```\n\n---\n\n### update-hermes.ps1\nChecks GitHub for latest versions and updates if needed.\n\n**What it does:**\n1. Fetches latest release info from GitHub\n2. Compares with installed versions\n3. Stops running services\n4. Backs up current installation\n5. Downloads and extracts updates\n6. Restarts services\n\n**Usage:**\n```powershell\n.\\update-hermes.ps1\n```\n\n---\n\n### setup-autostart.ps1\nConfigures (or re-configures) the Windows Scheduled Task for auto-start.\n\n**Usage:**\n```powershell\n.\\setup-autostart.ps1\n```\n\n---\n\n## Directory Structure\n\n```\n%USERPROFILE%\\.hermes-for-win\\\n├── hermes-agent-<version>\\     # hermes Agent installation\n├── hermes-webui-<version>\\     # hermes WebUI installation\n├── hermes_autostart.sh          # Startup script (copied to WSL)\n└── backup-<timestamp>\\          # Backup directories (created during updates)\n\nWSL (Ubuntu):\n/root/\n├── hermes_autostart.sh          # Startup script\n└── hermes_logs\\                 # Log files\n    ├── autostart.log\n    ├── hermes_agent.log\n    └── hermes_webui.log\n```\n\n## Troubleshooting\n\n### Problem: Services won't start\n\n**Check WSL:**\n```powershell\nwsl -l -v\n```\n\n**Check logs in WSL:**\n```powershell\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_agent.log'\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_webui.log'\n```\n\n### Problem: Port 8788 is already in use\n\nFind and stop the process using the port:\n```powershell\nnetstat -ano | findstr :8788\ntaskkill /PID <process-id> /F\n```\n\n### Problem: Auto-start doesn't work\n\nCheck Task Scheduler:\n1. Press Win+R, type `taskschd.msc`\n2. Look for \"HermesForWinAutoStart\" task\n3. Check History tab for errors\n\nRe-run the setup script:\n```powershell\n.\\setup-autostart.ps1\n```\n\n### Problem: Need to completely reinstall\n\n1. Stop services: `.\\stop-services.ps1`\n2. Delete installation directory: `Remove-Item -Recurse $env:USERPROFILE\\.hermes-for-win`\n3. Remove scheduled task: `Unregister-ScheduledTask -TaskName HermesForWinAutoStart -Confirm:$false`\n4. Re-run installer: `.\\install-hermes.ps1`\n\n## Security Notes\n\n- The scheduled task runs as your user with highest privileges\n- API keys are stored in WSL in `/root/.hermes/.env`\n- Keep your Windows user account secure\n- Don't share your installation with untrusted users\n\n## Uninstall\n\nTo completely remove hermes-for-win:\n\n```powershell\n# Stop services\ncd .trae\\skills\\hermes-for-win\\scripts\n.\\stop-services.ps1\n\n# Remove scheduled task\nUnregister-ScheduledTask -TaskName HermesForWinAutoStart -Confirm:$false\n\n# Delete installation directory\nRemove-Item -Recurse -Force $env:USERPROFILE\\.hermes-for-win\n\n# Optional: Remove WSL installation (if not used for anything else)\n# wsl --unregister Ubuntu\n```\n\n## License\n\nMIT License - feel free to use and modify!\n\n## Contributing\n\nFound a bug or want to improve this? Submit an Issue or PR!\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn75zj7vzdyvap84adxa8heyyd82f5eh\",\n  \"slug\": \"hermes-for-win\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1776475568757\n}\n\nFile v1.0.2:README_CN.md\n\n# hermes-for-win\n\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![PowerShell](https://img.shields.io/badge/PowerShell-5.1+-blue.svg)](https://learn.microsoft.com/powershell/)\n[![WSL](https://img.shields.io/badge/WSL2-Ubuntu-orange.svg)](https://learn.microsoft.com/windows/wsl/)\n\n🇨🇳 中文 | 🇺🇸 [English](README.md)\n\n---\n\n## Windows 系统一键安装部署 hermes Agent 和 WebUI\n\nhermes 是一个强大的 AI Agent，但在 Windows 上安装配置非常复杂，需要手动设置 WSL、配置环境、管理后台运行等。\n\n**hermes-for-win** 就是为了解决这个问题：它提供一键安装、自动配置、后台运行、开机自启、自动更新等完整功能，让 Windows 用户也能轻松使用 hermes！\n\n- 🚀 **一键安装** - 自动下载、配置并启动 hermes Agent 和 WebUI\n- 🔧 **开机自启** - Windows 登录时自动启动服务\n- 💻 **后台运行** - 无窗口静默运行，不打扰日常使用\n- 🔄 **自动更新** - 一键检查并更新到最新版本\n- 📊 **状态监控** - 随时查看服务运行状态和日志\n\n---\n\n## 功能特性\n\n### 管理脚本\n\n| 脚本 | 功能 | 说明 |\n|------|------|------|\n| `install-hermes.ps1` | 一键安装 | 自动下载、配置并启动所有服务 |\n| `check-status.ps1` | 查看状态 | 检查 WSL、进程和定时任务状态 |\n| `start-services.ps1` | 启动服务 | 启动 hermes Agent 和 WebUI |\n| `stop-services.ps1` | 停止服务 | 停止所有 hermes 相关进程 |\n| `update-hermes.ps1` | 自动更新 | 检查并应用 GitHub 最新版本 |\n| `setup-autostart.ps1` | 配置自启 | 配置 Windows 定时任务开机自启 |\n\n### 系统要求\n\n| 组件 | 要求 |\n|------|------|\n| **操作系统** | Windows 10 (2004+) / Windows 11 |\n| **WSL** | WSL2 已启用并安装 Ubuntu |\n| **内存** | 至少 4GB 可用内存 |\n| **磁盘** | 至少 5GB 可用空间 |\n\n---\n\n## 快速开始\n\n### 一键安装（推荐）\n\n```powershell\n# 1. 下载并解压最新发布包\n\n# 2. 进入脚本目录\ncd scripts\n\n# 3. 运行安装脚本\n.\\install-hermes.ps1\n\n# 4. 访问 WebUI\n# 浏览器打开: http://localhost:8788\n```\n\n### 日常管理\n\n```powershell\n# 查看服务状态\n.\\check-status.ps1\n\n# 启动服务\n.\\start-services.ps1\n\n# 停止服务\n.\\stop-services.ps1\n\n# 更新到最新版本\n.\\update-hermes.ps1\n```\n\n---\n\n## 安装说明\n\n### 前置要求\n\n#### 1. 启用 WSL2\n\n如果还没有安装 WSL，以管理员身份打开 PowerShell：\n\n```powershell\nwsl --install\n```\n\n重启电脑后，设置 Ubuntu 用户名和密码。\n\n#### 2. 验证 WSL\n\n```powershell\nwsl -l -v\n```\n\n应该看到类似输出：\n```\n  NAME      STATE           VERSION\n* Ubuntu    Running         2\n```\n\n---\n\n### 方法一：通过 Releases 安装（推荐）\n\n1. **下载发布包**：\n   - 访问 [GitHub Releases](https://github.com/EdwardWason/hermes-for-win/releases)\n   - 下载最新版本的 `hermes-for-win.zip` 文件\n\n2. **解压并运行**：\n   - 解压 `hermes-for-win.zip` 到任意目录\n   - 打开 PowerShell，进入 `scripts` 目录\n   - 运行：`.\\install-hermes.ps1`\n\n3. **访问 WebUI**：\n   - 打开浏览器访问：http://localhost:8788\n\n---\n\n### 方法二：从 GitHub 仓库安装\n\n1. **克隆仓库**：\n   ```bash\n   git clone https://github.com/EdwardWason/hermes-for-win.git\n   cd hermes-for-win\n   ```\n\n2. **运行安装脚本**：\n   ```powershell\n   cd scripts\n   .\\install-hermes.ps1\n   ```\n\n---\n\n## 项目结构\n\n```\nhermes-for-win/\n├── LICENSE                     # MIT 许可证\n├── README.md                   # 英文文档 / English documentation\n├── README_CN.md                # 本文件 / This file\n├── scripts/\n│   ├── install-hermes.ps1      # 一键安装脚本\n│   ├── check-status.ps1        # 状态检查\n│   ├── start-services.ps1      # 启动服务\n│   ├── stop-services.ps1       # 停止服务\n│   ├── update-hermes.ps1       # 自动更新\n│   └── setup-autostart.ps1     # 配置自启\n└── references/\n    └── README.md               # 详细参考文档\n```\n\n安装后会在以下位置创建文件：\n\n```\n%USERPROFILE%\\.hermes-for-win\\\n├── hermes-agent-<version>\\     # hermes Agent 安装\n├── hermes-webui-<version>\\     # hermes WebUI 安装\n└── backup-<timestamp>\\          # 更新时的备份\n\nWSL (Ubuntu):\n/root/\n├── hermes_autostart.sh          # 启动脚本\n└── hermes_logs/                 # 日志文件\n    ├── autostart.log\n    ├── hermes_agent.log\n    └── hermes_webui.log\n```\n\n---\n\n## 安全说明\n\n⚠️ **安全注意事项**：\n\n- 所有配置和 API 密钥存储在 WSL 的 `/root/.hermes/` 目录中\n- Windows 定时任务以当前用户最高权限运行\n- 请确保 Windows 用户账户安全\n- 不要将包含敏感信息的文件提交到 Git\n\n---\n\n## 故障排查\n\n### 问题：服务无法启动\n\n**检查 WSL**：\n```powershell\nwsl -l -v\n```\n\n**查看日志**：\n```powershell\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_agent.log'\nwsl -u root -e bash -c 'tail -50 /root/hermes_logs/hermes_webui.log'\n```\n\n### 问题：端口 8788 被占用\n\n```powershell\n# 查找占用端口的进程\nnetstat -ano | findstr :8788\n\n# 结束进程\ntaskkill /PID <process-id> /F\n```\n\n### 问题：开机自启不工作\n\n1. 按 `Win+R`，输入 `taskschd.msc`\n2. 查找 `HermesForWinAutoStart` 任务\n3. 查看「历史记录」标签页的错误信息\n4. 重新运行：`.\\setup-autostart.ps1`\n\n### 完全卸载\n\n```powershell\n# 1. 停止服务\ncd scripts\n.\\stop-services.ps1\n\n# 2. 删除定时任务\nUnregister-ScheduledTask -TaskName HermesForWinAutoStart -Confirm:$false\n\n# 3. 删除安装目录\nRemove-Item -Recurse -Force $env:USERPROFILE\\.hermes-for-win\n\n# 4. 可选：卸载 WSL Ubuntu（如果不再需要）\n# wsl --unregister Ubuntu\n```\n\n---\n\n## 致谢\n\n- [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) - 核心 AI Agent\n- [nesquena/hermes-webui](https://github.com/nesquena/hermes-webui) - Web 界面\n\n---\n\n## 许可证\n\nMIT License - 详见 [LICENSE](LICENSE)","readmeExcerpt":"Skill: Hermes For Win Owner: edwardwason Summary: 一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。 Tags: latest:1.1.0 Version history: v1.1.0 | 2026-04-18T06:21:04.719Z | user v1.1.0 - Fix Port Consistency and Documentation 🔧 What's Fixed - Port consistency: Changed default port from 8788 8787 (matches hermes-webui default) - WSL2 dependency: Added clear","codeSnippets":[],"executableExamples":[{"language":"powershell","snippet":"cd .trae\\skills\\hermes-for-win\\scripts\n.\\check-status.ps1"},{"language":"powershell","snippet":".\\start-services.ps1\n.\\stop-services.ps1"},{"language":"powershell","snippet":".\\update-hermes.ps1"},{"language":"powershell","snippet":".\\setup-autostart.ps1"},{"language":"text","snippet":"hermes-for-win/\n├── SKILL.md              # 本文件\n├── scripts/              # 所有脚本\n│   ├── install-hermes.ps1       # 一键安装脚本\n│   ├── start-services.ps1       # 启动服务\n│   ├── stop-services.ps1        # 停止服务\n│   ├── check-status.ps1         # 查看状态\n│   ├── update-hermes.ps1        # 更新脚本\n│   └── setup-autostart.ps1      # 配置开机自启\n└── references/           # 参考文档\n    └── README.md"},{"language":"powershell","snippet":"wsl --install"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"hermes-for-win\"\ndescription: \"一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。\"\n---\n\n# hermes-for-win\n\n在 Windows 系统上一键安装、部署和管理 hermes Agent 和 hermes-webui，让你轻松拥有完整的 hermes 生态！\n\n## 功能特性\n\n- 🚀 **一键安装** - 自动下载并配置 hermes Agent 和 hermes-webui\n- 🔧 **开机自启** - Windows 登录时自动启动服务\n- 💻 **后台运行** - 无窗口后台常驻运行\n- 🔄 **自动更新** - 支持一键检查并更新到最新版本\n- 📊 **状态监控** - 查看服务运行状态和日志\n\n## 快速开始\n\n### 前置要求\n\n1. Windows 10/11 (64位)\n2. WSL2 已启用并安装 Ubuntu\n3. 至少 4GB 可用内存\n\n### 安装步骤\n\n1. 下载并运行 `install-hermes.ps1`\n2. 按照提示输入配置信息\n3. 等待安装完成\n4. 访问 http://localhost:8787 即可使用\n\n## 使用指南\n\n### 查看服务状态\n\n```powershell\ncd .trae\\skills\\hermes-for-win\\scripts\n.\\check-status.ps1\n```\n\n### 手动启动/停止服务\n\n```powershell\n.\\start-services.ps1\n.\\stop-services.ps1\n```\n\n### 更新到最新版本\n\n```powershell\n.\\update-hermes.ps1\n```\n\n### 配置开机自启\n\n```powershell\n.\\setup-autostart.ps1\n```\n\n## 目录结构\n\n```\nhermes-for-win/\n├── SKILL.md              # 本文件\n├── scripts/              # 所有脚本\n│   ├── install-hermes.ps1       # 一键安装脚本\n│   ├── start-services.ps1       # 启动服务\n│   ├── stop-services.ps1        # 停止服务\n│   ├── check-status.ps1         # 查看状态\n│   ├── update-hermes.ps1        # 更新脚本\n│   └── setup-autostart.ps1      # 配置开机自启\n└── references/           # 参考文档\n    └── README.md\n```\n\n## 故障排查\n\n如果遇到问题，请检查：\n1. WSL2 是否正常运行\n2. 端口 8787 是否被占用\n3. 查看日志文件：`~/hermes_logs/`\n\n## 许可证\n\nMIT License"},{"path":"references/README.md","content":"# hermes-for-win - Reference Documentation\n\n## What is this?\n\n`hermes-for-win` is a complete toolkit for installing, configuring, and managing hermes Agent and hermes-webui on Windows systems. It solves the problem of complex WSL setup for Windows users.\n\n## Key Features\n\n- **One-click Installation** - Download, configure, and start both services automatically\n- **Windows Integration** - Uses Windows Task Scheduler for auto-start\n- **Background Running** - No console windows, runs silently in background\n- **Easy Management** - PowerShell scripts for start/stop/update/status\n- **Self-updating** - Check and apply updates from GitHub automatically\n\n## System Requirements\n\n- Windows 10 (version 2004+) or Windows 11\n- WSL2 enabled with Ubuntu installed\n- At least 4GB RAM\n- 5GB free disk space\n\n## Quick Start\n\n### 1. Install WSL2 (if not already installed)\n\nOpen PowerShell as Administrator:\n\n```powershell\nwsl --install\n```\n\nRestart your computer when prompted.\n\n### 2. Run the installer\n\n```powershell\ncd .trae\\skills\\hermes-for-win\\scripts\n.\\install-hermes.ps1\n```\n\n### 3. Access the WebUI\n\nOpen your browser and go to:\nhttp://localhost:8788\n\n## Script Reference\n\n### install-hermes.ps1\nThe main installation script. Downloads, configures, and starts everything.\n\n**What it does:**\n1. Checks system requirements (WSL, Ubuntu)\n2. Creates installation directory\n3. Downloads latest hermes-agent and hermes-webui\n4. Extracts and sets up files\n5. Copies startup scripts to WSL\n6. Configures Windows Task Scheduler\n7. Starts services for first time\n\n**Usage:**\n```powershell\n.\\install-hermes.ps1\n```\n\n---\n\n### check-status.ps1\nChecks if services are running and shows status.\n\n**Usage:**\n```powershell\n.\\check-status.ps1\n```\n\n**What it shows:**\n- WSL status\n- Running processes\n- Scheduled Task status\n- Log file locations\n\n---\n\n### start-services.ps1\nStarts hermes Agent and WebUI if they're not already running.\n\n**Usage:**\n```powershell\n.\\start-services.ps1\n```\n\n---\n\n### stop-services.ps1\nStops all hermes-related processes.\n\n**Usage:**\n```powershell\n.\\stop-services.ps1\n```\n\n---\n\n### update-hermes.ps1\nChecks GitHub for latest versions and updates if needed.\n\n**What it does:**\n1. Fetches latest release info from GitHub\n2. Compares with installed versions\n3. Stops running services\n4. Backs up current installation\n5. Downloads and extracts updates\n6. Restarts services\n\n**Usage:**\n```powershell\n.\\update-hermes.ps1\n```\n\n---\n\n### setup-autostart.ps1\nConfigures (or re-configures) the Windows Scheduled Task for auto-start.\n\n**Usage:**\n```powershell\n.\\setup-autostart.ps1\n```\n\n---\n\n## Directory Structure\n\n```\n%USERPROFILE%\\.hermes-for-win\\\n├── hermes-agent-<version>\\     # hermes Agent installation\n├── hermes-webui-<version>\\     # hermes WebUI installation\n├── hermes_autostart.sh          # Startup script (copied to WSL)\n└── backup-<timestamp>\\          # Backup directories (created during updates)\n\nWSL (Ubuntu):\n/root/\n├── hermes_autostart.sh          # Startup script\n└── hermes_lo"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn75zj7vzdyvap84adxa8heyyd82f5eh\",\n  \"slug\": \"hermes-for-win\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1776493264719\n}"},{"path":"skill-card.md","content":"## Description:\n\nInstalls, deploys, and manages hermes Agent and hermes-webui on Windows with WSL2, auto-start, background operation, updates, and status commands.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[edwardwason](https://clawhub.ai/user/edwardwason)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and Windows users use this skill to install, configure, start, stop, update, and inspect a local hermes Agent and hermes-webui deployment through PowerShell and WSL2.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill is intended to install Windows and WSL services using scripts that were not present for scanner inspection.\n\nMitigation: Install only after inspecting the PowerShell scripts from a trusted source and confirming the repositories and release artifacts they download.\n\nRisk: Automatic updates and persistent startup can change or run local services without repeated manual review.\n\nMitigation: Review update targets before applying updates and enable auto-start only when persistent local execution is required.\n\nRisk: The documented scheduled task may run with highest privileges and WSL files may contain sensitive configuration.\n\nMitigation: Use the least privilege that works, protect the Windows account and WSL files, and remove the scheduled task and WSL installation data during uninstall.\n\n## Reference(s):\n\n- [Hermes For Win ClawHub page](https://clawhub.ai/edwardwason/skills/hermes-for-win)\n- [Reference Documentation](references/README.md)\n\n## Skill Output:\n\n**Output Type(s):** [shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with PowerShell command blocks and setup guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires Windows 10/11, WSL2, Ubuntu, and local PowerShell execution.]\n\n## Skill Version(s):\n\n1.1.0 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。 Skill: Hermes For Win Owner: edwardwason Summary: 一键安装、部署和管理 hermes Agent 和 hermes-webui 在 Windows 系统上，包括开机自启动、后台常驻和自动更新功能。调用时机：当 Windows 用户想要快速安装和配置 hermes 生态时。 Tags: latest:1.1.0 Version history: v1.1.0 | 2026-04-18T06:21:04.719Z | user v1.1.0 - Fix Port Consistency and Documentation 🔧 What's Fixed - Port consistency: Changed default port from 8788 8787 (matches hermes-webui default) - WSL2 dependency: Added clear","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1155,"uniquenessScore":47,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:43:13.539Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:43:13.539Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T08:45:37.414Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}