用途：该技能用于在自托管 Coolify v4 服务器上部署并自托管 Paperclip（开源 AI 智能体编排面板，以组织架构图方式管理智能体、任务与预算）。仅覆盖 Coolify v4，不涉及 Railway、Heroku 等其他 PaaS。
前提条件：运行中的 Coolify v4 服务器且侧边栏服务器可达（绿点）；服务器具备 Docker/Buildx；至少 2 GB 内存、2 CPU 核、10 GB 磁盘；OpenCode 需能访问 Coolify MCP 工具（coolify_*）。
主要流程（8 个阶段）：1) 发现 Coolify 基础设施，确定服务器 IP、sslip.io 或自定义域名，默认 FQDN 为 http://paperclip.<SERVER_IP>.sslip.io；2) 创建或选择项目与 production 环境；3) 创建应用资源，build_pack 为 dockerfile，仓库 https://github.com/paperclipai/paperclip，分支必须为 master（非 main），端口 3100，并设置 FQDN、确保非静态站点；4) 配置环境变量 HOST=0.0.0.0、PAPERCLIP_HOME=/paperclip、PAPERCLIP_PUBLIC_URL、BETTER_AUTH_SECRET（64 位十六进制，可用 openssl rand -hex 32 生成）、PAPERCLIP_ALLOWED_HOSTNAMES，可选 PAPERCLIP_TELEMETRY_DISABLED=1；5) 配置持久化存储，将主机目录挂载到容器 /paperclip；6) 预防已知问题：卷权限（sudo chown -R 1000:1000 /data/coolify/applications/YOUR_APP_UUID 与 chmod -R u+rwX）与健康检查失败（建议关闭健康检查或调大重试与启动等待）；7) 部署并查看日志；8) 部署后初始化：docker exec -it --user node CONTAINER_ID pnpm paperclipai onboard，选择 Quickstart，不立即启动，复制 CEO 邀请链接；若未输出链接则运行 pnpm paperclipai auth bootstrap-ceo。
验证与排查：curl http://paperclip.<IP>.sslip.io 应返回前端 HTML；常见问题包括分支错误、EACCES 权限、容器不健康、DNS 延迟、FQDN 与 PAPERCLIP_PUBLIC_URL/ALLOWED_HOSTNAMES 不一致导致邀请链接失效。
限制：资料未提供收费、价格、性能指标与平台兼容性细节；测试环境为 Coolify v4（截至 2026-04 的稳定版/4.x beta）。