dtoro
4efddb8bed
Problem: docs-lint (added in the wiki-hq reorg) surfaced 126 broken relative
links that predated this session — a container rename, incident/plan docs
that moved into archive/done subfolders without their inbound links being
updated, and a handful of relative-depth bugs in files nested under
containers/archive/ and plans/done/.
Fixes applied, by category:
- 124-authentik.md -> 106-auth-outpost.md (container was renamed; ~40 refs).
- investigations/{2026-04-21-hubris-crash-loop,2026-05-31-authentik-vps-migration}.md
-> archive/ prefix (both moved to investigations/archive/ previously).
- plans/{2026-06-01-slate-ax-to-sodola-migration,2026-06-04_130000-deprecate-claudio-bot,
2026-06-25-yuvomi-deployment}.md -> plans/done/ prefix.
- Depth bugs in files nested one level deeper than their siblings assumed
(investigations/archive/*, knowledge/wiki/containers/archive/*,
plans/done/*) — corrected relative-path depth.
- Destroyed containers with no surviving page (126-plato) delinked to the
containers/index.md archaeology row instead of a 404.
- ludo-mini.yaml -> strong.yaml (host was renamed, same physical machine).
- netbird-vps.md (no narrative page exists) -> netbird-vps.yaml (substrate
record, matching the existing convention for hosts without a wiki page).
- runbook-dpkg-interrupted.md refs -> .agents/skills/runbook-dpkg-interrupted/SKILL.md
(missed in the phase-4 runbook move because the referencing files used a
bare filename, not a runbooks/ prefix).
- One dangling forward-reference to a never-written investigation delinked
to the actual incident record it was describing.
Left alone: two links in knowledge/wiki/containers/101-jellyfin.md into
devops/homelab-authentik-admin/ — an intentional reference to a sibling repo,
not present in this checkout.
Verification: broken-link count 126 -> 2 (real remainder is the cross-repo
reference above); gen-topology.py --check still exit 0; build_host_files.py
still idempotent; all inventory.yaml doc_page targets still resolve.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
91 lines
4.3 KiB
Markdown
91 lines
4.3 KiB
Markdown
# 123 — `claudio-bot` (DEPRECATED — destroyed 2026-06-04)
|
|
|
|
> **This LXC was destroyed on 2026-06-04.** Replaced by Hermes Agent on mac-mini.
|
|
> Monitoring migrated to `homelab-hardware-health` skill + 15-min Hermes cronjob.
|
|
> Repos `dtoro/claudio-bot` and `dtoro/claudio-monitor` archived (read-only) on Gitea.
|
|
> See [deprecation plan](../../../../plans/done/2026-06-04_130000-deprecate-claudio-bot.md) for full details.
|
|
|
|
Matrix-resident control plane. Bot account `@claudio:avispero` joined to a private room; accepts slash commands and natural language; relays infra notifications.
|
|
|
|
## At a glance
|
|
- **Hostname:** `claudio-bot`
|
|
- **IP:** `192.168.8.230`
|
|
- **Privilege:** **unprivileged**
|
|
- **Resources:** 1 core / 512 MiB RAM / 8 GiB rootfs
|
|
- **Mounts:** none from `/mnt/library`
|
|
- **Public hostname:** none
|
|
|
|
## Stack
|
|
|
|
Repo `dtoro/claudio-bot`, checkout at `/opt/claudio-bot`, systemd unit `claudio-bot.service`. Connects to Matrix at `http://192.168.8.239:8008` (direct LAN to [synapse (118)](../118-elementsynapse.md), avoids hairpin-NAT TLS issue on `matrix.hubris.network`).
|
|
|
|
Room: `!dEUVJArVKPorxHHJZK:avispero` (invite-only, `@dtoro:avispero` allowed).
|
|
|
|
## Configuration
|
|
|
|
Secrets at `/etc/claudio-bot/` (mode 600):
|
|
- `config.yaml`
|
|
- `matrix.token`
|
|
- `anthropic.key`
|
|
- `lmstudio.key`
|
|
- `ipc.token`
|
|
|
|
Deploy git creds at `/etc/claudio-deploy/git-credentials`.
|
|
|
|
### LLM backend (pluggable)
|
|
|
|
`llm.backend` in `config.yaml`:
|
|
- `anthropic` — Claude API via `anthropic.key`
|
|
- `lmstudio` — OpenAI-compat HTTP via `lmstudio.key` (bearer)
|
|
|
|
Currently set to `lmstudio` → `google/gemma-4-e4b` on the Mac mini at `192.168.8.174:1234` (since 2026-04-25). Switch back with `backend:` + `systemctl restart claudio-bot`. Original config saved at `/etc/claudio-bot/config.yaml.bak`. The LM Studio agent in `bot_core/lmstudio.py` translates Anthropic → OpenAI tool definitions.
|
|
|
|
## IPC
|
|
|
|
`http://192.168.8.230:9090/{notify,propose,status}`. Header `X-Bot-Token` must match `/etc/claudio-bot/ipc.token`. Used by:
|
|
- [claudio-monitor on hubris](../../infrastructure/monitoring.md) for edge-triggered alerts (token in `/etc/claudio-monitor/bot.token`)
|
|
- The (currently disabled) [restic backup wrapper](../../infrastructure/backups.md) (token in `/etc/restic/bot.token`)
|
|
|
|
> Token files at the source side **must hold the same value as `/etc/claudio-bot/ipc.token`** — rotate together.
|
|
|
|
## Plugins
|
|
|
|
Module under `plugins/<name>.py` exposing a `Plugin` class; add `<name>` to `plugins:` in `config.yaml`. Plugins can register slash commands, Claude tools, and `on_notify` / `on_proposal_response` hooks.
|
|
|
|
Active plugins:
|
|
- `system` — `ping`, `help`, `status`, `list_plugins`
|
|
- `backup` — ingests `/notify` from the backup wrapper (currently silent — backups disabled)
|
|
- `monitor` — `/monitor status`, `/monitor history [N]`, `/monitor clear <key>`. Tools: `get_alerts`, `get_monitor_history` for NL queries via Claude.
|
|
|
|
## Auto-deploy
|
|
|
|
Push to `dtoro/claudio-bot` → gitea webhook → `http://192.168.8.230:9797/deploy` → pull + `pip install` + restart. Same shape as caddy-conf.
|
|
|
|
`app.ini` `ALLOWED_HOST_LIST` on [gitea](../104-gitea.md) includes `192.168.8.230`.
|
|
|
|
## Related
|
|
- [elementsynapse (118)](../118-elementsynapse.md)
|
|
- [Monitoring (claudio-monitor)](../../infrastructure/monitoring.md)
|
|
- [Backups (disabled)](../../infrastructure/backups.md)
|
|
- [Auto-deploy](../../infrastructure/auto-deploy.md)
|
|
|
|
## Changelog
|
|
|
|
### 2026-06-04 — LXC destroyed; replaced by Hermes Agent
|
|
LXC 123 destroyed via `pct destroy 123 --purge`. Bot service stopped, systemd
|
|
units disabled. `dtoro/claudio-bot` and `dtoro/claudio-monitor` archived on
|
|
Gitea. Monitoring replaced by Hermes `homelab-health-watchdog` cron job.
|
|
`@claudio:avispero` Matrix account decommissioned.
|
|
|
|
### 2026-04-28 — wiki entry created
|
|
Initial documentation.
|
|
|
|
### 2026-04-25 — LLM backend switched to LM Studio
|
|
`backend: lmstudio` → `google/gemma-4-e4b` on the Mac mini. Anthropic key still present so the swap is reversible by flipping the config field.
|
|
|
|
### 2026-04-21 — `monitor` plugin added
|
|
Receives events from [claudio-monitor](../../infrastructure/monitoring.md). Slash commands + tools registered. See `dtoro/claudio-bot` commit `e56da25`.
|
|
|
|
### 2026-04-20 — claudio-bot deployed
|
|
LXC 123 provisioned. Repo, systemd unit, Matrix wiring, `system` + `backup` plugins, IPC server.
|