Community研究&データ分析github.com

steipete/clickclack

ClickClack オペレーション:チャットアプリ、Hetzner デプロイ、DNS/ドキュメント/アプリ、Docker ロールアウト。

clickclack とは?

このスキルは、ClickClack 製品のランタイム運用、デプロイ、ホステッドアプリのチェック、およびドメイン関連の質問を管理するために設計されています。ClickClack は、OpenClaw コミュニティやエージェントワークフロー向けのセルフホスト可能な Slack スタイルのチャットアプリケーションです。このスキルは、Hetzner クラウドサーバー上の運用をサポートし、Caddy リバースプロキシの背後で Docker コンテナとしてアプリケーションを実行し、製品サイト、ホステッドアプリ、ドキュメント用の複数のサブドメインを管理します。デプロイは、クリーンな git アーカイブからソースコードを転送し、新しい Docker イメージをビルドし、データ損失を防ぐために SQLite データベースのバックアップを実行し、ダウンタイムを最小限に抑えるためにコンテナをローテーションする、黄金のパスに従います。検証手順には、ホスト上でのカール確認とパブリック URL のテストが含まれ、ガードレールでは、機密シークレットの漏洩を避け、クリーンな git アーカイブからのデプロイを強制し、コンテナの交換前に常にデータベースをバックアップすることを推奨しています。

対応~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 スタイルのチャットアプリ。
  • サーフェス:
    • https://clickclack.chat 製品サイト
    • https://app.clickclack.chat ホステッドアプリ
    • https://docs.clickclack.chat docs/ からの GitHub Pages ドキュメント

本番環境

  • 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 が /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. デプロイされた差分を決定:
    • 最後にデプロイされたコミットは、プル前の古いローカル 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 アーカイブからデプロイを維持します。

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.

関連スキル