hermes-agent-operations

Operate deployed Hermes Agent instances covering credentials, messaging gateways, webhooks, and systemd services.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-agent-operations-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-agent-operations
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/autonomous-ai-agents/hermes-agent-operations
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-agent-operations-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running a deployed Hermes Agent in container or cloud environments involves tricky operational hurdles: terminal token redaction corrupting credential writes, missing user systemd buses breaking gateway installation, cross-instance webhook tunnels dropping silently, and messaging platform pairing codes failing to deliver due to rate limits. ## Core Features & Use Cases - Credential Management: Write API tokens to .env using Python token assembly to bypass terminal redaction, and manage credential pools via the hermes auth CLI. - Messaging Gateway Setup: Connect Telegram (BotFather token flow) and WeChat (iLink QR login) platforms, configure allowed users, and set home channels. - Cross-Instance Communication: Bridge two Hermes instances via SSH reverse tunnels or GCP IAP tunnels with HMAC-signed webhook POSTs. - Gateway Service Management: Work around missing user systemd buses in containers with system-level units, align TimeoutStopSec with drain timeouts, and restart gateways blocked from inside their own process tree via cron. - Use Case: Your Telegram gateway on a GCP VM fails hermes gateway install with "Failed to connect to bus" — this Skill walks you through creating a system-level systemd unit, verifying connectivity, and setting up a keepalive cron job. ## Quick Start Ask the agent to set up the Telegram gateway for your Hermes instance and troubleshoot why the gateway service will not install on your container.

Frequently Asked Questions about hermes-agent-operations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Telegram bot gateway for Hermes Agent?

Create a bot via @BotFather on Telegram, get your user ID from @userinfobot, then write TELEGRAM_BOT_TOKEN and TELEGRAM_ALLOWED_USERS to ~/.hermes/.env using Python token assembly to avoid terminal redaction. Finally run hermes gateway install and send /sethome to the bot.

How do I fix "Failed to connect to bus: No medium found" when installing the Hermes gateway?

This error means the container lacks a user systemd manager. Create a system-level unit at /etc/systemd/system/hermes-gateway.service with User=root, then run systemctl daemon-reload, enable, and start the service.

Why does writing a Telegram bot token to .env get corrupted?

The terminal tool auto-redacts patterns matching digits:alphanumeric, so the redacted text reaches the shell. Split the token at the colon and reassemble it inside a Python script so no single substring matches the redaction pattern.

Why can't I restart the Hermes gateway from inside a gateway session?

The gateway blocks lifecycle commands from its own process tree because SIGTERM propagates to child processes. Write a one-shot entry to /etc/cron.d/ via execute_code so the system cron daemon, which runs outside the gateway's tree, performs the restart.

Why does WeChat hermes send keep returning rate limited errors?

Persistent rate-limited errors after long inactivity usually mean the iLink server-side session expired (errcode=-14), not a real rate limit. The gateway's long-poll loop must reconnect, which requires a gateway restart from an external shell.

How do I connect two Hermes instances across machines?

Use SSH reverse tunnels or GCP IAP tunnels to expose each instance's webhook port on the other's localhost, then create subscriptions with hermes webhook subscribe and send HMAC-SHA256 signed POSTs with the X-Webhook-Signature header.