Community연구 & 데이터 분석github.com

ClickClack

ClickClack 운영: 채팅 앱, Hetzner 배포, DNS/문서/앱, Docker 롤아웃.

ClickClack란 무엇인가요?

이 스킬은 ClickClack이라는 자체 호스팅 가능한 Slack 스타일 채팅 애플리케이션의 운영, 배포 및 유지 관리를 자동화합니다. 주로 개발자 도구 및 AI 에이전트 워크플로우에 사용되며, Hetzner 클라우드 서버(clickclack-prod-01)에서 Docker 컨테이너로 실행됩니다. 배포 절차는 git archive를 통한 클린 소스 전송, Docker 이미지 빌드, 무중단 컨테이너 교체, SQLite 데이터베이스 백업 등을 포함합니다. 또한 Caddy 리버스 프록시 설정, DNS 레코드 관리, 제품 사이트(clickclack.chat), 호스팅 앱(app.clickclack.chat), 문서 사이트(docs.clickclack.chat)의 상태 확인 기능을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/clickclack

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ClickClack은(는) 무엇을 하나요?

ClickClack 제품/런타임 운영, 배포, 호스팅 앱 확인, 도메인 질문에 사용합니다.

개요

  • 저장소: ~/Projects/clickclack / https://github.com/openclaw/clickclack
  • 제품: OpenClaw/커뮤니티/에이전트 워크플로우를 위한 자체 호스팅 가능한 Slack 스타일 채팅
  • Surface:
    • https://clickclack.chat 제품 사이트
    • https://app.clickclack.chat 호스팅 앱
    • https://docs.clickclack.chat GitHub Pages 문서 (docs/)

프로덕션

  • Hetzner: clickclack-prod-01
  • IPv4: 157.90.237.80
  • IPv6: 2a01:4f8:1c1c:fb96::/64
  • SSH: [email protected]
  • 레이블: app=clickclack, env=prod
  • OS: Ubuntu 24.04, Caddy + Docker
  • 호스트 소스: /opt/clickclack-src (git 체크아웃이 아닌 클린 내보내기)
  • 이전 소스: /opt/clickclack-src.prev + 타임스탬프가 붙은 이전 디렉토리들
  • 데이터: /var/lib/clickclack (bind-mounted to /app/data)
  • 컨테이너: clickclack, 포트 127.0.0.1:8080->8080
  • Caddy: /etc/caddy/Caddyfile이 clickclack.chat, app.clickclack.chat을 127.0.0.1:8080으로 프록시; www는 apex로 리디렉션
  • DNS 진실: ~/Projects/manager/DOMAINS.md 및 ~/Projects/manager/DNS.md

배포

황금 경로:

  1. 로컬 새로고침:
    • cd ~/Projects/clickclack
    • git status --short --branch
    • git fetch origin
    • main 브랜치에 있고 업스트림이 없으면: git merge --ff-only origin/main
  2. 배포 델타 확인:
    • 마지막 배포는 pull 전의 이전 로컬 HEAD일 수 있음; /opt/clickclack-src/.deploy-commit 파일이 있으면 확인
    • git log --oneline <old>..HEAD
    • git diff --stat <old>..HEAD
  3. 클린 HEAD만 아카이브:
    • 로컬의 추적되지 않는 파일은 rsync하지 않음
    • 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. 비밀을 출력하지 않고 환경 변수 보존:
    • docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
  5. 마이그레이션 전 백업:
    • 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. 빌드:
    • docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
  7. 컨테이너 교체:
    • 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. 소스 디렉토리 순환:
    • 이전 /opt/clickclack-src.prev를 타임스탬프 백업으로 이동
    • /opt/clickclack-src를 /opt/clickclack-src.prev로 이동
    • /opt/clickclack-src.next를 /opt/clickclack-src로 이동

확인

  • 호스트:
    • 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
  • 공개:
    • curl -I https://clickclack.chat
    • curl -I https://app.clickclack.chat
    • curl -I https://docs.clickclack.chat

가드레일

  • OAuth 시크릿이나 매직 토큰을 출력하지 마십시오.
  • 로컬 SSH 호스트 키 상태가 오래된 경우 일회용 UserKnownHostsFile을 사용하십시오; 먼저 hcloud server describe clickclack-prod-01로 서버 ID를 확인하십시오.
  • clickclack serve는 부팅 시 마이그레이션을 실행합니다; 컨테이너를 교체하기 전에 항상 SQLite를 백업하십시오.
  • 더티 워킹 트리가 아닌 클린 git archive에서 배포하십시오.

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.

관련 스킬