TrueConf Adapter for Hermes Agent

A TrueConf adapter for Hermes Agent — communicate with your AI agent through TrueConf

English / Русский

Caution

This plugin acts as a gateway interface for interacting with Hermes Agent. TrueConf does not encourage the use of Hermes Agent, does not recommend deploying it within corporate infrastructure, and assumes no responsibility for the operation of Hermes Agent, associated AI agents, external services, or third-party components.

Use of this plugin and connection to Hermes Agent are performed solely at the user’s own discretion and risk. Before deploying it in a corporate network, users should carefully review the relevant information security risks, including data leakage, unauthorized access, prompt injection, execution of unintended commands, compromise of API keys, and unpredictable behavior of AI agents:

• OpenClaw threats: assessing the risks, and how to handle shadow AI
• Don’t Let the Claw Grip Your Hand: A Security Analysis and Defense Framework for OpenClaw

This plugin should be used only after conducting a risk assessment, testing it in an isolated environment, restricting access privileges, configuring monitoring, and implementing appropriate measures to protect corporate infrastructure.

Features

• ✅ Text messages
• ✅ Send and receive files (documents, images)
• ✅ Slash commands (/help, /new, /reset)
• ✅ Reply threading
• ✅ Access control (allow all or specific users)
• ✅ Edit message
• ✅ Outbound sending via hermes send
• ✅ Auto-reconnect on disconnect
• ✅ Auto-repair patches after hermes update

Requirements

• Hermes Agent installed and configured (hermes setup completed)
• TrueConf Server with a bot account created
• Python 3.10+

Installation

Quick Install

curl -fsSL https://raw.githubusercontent.com/TrueConf/hermes-trueconf-adapter/main/install.sh -o /tmp/install.sh && bash /tmp/install.sh

The installer will ask for:

• TrueConf server address
• Bot username and password
• SSL/certificate verification
• Access control settings
• Home channel (press Enter to detect from first message)

Non-interactive (for scripts)

export TRUECONF_SERVER=video.company.com
export TRUECONF_USERNAME=bot
export TRUECONF_PASSWORD=secret
bash install.sh

Configuration

Variables in ~/.hermes/.env:

Variable	Description
TRUECONF_SERVER	TrueConf server address (e.g. video.company.com)
TRUECONF_USERNAME	Bot username
TRUECONF_PASSWORD	Bot password
TRUECONF_USE_SSL	true for HTTPS (default)
TRUECONF_VERIFY_SSL	false for self-signed certificates
TRUECONF_ALLOW_ALL_USERS	true — allow all, false — allowlisted only
TRUECONF_ALLOWED_USERS	Comma-separated TrueConf IDs
TRUECONF_HOME_CHANNEL	Your TrueConf ID (e.g. ivan). Auto-detected if empty

After installation

hermes gateway restart

Update protection

The adapter automatically restores patches after hermes update:

1. apply_patches.sh — idempotent patcher (14 sections)
2. Git hooks — post-merge + post-checkout run the patcher
3. Systemd drop-in — ExecStartPre runs the patcher on gateway start

# Manual patch run
bash ~/.hermes/plugins/trueconf-adapter/apply_patches.sh

Verify installation

grep -c 'TrueConfAdapter' ~/.hermes/hermes-agent/gateway/run.py
grep -c 'source.chat_id' ~/.hermes/hermes-agent/gateway/run.py
grep -c 'Platform.TRUECONF' ~/.hermes/hermes-agent/gateway/session.py
# All three should be >0

Debugging

# TrueConf logs
tail -f ~/.hermes/logs/gateway.log | grep -i "trueconf"

# Configuration
cat ~/.hermes/.env | grep TRUECONF

# Status
hermes gateway status