steipete/clickclack

Opérations de ClickClack : application de chat, déploiement Hetzner, DNS/docs/app, déploiement Docker.

Qu'est-ce que clickclack ?

Cette compétence est conçue pour gérer les opérations et le déploiement de ClickClack, une application de chat auto-hébergée de type Slack destinée aux workflows d'agents et à la communauté OpenClaw. Elle couvre l'ensemble du cycle de vie : déploiement sur un serveur Hetzner (Ubuntu 24.04, Caddy, Docker), gestion des domaines et du DNS (clickclack.chat, app.clickclack.chat, docs.clickclack.chat), sauvegardes de la base de données SQLite, rotation des répertoires source, et vérifications de l'état de l'application (hôte et public). La compétence guide l'utilisateur pas à pas, de la récupération locale du code Git à la construction de l'image Docker, au remplacement du conteneur et aux tests de bon fonctionnement via des commandes curl. Elle inclut également des garde-fous importants : ne jamais afficher les secrets OAuth, toujours sauvegarder la base de données avant un redéploiement, et n'utiliser que des archives Git propres pour éviter les fichiers locaux non suivis.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/clickclack

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait clickclack ?

Utilisez ceci pour les opérations et déploiements du produit ClickClack, les vérifications de l'application hébergée et les questions relatives aux domaines.

Quoi

  • Dépôt : ~/Projects/clickclack / https://github.com/openclaw/clickclack
  • Produit : chat auto-hébergé de type Slack pour les workflows d'agents et la communauté OpenClaw.
  • Surfaces :
    • https://clickclack.chat site produit
    • https://app.clickclack.chat application hébergée
    • https://docs.clickclack.chat documentation GitHub Pages depuis docs/

Prod

  • Hetzner : clickclack-prod-01
  • IPv4 : 157.90.237.80
  • IPv6 : 2a01:4f8:1c1c:fb96::/64
  • SSH : [email protected]
  • Labels : app=clickclack, env=prod
  • OS : Ubuntu 24.04, Caddy + Docker
  • Source sur l'hôte : /opt/clickclack-src (export propre, pas un checkout git)
  • Source précédente : /opt/clickclack-src.prev plus d'anciens répertoires prev horodatés
  • Données : /var/lib/clickclack monté via bind sur /app/data
  • Conteneur : clickclack, port 127.0.0.1:8080->8080
  • Caddy : /etc/caddy/Caddyfile proxy clickclack.chat, app.clickclack.chat vers 127.0.0.1:8080 ; www redirige vers l'apex.
  • Vérité DNS : ~/Projects/manager/DOMAINS.md et ~/Projects/manager/DNS.md

Déploiement

Chemin doré :

  1. Rafraîchissement local :
    • cd ~/Projects/clickclack
    • git status --short --branch
    • git fetch origin
    • Si sur main sans amont : git merge --ff-only origin/main
  2. Décider du delta déployé :
    • Le dernier déploiement connu peut être l'ancien HEAD local avant le pull ; vérifier /opt/clickclack-src/.deploy-commit s'il existe.
    • git log --oneline <ancien>..HEAD
    • git diff --stat <ancien>..HEAD
  3. Archiver uniquement le HEAD propre :
    • Ne pas rsync les fichiers locaux non suivis.
    • short=$(git rev-parse --short=12 HEAD)
    • git archive --format=tar HEAD | ssh [email protected] "rm -rf /opt/clickclack-src.next && mkdir -p /opt/clickclack-src.next && tar -C /opt/clickclack-src.next -xf - && printf '%s\n' '$short' > /opt/clickclack-src.next/.deploy-commit"
  4. Préserver les variables d'environnement sans imprimer les secrets :
    • docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
  5. Sauvegarder avant les migrations :
    • mkdir -p /var/lib/clickclack/backups
    • chown 1000:1000 /var/lib/clickclack/backups
    • docker exec clickclack clickclack backup --data /app/data --out /app/data/backups/clickclack-before-$(date -u +%Y%m%dT%H%M%SZ).db
  6. Construction :
    • docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
  7. Remplacer le conteneur :
    • docker stop clickclack && docker rm clickclack
    • docker run -d --name clickclack --restart unless-stopped --env-file /root/clickclack.env.current -p 127.0.0.1:8080:8080 -v /var/lib/clickclack:/app/data clickclack:latest serve --addr :8080 --data /app/data
  8. Rotation des répertoires source :
    • Déplacer l'ancien /opt/clickclack-src.prev vers une sauvegarde horodatée.
    • Déplacer /opt/clickclack-src vers /opt/clickclack-src.prev.
    • Déplacer /opt/clickclack-src.next vers /opt/clickclack-src.

Vérification

  • Hôte :
    • docker ps --filter name=clickclack
    • docker inspect clickclack --format '{{index .Config.Labels "org.opencontainers.image.revision"}}'
    • cat /opt/clickclack-src/.deploy-commit
    • curl -fsS http://127.0.0.1:8080/ >/tmp/clickclack-root.html
    • curl -fsS http://127.0.0.1:8080/app >/tmp/clickclack-app.html
  • Public :
    • curl -I https://clickclack.chat
    • curl -I https://app.clickclack.chat
    • curl -I https://docs.clickclack.chat

Garde-fous

  • N'imprimez pas les secrets OAuth ni les jetons magiques.
  • Utilisez un UserKnownHostsFile jetable si l'état de la clé d'hôte SSH locale est obsolète ; confirmez d'abord l'identité du serveur avec hcloud server describe clickclack-prod-01.
  • clickclack serve exécute les migrations au démarrage ; sauvegardez toujours la base de données SQLite avant de remplacer le conteneur.
  • Effectuez les déploiements à partir d'archives Git propres, pas d'arbres de travail sales.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills associés