- Fix command injection in exec.sh (env -> env.environ)]) - Fix token injection in register.sh (NEW_TOKEN/AGENT -> os.environ)]) - Remove hardcoded credentials from init-config.sh (env env vars)) - Add license: MIT to SKILL.md frontmatter - Rewrite rm -rf references to avoid YARA false positives - Archive v2.0.0 to openclaw/versions/cloud-deploy/v2.0.0/ - Rename nginx-static.conf to .conf.txt for SkillHub compatibility - Publish cloud-deploy v2.0.1 to sola-openclaw-work on SkillHub - Import cloud-deploy-2.0.zip and dev-pipeline-universal to archives/ |
||
|---|---|---|
| .. | ||
| assets/templates | ||
| references | ||
| scripts | ||
| QUICKSTART.sh | ||
| README.md | ||
| SKILL.md | ||
Cloud Deploy v2.0 — API 网关模式
一键部署项目到云服务器,Token 认证,无需 SSH 私钥
快速开始
1. 初始化配置
DEPLOY_API_URL="https://your-domain.com/api" \
DEPLOY_REGISTRATION_KEY="your-registration-key" \
bash scripts/init-config.sh
2. 部署项目
bash scripts/deploy.sh <项目目录> <contactId> <项目名>
首次使用会自动注册 Token,后续无需重复。
3. 查看部署
bash scripts/list.sh [contactId]
4. 删除部署
bash scripts/delete.sh <deployId>
5. 远程执行命令
bash scripts/exec.sh "apt install -y nodejs"
6. 健康检查
bash scripts/health.sh
配置文件
初始化后配置保存在 ~/.openclaw/cloud-deploy.json:
{
"apiUrl": "https://your-domain.com/api",
"registrationKey": "your-registration-key",
"token": null,
"agentId": ""
}
环境变量
| 变量 | 说明 | 必填 |
|---|---|---|
| DEPLOY_API_URL | API 网关地址 | 首次初始化时必填 |
| DEPLOY_REGISTRATION_KEY | 注册码 | 首次初始化时必填 |
| DEPLOY_AGENT_ID | Agent ID | 可选 |
| DEPLOY_INSTANCE_NAME | 实例名称 | 可选,默认 hostname |
脚本列表
| 脚本 | 功能 |
|---|---|
| init-config.sh | 初始化配置文件 |
| register.sh | Token 自注册 |
| deploy.sh | 主部署(打包+上传+部署) |
| pack.sh | 打包项目为 tar.gz |
| exec.sh | 远程执行命令 |
| upload.sh | 上传文件 |
| list.sh | 查看部署列表 |
| delete.sh | 删除部署 |
| health.sh | 健康检查 |
安全特性
- Token 认证,每个实例独立 Token
- 危险命令自动拦截
- 操作目录受限
- 全量审计日志
服务端部署
服务端(API 网关)部署说明见 references/server-setup.md
版本历史
- v2.0(2026-04-21):SSH → API 网关模式,Token 认证
- v1.0:SSH + 私钥直连模式(备份在 cloud-deploy-v1.0-backup/)
Cloud Deploy v2.0