Files

T

mike 657dc41c46 Initial commit: Trading skills collection

- OKX交易自动化 (okx-auto-position, okx-crypto, okx-exchange)
- 交易信号处理 (signal-confirmation-templates, trading-signal-aggregator)
- 量化因子挖掘 (quant-factor-mining)
- 长桥集成 (longbridge-cli, longbridge-python-sdk)
- 六合彩分析 (lottery-hk)
- 股息投资 (dividend-investing, dividend-scanner)
- 日内交易 (intraday-trading)
- 同花顺 (tonghuashun)

2026-07-05 02:39:41 -04:00

4.3 KiB

Raw Blame History

Hermes Gateway 运维手册

重启 Gateway

必须从外部 shell 执行，不能从 agent 内部重启。

⚠️ 从 agent 内执行 systemctl --user restart hermes-gateway 会被安全机制拦截（"cannot restart or stop the gateway from inside the gateway process"）。必须告诉用户在另一个终端执行。

# 从外部 shell 执行
systemctl --user restart hermes-gateway

安全重启（推荐）

hermes gateway restart

或：

systemctl --user restart hermes-gateway

重启流程（有 override 配置时）

systemd 发送 SIGTERM 给旧 gateway
旧 gateway 关闭
ExecStartPre 脚本运行：等待 35 秒 + 清除旧 Telegram session
新 gateway 启动

总耗时约 40 秒。

没有 override 时的手动重启

systemctl --user stop hermes-gateway
sleep 35
systemctl --user start hermes-gateway

Polling Conflict (409 Conflict)

症状：日志中反复出现 Conflict: terminated by other getUpdates request

原因：Telegram 同一 bot 只允许一个 getUpdates 连接。快速重启时旧 session 未过期（需 30 秒）。

修复：配置 ExecStartPre override（见下方 Override 配置）。

Override 配置（持久化）

文件位置：~/.config/systemd/user/hermes-gateway.service.d/override.conf

[Service]
ExecStartPre=
ExecStartPre=/home/openclaw/.hermes/scripts/clear-telegram-session.sh
RestartSec=30

注意：第一行 ExecStartPre= 是清空默认值，第二行才是实际命令。

应用：

systemctl --user daemon-reload

验证：

systemctl --user cat hermes-gateway.service | grep -E "RestartSec|ExecStartPre"

ExecStartPre 清除脚本

文件位置：~/.hermes/scripts/clear-telegram-session.sh

⚠️ 必须用 Python 写入，不能用 bash heredoc（$(...) 语法会被破坏）：

lines = [
    '#!/bin/bash',
    'TOKEN=$(grep TELEGRAM_BOT_TOKEN ~/.hermes/.env | cut -d= -f2)',
    'PROXY="http://127.0.0.1:7890"',
    # ... rest of script
]
with open('/home/openclaw/.hermes/scripts/clear-telegram-session.sh', 'w') as f:
    f.write('\n'.join(lines) + '\n')

危险命令审批配置

approvals:
  mode: off        # 关闭所有审批（交易自动化必须）
  timeout: 60
  cron_mode: deny
command_allowlist:  # 必须是命令名，不是描述文字
  - hermes
  - docker
  - systemctl
  - python3
  - bash
  - sh

注意：command_allowlist 里的条目必须是实际命令名（如 docker），不能是描述（如 docker restart/stop/kill (container lifecycle)）。

Memory 死循环

症状：gateway 有 CPU 活动但无新日志输出，群消息不处理。

原因：MEMORY.md 接近上限（>95%）时 gateway 的 self-improvement review 反复重试 save。

诊断：

journalctl --user -u hermes-gateway -n 50 --no-pager | grep "memory"

看到 Memory at 2,XXX/2,200 chars 就是 memory 满了。

修复：

# 清理 memory（从 agent 内执行 memory remove 或 replace）
# 或手动编辑 ~/.hermes/memories/MEMORY.md
wc -c ~/.hermes/memories/MEMORY.md  # 检查大小

预防：定时任务 memory-check 每天 10:00 EDT 自动检查。

诊断清单

当群消息不处理时，按顺序检查：

Gateway 是否运行：systemctl --user status hermes-gateway
Telegram 连接：journalctl --user -u hermes-gateway -n 100 | grep -i telegram
Polling 冲突：看有没有 409 Conflict
Memory 满：看有没有 Memory at 2,XXX/2,200
审批阻断：看有没有 pending_approval
转发器是否运行：docker ps | grep forward
转发器关键词过滤：docker logs telegram-forwarder --since 2h | grep "未匹配" — 如果大量"未匹配"说明白名单regex太严格，改成 .*
Bot 自测无效：bot 自己发的消息不通过 getUpdates 返回
Gateway 日志：strings ~/.hermes/logs/gateway.log | tail -30（文件是二进制格式，必须用 strings 提取文本）
Gateway 连接状态：strings ~/.hermes/logs/gateway.log | grep "Connected to" 确认各平台连接
Gateway inbound 消息：strings ~/.hermes/logs/gateway.log | grep "inbound message" | tail -10 查看最近收到的消息

4.3 KiB Raw Blame History Unescape Escape