mcpField
C
clickclack

clickclack

github.com/steipete云与 DevOps7.4k95 次安装1 周前更新
代码仓库

关于 clickclack

clickclack 是面向 ClickClack 产品和运行环境运维的技能，供负责部署、托管应用检查及域名问题的维护者使用。内容涵盖 Cloudflare 部署流程、发布验证和操作注意事项。

主要功能

  1. 01Cloudflare 部署步骤
  2. 02检查托管应用
  3. 03验证发布版本
  4. 04处理域名与 DNS 注意事项

适用场景

  1. 01部署 ClickClack 新版本
  2. 02核对网站是否运行新构建
  3. 03排查部署与域名配置问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/steipete/agent-scripts --skill clickclack

安装后在 Claude Code 中输入/clickclack确认已加载。

附带文件agents/openai.yaml

详细介绍

ClickClack

用于 ClickClack 产品／运行时运维、部署、托管应用检查和域名问题。

内容

  • 仓库：~/Projects/clickclack / https://github.com/openclaw/clickclack
  • 产品：可自托管的 Slack 风格聊天工具，适用于 OpenClaw／社区／Agent 工作流。
  • 入口：
    • https://clickclack.chat 产品网站（Cloudflare Worker 自定义域名）
    • https://www.clickclack.chat（Worker 自定义域名，与上述使用同一 Worker）
    • https://app.clickclack.chat 托管应用（Worker 自定义域名）
    • https://docs.clickclack.chat 来自 docs/ 的 GitHub Pages 文档

生产环境（自 2026-07-05 起使用 Cloudflare）

  • 所有内容都由 OpenClaw 账户（91b59577e757131d68d55a471fe32aca）中的一个 Cloudflare Worker clickclack 承载，前置一个 Cloudflare Container。
  • Worker 和容器配置：wrangler.jsonc（路由通过声明式 custom_domain 条目配置）。
  • 容器：Go 二进制文件和嵌入式 SPA，来自 Dockerfile.cloudflare；数据存储在 Supabase Postgres（CLICKCLACK_DB 密钥）和 R2 上传存储桶（clickclack-uploads）。
  • 区域 clickclack.chat 的 ID 为 e7f93ba1ec24d75ce60c468bbaba5cb5（OpenClaw 账户）。docs CNAME → openclaw.github.io 保持仅 DNS 模式。
  • 1Password（OpenClaw 保险库）："Cloudflare ClickClack deploy token"（api_token 字段；限定于 Workers，不含 DNS 编辑权限）、"Cloudflare ClickClack R2 uploads"。
  • 旧版 Hetzner 主机 clickclack-prod-01（157.90.237.80）不再承载任何 DNS；确认无误后停用。旧版运行手册见本文件的 git 历史记录。

部署

  1. cd ~/Projects/clickclack && git pull --ff-only
  2. Docker 必须正在运行（OrbStack：open -a OrbStack）。
  3. pnpm deploy:cloudflare（通过 wrangler login OAuth 登录，或将 1Password 部署令牌设为 CLOUDFLARE_API_TOKEN 进行身份验证）。
  4. **发布注意事项：**容器实例只要仍有流量，就不会被替换；在公开网站上，sleepAfter=10m 永远不会生效。修改 wrangler.jsonc 中的 CLICKCLACK_CONTAINER_NAME（使用日期命名，例如 prod-YYYYMMDD-open-org），然后重新部署，以便在新镜像上强制启动一个新实例。容器是无状态的（Postgres／R2），因此切换是安全的。
  5. 提交对 wrangler.jsonc 的修改。

验证

  • curl -s https://clickclack.chat/ | grep -oE 'entry/app\.[A-Za-z0-9_-]+\.js' — 哈希必须与刚部署的构建版本一致（与 https://clickclack.services-91b.workers.dev 对比）。
  • 对 https://app.clickclack.chat 和 https://www.clickclack.chat 执行相同检查。
  • pnpm exec wrangler containers info a03b3158-bcfd-4962-9a86-e75489f4e803 — 检查运行状况和镜像摘要。
  • curl -I https://docs.clickclack.chat

注意事项

  • 不要输出 OAuth 密钥或魔法令牌。
  • 部署令牌没有 DNS 权限；更改 DNS 记录需要通过控制面板或使用 Zone.DNS 令牌。
  • 仅从干净的 git 检出进行部署，不要使用有未提交改动的工作树。

评论

支持 Markdown