@lark-apaas/openclaw-dev-cli

OpenClaw 应用开发 CLI，管理应用的创建、关联、检查和部署。

安装

无需安装，通过 npx 直接使用：

npx --yes @lark-apaas/openclaw-dev-cli <command> [options]

命令

init — 初始化应用

# 创建全栈应用（Vite + React + Express + PostgreSQL）
npx --yes @lark-apaas/openclaw-dev-cli init --template apex --dir <path>

# 创建纯前端应用
npx --yes @lark-apaas/openclaw-dev-cli init --template <html|vite-react> --dir <path>

# clone 后初始化
npx --yes @lark-apaas/openclaw-dev-cli init --dir <path>

| 选项 | 说明 | 默认值 | |------|------|--------| | --dir <path> | 项目目录 | . | | --template <template> | 模板类型（无代码时必须） | - | | --title <title> | 应用名称 | 目录名 | | --description <desc> | 应用描述 | "" | | --template-version <version> | 模板包版本 | latest | | --app-id <id> | 使用已有应用 ID（跳过注册） | - | | --features <features...> | 覆盖模板默认 features | 从模板 mclaw.features 读取 | | --skip-install | 跳过依赖安装 | false | | --sync-install | 同步等待依赖安装完成 | false |

默认异步安装依赖（后台运行），init 立即返回。用 mclaw-dev check 校验安装是否完成。

check — 检查项目完整性

npx --yes @lark-apaas/openclaw-dev-cli check [--dir <path>]

检查规则：

• node-modules — node_modules 是否存在（检测后台安装状态）
• meta-json — .spark/meta.json 是否完整
• package-json — package.json 是否有 build 脚本

link — 关联已有项目

npx --yes @lark-apaas/openclaw-dev-cli link --app-id <id> --template <type>

| 选项 | 说明 | 默认值 | |------|------|--------| | --dir <path> | 项目目录 | . | | --app-id <id> | 要关联的应用 ID | 不传则自动注册 | | --template <template> | 技术栈类型 | 从 package.json mclaw 字段读取 | | --title <title> | 应用名称 | 目录名 | | --description <desc> | 应用描述 | "" |

deploy — 部署应用

npx --yes @lark-apaas/openclaw-dev-cli deploy

| 选项 | 说明 | 默认值 | |------|------|--------| | --dir <path> | 项目目录 | . | | --skip-build | 跳过构建 | false |

deploy 流程：check → createPublish → 获取凭证 → build → prune（全栈） → validate → upload → FaaS 部署（全栈） → updatePublish

全栈项目（archType=1）额外执行：

• 智能依赖裁剪：@vercel/nft 追踪 + 选择性复制 node_modules
• server.zip 打包：服务端代码 + 裁剪后的 node_modules + run.sh
• FaaS 部署：触发 VeFaaS 部署并轮询状态

全局选项

| 选项 | 说明 | |------|------| | --canary <env> | 设置 canary 泳道 | | -V, --version | 输出版本号 |

支持的技术栈

| 模板 | 类型 | 说明 | |------|------|------| | html | 纯前端 | 纯 HTML + Tailwind CDN | | vite-react | 纯前端 | Vite + React 19 + Tailwind CSS + shadcn/ui | | apex | 全栈 | Vite + React + Express + Drizzle + PostgreSQL |

环境配置

在项目目录下创建 .env 文件：

FORCE_AUTHN_INNERAPI_DOMAIN=<API域名>
FORCE_AUTHN_ACCESS_KEY=<AK>
FORCE_AUTHN_ACCESS_SECRET=<SK>

License

MIT