Laravel Cloud API 技能

将整个 Laravel Cloud REST API 封装在一个 bash 脚本中。

设置

选项 1 — 环境变量（推荐）：
bash
export LARAVELCLOUDAPI_TOKEN=你的令牌

选项 2 — 凭据文件：
bash
mkdir -p ~/.openclaw/credentials/laravel-cloud
echo {token:你的令牌} > ~/.openclaw/credentials/laravel-cloud/config.json

在以下位置生成你的令牌：cloud.laravel.com → 设置 → API 令牌

使用方法

bash
laravel-cloud <资源> <操作> [参数...]

快速参考

资源	操作
apps	list, get, create, update, delete
envs

list, get, create, update, delete, start, stop, metrics, logs, vars-add, vars-replace | | commands | list, get, run | | deployments | list, get, initiate | | domains | list, get, create, update, delete, verify | | instances | list, get, sizes, create, update, delete | | bg-processes | list, get, create, update, delete | | databases | clusters, cluster, cluster-create, cluster-update, cluster-delete, cluster-metrics, types, list, get, create, delete, snapshots, snapshot, snapshot-create, snapshot-delete, restore, dedicated | | caches | list, get, types, create, update, delete, metrics | | buckets | list, get, create, update, delete | | bucket-keys | list, get, create, update, delete | | websockets | list, get, create, update, delete, metrics | | ws-apps | list, get, create, update, delete, metrics | | ips | list | | org | get | | regions | list |

常见示例

bash

列出所有应用

laravel-cloud apps list

创建应用（需要 --repository）

laravel-cloud apps create --name my-app --region us-east-1 --repository owner/repo

列出应用的环境

laravel-cloud envs list <应用ID>

创建环境

laravel-cloud envs create <应用ID> --name Production --branch main

启动/停止环境

laravel-cloud envs start <环境ID> laravel-cloud envs stop <环境ID>

查看环境指标和日志

laravel-cloud envs metrics <环境ID> --period 24h laravel-cloud envs logs <环境ID>

设置环境变量

laravel-cloud envs vars-add <环境ID> --vars APPKEY=base64:...,DBHOST=localhost laravel-cloud envs vars-replace <环境ID> --vars KEY1=val1,KEY2=val2

触发部署

laravel-cloud deployments initiate <环境ID>

运行 Artisan 命令

laravel-cloud commands run <环境ID> --command php artisan migrate --force

获取组织和区域信息

laravel-cloud org get laravel-cloud regions list

管理数据库

注意：创建集群会自动创建一个main数据库（模式）。

使用该默认数据库——不要额外创建。通过以下方式将main模式

连接到你的环境：envs update <环境ID> --database-schema-id

查找模式ID：databases cluster <集群ID>（使用 ?include=schemas）

laravel-cloud databases clusters

数据库类型：laravelmysql84, laravelmysql8, neonserverlesspostgres16/17/18, awsrdsmysql8, awsrdspostgres_18

laravel-cloud databases cluster-create --name my-db --type laravelmysql84 --region us-east-1 --size db-flex.m-1vcpu-512mb --storage 5

管理缓存

laravel-cloud caches list

缓存类型：upstashredis（大小：250mb, 1gb, ...）或 laravelvalkey（大小：valkey-pro.250mb, ...）

laravel-cloud caches create --name my-cache --type laravel_valkey --region us-east-1 --size valkey-pro.250mb

对象存储

laravel-cloud buckets list laravel-cloud buckets create --name my-bucket --region us-east-1

WebSocket 集群

laravel-cloud websockets list laravel-cloud ws-apps list

按资源查看帮助

laravel-cloud help laravel-cloud envs help laravel-cloud databases help

依赖项

• - curl — HTTP 请求
• jq — JSON 解析和美化输出