OpenClaw Coolify 技能指南

OpenClaw Coolify 技能概述

Coolify 技能 通过 REST API 将 OpenClaw 连接到你的 Coolify 实例。安装后，你的 OpenClaw 智能体可以部署应用、管理数据库、配置环境变量以及监控服务 — 一切通过自然语言命令完成。

Coolify 是一个开源的、可自托管的 Vercel、Heroku 和 Netlify 替代方案。它可以让你在自有服务器上部署静态站点、全栈应用、数据库以及 280+ 一键服务。借助 OpenClaw Coolify 技能，你可以享受托管平台的便捷性，同时完全掌控自己的基础设施和数据。

典型工作流：

1. 让 OpenClaw 将最新更改部署到预发布服务器。
2. 智能体调用 Coolify API，在关联的项目上触发部署。
3. 构建状态和日志以可读的摘要形式返回 — 无需打开 Coolify 控制面板。

Coolify 技能安装前的准备

在安装 Coolify 技能之前，请确保你已具备：

• 已安装并运行 OpenClaw（v1.0+）
• 在服务器上运行的 Coolify 实例 — 安装指南
• 从 Coolify 控制面板生成的 Coolify API 令牌
• 在 Coolify 中至少配置了一个应用或服务
• 已安装 clawhub CLI 用于技能管理

验证你的环境：

# 检查 OpenClaw 版本
openclaw --version

# 验证 Coolify 是否可访问（替换为你的实例 URL）
curl -s https://your-coolify-instance.com/api/v1/healthcheck

# 检查 clawhub CLI 版本
clawhub --version

如何安装 Coolify 技能

使用一条命令安装 Coolify 技能：

npx clawhub@latest install coolify

验证安装结果：

clawhub list

你应该能在已安装技能列表中看到 coolify。该技能会在首次使用时提示你输入 Coolify API 端点和令牌。

Coolify 技能配置指南

Coolify 技能需要 API 令牌和你的实例 URL。请在 Coolify 控制面板的 设置 → API 令牌 中生成令牌。

令牌权限

Coolify API 令牌提供对实例的完全访问权限。请遵循最小权限原则：

| 使用场景 | 推荐配置 | |----------|---------------| | 只读监控 | 在具有查看者角色的团队成员账户上创建令牌 | | 完整部署 | 使用管理员令牌，但在确认前审查所有操作 | | 多服务器 | 为每台服务器创建单独的令牌以实现隔离 |

环境配置

# 设置 Coolify 实例 URL
export COOLIFY_BASE_URL=https://your-coolify-instance.com

# 设置 Coolify API 令牌
export COOLIFY_TOKEN=your_api_token_here

重要提示： 切勿将令牌硬编码在配置文件中。请使用环境变量或密钥管理工具，如 1Password 或 Bitwarden。确保将 Coolify 实例更新到最新版本以获取安全补丁。

验证连接

设置环境变量后，验证连接：

# 测试 API 访问
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

Coolify 技能使用示例

1. 部署应用

你： "将我的 Web 应用的最新版本部署到 Coolify。"

智能体会按名称识别你的应用，通过 Coolify API 触发部署，并实时推送构建状态。你会收到包含部署 URL 和构建耗时的摘要。

2. 管理环境变量

你： "将 DATABASE_URL 添加到我的 API 服务的预发布环境中。"

智能体会调用 Coolify API 在指定应用上创建环境变量。你还可以要求列出、更新或批量更新跨环境的变量。该技能会确保敏感值在输出中被脱敏处理。

3. 查看应用日志

你： "显示支付服务最近 100 行日志。"

智能体通过 Coolify API 获取容器日志，并以可读格式呈现。它还能高亮显示错误，并根据常见模式给出修复建议。

4. 重启服务

你： "重启我生产服务器上的 PostgreSQL 数据库。"

智能体会向指定服务发送重启命令。对于生产服务的重启或停止操作，OpenClaw 会在执行前提示你确认。

5. 查看资源使用情况

你： "我的预发布服务器 CPU 和内存使用了多少？"

智能体会查询 Coolify API 获取服务器指标，并提供 CPU、内存和磁盘使用的摘要。当任何资源接近限制时，它会发出告警。

安全与最佳实践

Coolify 技能可以对你的服务器和应用执行写入操作。请遵循以下准则确保安全：

• 使用最小权限。 创建具有最小权限的专用 API 令牌。避免将主管理员令牌用于自动化操作。
• 部署到生产前先审查。 始终先在预发布环境测试部署。OpenClaw 在执行生产部署前会提示你确认。
• 保持 Coolify 更新。 定期更新 Coolify 实例以获取最新的安全补丁 — 从 Coolify 控制面板执行更新或参考官方更新指南。
• 保护你的实例安全。 将 Coolify 部署在防火墙或 VPN 之后。使用强密码并启用双因素认证。
• 轮换 API 令牌。 定期重新生成令牌，并从控制面板撤销未使用的令牌。
• 定期备份。 使用 Coolify 内置的 S3 备份功能来保护你的配置和数据库数据。

常见错误与故障排除

"Connection refused" 或 "ECONNREFUSED"

该技能无法连接到你的 Coolify 实例。

1. 验证 COOLIFY_BASE_URL 是否正确且包含协议前缀（https://）。
2. 检查 Coolify 实例是否正在运行：在服务器上执行 systemctl status coolify。
3. 确保防火墙允许 Coolify 端口（默认：8000）的流量通过。
4. 如果使用 VPN 或 Tailscale，请确认隧道处于活跃状态。

"Unauthorized" 或 "401 Error"

你的 API 令牌无效或已过期。

1. 在 Coolify 控制面板 → 设置 → API 令牌 中检查你的令牌。
2. 如果令牌已被撤销，请重新生成。
3. 验证 COOLIFY_TOKEN 环境变量是否设置正确。

# 验证令牌是否已设置
echo $COOLIFY_TOKEN

# 测试身份认证
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

"Application not found"

该技能无法找到你引用的应用。

1. 列出所有应用：让 OpenClaw "列出我所有的 Coolify 应用"。
2. 检查应用名称或 UUID 是否与 Coolify 控制面板中的一致。
3. 确保你的 API 令牌有权访问拥有该应用的团队。