Openclaw Live Updater
openclaw/openclaw
Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.
A runbook, written in Portuguese, for keeping Hermes Agent healthy on a VPS: updates, gateway restarts, health checks and hosts without a systemd user bus.
SKILL.md written in Portuguese; this summary is our English description.
$ npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Hermes-brasil/hermes-brasil hermes-ops-producao --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hermes-ops-producao .claude/skills/hermes-ops-producao && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "hermes-ops-producao" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/hermes-ops-producao into .claude/skills/hermes-ops-producao/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-ops-producao", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/hermes-ops-producaoType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Hermes-brasil/hermes-brasil hermes-ops-producao --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/hermes-ops-producao .agents/skills/hermes-ops-producao && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "hermes-ops-producao" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/hermes-ops-producao into .agents/skills/hermes-ops-producao/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-ops-producao", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Hermes-brasil/hermes-brasil hermes-ops-producao --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/hermes-ops-producao .cursor/skills/hermes-ops-producao && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "hermes-ops-producao" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/hermes-ops-producao into .cursor/skills/hermes-ops-producao/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-ops-producao", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Hermes-brasil/hermes-brasil.git --path skills/hermes-ops-producao--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Hermes-brasil/hermes-brasil hermes-ops-producao --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/hermes-ops-producao .gemini/skills/hermes-ops-producao && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "hermes-ops-producao" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/hermes-ops-producao into .gemini/skills/hermes-ops-producao/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-ops-producao", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Hermes-brasil/hermes-brasil hermes-ops-producaoInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/hermes-ops-producao .github/skills/hermes-ops-producao && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "hermes-ops-producao" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/hermes-ops-producao into .github/skills/hermes-ops-producao/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-ops-producao", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Hermes-brasil/hermes-brasil hermes-ops-producao --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Hermes-brasil/hermes-brasil.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/hermes-ops-producao .opencode/skills/hermes-ops-producao && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "hermes-ops-producao" agent skill from https://github.com/Hermes-brasil/hermes-brasil/tree/main/skills/hermes-ops-producao into .opencode/skills/hermes-ops-producao/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-ops-producao", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
hermes-ops-producaoA runbook, written in Portuguese, for keeping Hermes Agent healthy on a VPS: updates, gateway restarts, health checks and hosts without a systemd user bus.
The skill collects procedures for keeping Hermes Agent running around the clock and is meant for use before and after an update, when the gateway disappears, when Telegram stops answering or when `systemctl --user` fails. An update is `hermes update`, then a mandatory `hermes version` check and `hermes doctor --fix`. The update normally backs up to `~/.hermes/backups/`, pulls the source, reinstalls in the project's virtual environment and builds the web UI. Pitfalls noted: a command timeout does not mean the update failed, the system `pip` must never be used, and the gateway may need a restart if messaging connections go stale.
For restarts it uses `hermes gateway restart` and warns that a graceful shutdown can outlast the CLI timeout while sessions drain, so check the PID and logs. Where the error Failed to connect to bus: No medium found appears, it avoids `systemctl --user`, finds the gateway process, sends it a TERM signal and relaunches through the Hermes supervisor or `hermes gateway run`. For systemd hosts it covers `loginctl enable-linger`, and a SIGKILL on stop is traced to `TimeoutStopSec`, with options such as `KillMode=process`. An end-to-end health check runs `hermes version`, `hermes doctor --fix` and `hermes status --all`.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 8f94818. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
gitpipFrom the folder's file list and the shell code blocks in SKILL.md.
Links to these hosts (documentation or services it may open):
hermes-agent.nousresearch.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Hermes Agent Production Ops loads about 1.2k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 460 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check noted patterns worth knowing about, such as sudo or a known installer.
sudo loginctl enable-linger "$USER"- `.env` e tokens fora de git e de skill públicaAutomated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from Hermes-brasil/hermes-brasil at commit 8f94818, republished under its MIT licence (© Hermes-brasil). 460 words, ~1,197 tokens.
.claude/skills/hermes-ops-producao/SKILL.md (or your agent's skills folder).Procedimentos para manter o Hermes Agent saudável 24/7. Use antes/depois de update, quando o gateway “some”, quando Telegram para de responder, ou quando systemctl --user falha.
Guia longo: guides/instalacao-producao-vps.md neste repositório.
hermes update / dúvida se a versão subiuhermes gateway restart trava ou não relança processoshermes status ok mas mensagem não chegaFailed to connect to bus: No medium foundhermes update
hermes version # obrigatório validar
hermes doctor --fixO update tipicamente:
~/.hermes/backups/pre-update-YYYY-MM-DD-HHMMSS...git pull no source (ex.: /usr/local/lib/hermes-agent em install root FHS)Pitfalls
hermes version.pip do sistema. Fallback manual: cd no source e ./venv/bin/pip install -e .hermes gateway restart
# se a CLI aceitar na sua versão:
hermes gateway status
ps aux | grep 'gateway run' | grep -v grepGraceful shutdown pode estourar timeout da CLI enquanto o processo ainda está drenando sessões. Olhe o PID e os logs.
systemctl --user stop hermes-gateway
# → Failed to connect to bus: No medium foundNesse ambiente:
systemctl --userps aux | grep 'gateway run'kill -TERM <pid> no gateway principalhermes gateway run, ou o unit/supervisor que você configurou no hostSe a imagem permitir systemd de verdade:
sudo loginctl enable-linger "$USER"
# units em ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user restart hermes-gatewaySe o journal mostra status=9/KILL no restart, o gateway passou de TimeoutStopSec drenando agentes. Mitigações comuns:
TimeoutStopSec no unitKillMode=process (não mata cgroup inteiro de uma vez)config.yaml do HermesOrdem curta:
hermes version
hermes doctor --fix
hermes status --all
tail -40 ~/.hermes/logs/gateway.log
tail -20 ~/.hermes/logs/errors.log
hermes send --to telegram:CHAT_ID "ping pós-ops"
# fórum/tópico:
hermes send --to telegram:CHAT_ID:THREAD_ID "ping thread"Checklist mental:
| Check | OK se |
|---|---|
| Versão | string de versão + commit recente |
| Doctor | sem erro bloqueante |
| Processo | gateway run presente |
| Send | mensagem chega no app |
| Cron | hermes cron list sem rain de last_status ruim |
Home-channel startup notification failed: send_path_degraded — confirme com hermes sendAPI server network-accessible AND terminal backend local — risco de desenho; não “ignore para sempre” se a API está públicaSecret redaction: DISABLED — ligue se quiser: hermes config set security.redact_secrets trueRunning as ROOT — comum em VPS single-tenant; ciente do blast radiushermes profile list
ps aux | grep 'hermes.*-p \|gateway run' | grep -v grepApós update/restart, confira se o default voltou. Workers Kanban usam -p <profile> no spawn — profile inexistente = task pronta que nunca anda (assignee fantasma).
Ver: guides/profiles-e-kanban.md
Jobs de produção: prompt autocontido, delivery explícito, ledger se muta o mundo, script = filename em ~/.hermes/scripts/.
Ver: guides/cron-em-producao.md
.env e tokens fora de git e de skill públicaapprovals.mode)~/.hermes antes de migração grande (hermes backup se disponível na versão)hermes version
hermes doctor --fix
hermes status --all
hermes update
hermes gateway status
hermes gateway restart
hermes cron list
hermes profile list
hermes logs # se disponível
tail -f ~/.hermes/logs/gateway.loghermes-agentguides/instalacao-producao-vps.md, cron-em-producao.md, profiles-e-kanban.md© Hermes-brasil, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/hermes-ops-producao of Hermes-brasil/hermes-brasil.
Open the folder on GitHubat commit 8f94818
Hermes Agent Production Ops next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Hermes Agent Production Ops this skillHermes-brasil/hermes-brasil | 154 | — | ~1.2k | Automated safety check: Notes | MIT | |
| Openclaw Live Updateropenclaw/openclaw | 392k | — | ~3.7k | Automated safety check: Pass | MIT | |
| Openbkn Deployopenbkn-ai/bkn-foundry | 661 | — | ~1.9k | Automated safety check: Notes | Custom licence | |
| Minimegasandia-minimega/minimega | 160 | — | ~3.2k | Automated safety check: Pass | GPL-3.0-only | |
| Setup Cpu Proxy Serverdrawthingsai/draw-things-community | 584 | — | ~3.8k | Automated safety check: Pass | GPL-3.0 | |
| Linux Troubleshooting with Inspektor Gadgetinspektor-gadget/inspektor-gadget | 2.9k | — | ~2.4k | Automated safety check: Notes | Apache-2.0 |
openclaw/openclaw
Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.
openbkn-ai/bkn-foundry
Deploy or upgrade OpenBKN on a customer-authorized Linux server through the repository's deploy scripts, with preflight checks, explicit confirmation, secret handling, and post-deployment…
sandia-minimega/minimega
This skill should be used when the user asks how to configure, run, automate, integrate, or troubleshoot minimega (VMs, namespaces, VLANs, clusters, miniccc, miniweb, command socket or Python API…
drawthingsai/draw-things-community
Set up and verify a new Draw Things CPU proxy and Envoy server using the scripts in Scripts/ServerManagement/CPUScript.
inspektor-gadget/inspektor-gadget
Debugs a single Linux host or container runtime at the kernel level with the standalone ig binary and eBPF gadgets, read-only and without Kubernetes.
ferrumclaudepilgrim/claude-code-android
Android/Termux constraints reference. An agent skill from ferrumclaudepilgrim/claude-code-android.
Hermes-brasil/hermes-brasil
Portuguese notes on a podcast interview with a Nous Research co-founder about Hermes Agent: memory over models, self-improvement, anti-sycophancy and open source.
Hermes-brasil/hermes-brasil
Runs a project on one Kanban board shared by people and AI agents, where a dispatcher splits goals into tasks and any task can go to either a human or an agent.
Hermes-brasil/hermes-brasil
Runs a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging.
Hermes-brasil/hermes-brasil
Portuguese guide to building a retrieval-augmented generation assistant over a company's documents, with embeddings, section-based chunking, retrieval and a client workflow.
Hermes-brasil/hermes-brasil
Use quando precisar de pesquisa multi-persona com síntese protegida por evidências.
Hermes-brasil/hermes-brasil
Tratar conteúdo externo não confiável antes de agir. An agent skill from Hermes-brasil/hermes-brasil.
Categories
A runbook, written in Portuguese, for keeping Hermes Agent healthy on a VPS: updates, gateway restarts, health checks and hosts without a systemd user bus. The skill collects procedures for keeping Hermes Agent running around the clock and is meant for use before and after an update, when the gateway disappears, when Telegram stops answering or when `systemctl --user` fails. An update is `hermes update`, then a mandatory `hermes version` check and `hermes doctor --fix`.
Hermes Agent Production Ops fits situations like: updating Hermes Agent on a production VPS and confirming the new version; restarting a gateway that hangs or does not relaunch its processes; diagnosing messages that never arrive although the status looks fine; operating in an environment where the systemd user bus is unavailable.
Run `npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a claude-code`. Or copy the skill folder (skills/hermes-ops-producao in Hermes-brasil/hermes-brasil) into .claude/skills/hermes-ops-producao in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a codex`. Or copy the skill folder (skills/hermes-ops-producao in Hermes-brasil/hermes-brasil) into .agents/skills/hermes-ops-producao in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Hermes-brasil/hermes-brasil --skill hermes-ops-producao -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hermes-ops-producao, .gemini/skills/hermes-ops-producao, .github/skills/hermes-ops-producao and .opencode/skills/hermes-ops-producao in your project.
Going by SKILL.md and its folder, Hermes Agent Production Ops needs the command-line tools its instructions call (git and pip). Our summary lists: A VPS running Hermes Agent; Shell access to the host.
SKILL.md names 1 domain. As links in the text: hermes-agent.nousresearch.com. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found notes only (runs commands with sudo; mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
Hermes Agent Production Ops is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Hermes Agent Production Ops: Openclaw Live Updater (openclaw/openclaw, 392k stars), Openbkn Deploy (openbkn-ai/bkn-foundry, 661 stars), Minimega (sandia-minimega/minimega, 160 stars) and Setup Cpu Proxy Server (drawthingsai/draw-things-community, 584 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Hermes-brasil (a GitHub organization) maintains it in Hermes-brasil/hermes-brasil, which has 154 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 5, 2026.
Source: Hermes-brasil/hermes-brasil on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.