openclaw-easy-deploy

Name: openclaw-easy-deploy
Author: JFroson0610

Verified

OpenClaw Companion / OpenClaw 中文助手：中英双语、安全编排官方 OpenClaw 安装、配置、检查、升级、备份与诊断。社区项目，非官方。

107stars

11forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/JFroson0610/openclaw-easy-deploy

Getting Started

Guides for using ai agents skills like openclaw-easy-deploy.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 9/2/2026

{
  "issues": [
    {
      "file": "README.md",
      "line": 79,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/JFroson0610/openclaw-easy-deploy/ma\"",
      "severity": "low"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-09-02T08:27:56.338Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is openclaw-easy-deploy?

openclaw-easy-deploy is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by JFroson0610. OpenClaw Companion / OpenClaw 中文助手：中英双语、安全编排官方 OpenClaw 安装、配置、检查、升级、备份与诊断。社区项目，非官方。. It has 107 GitHub stars.

Is openclaw-easy-deploy safe to use?

Yes. openclaw-easy-deploy passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install openclaw-easy-deploy?

Clone the repository with "git clone https://github.com/JFroson0610/openclaw-easy-deploy" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is openclaw-easy-deploy written in?

openclaw-easy-deploy is primarily written in TypeScript. It is open-source under JFroson0610 on GitHub, so you can review or fork the full source.

Are there alternatives to openclaw-easy-deploy?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh openclaw-easy-deploy against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

245,895

omegacode valmis

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

OpenClaw Companion | OpenClaw 中文助手

面向普通用户的中英双语 OpenClaw 运维助手：安全编排官方安装、配置、检查、升级、备份、修复与诊断流程。

A bilingual operations companion that safely orchestrates official OpenClaw setup, checks, upgrades, backups, repairs, and diagnostics.

中文 · English

[!IMPORTANT] v2 发布状态： 2.0.0-beta.1 已发布到 npm，推荐明确使用 openclaw-companion@next 安装。正式版仍需完成至少 14 天 Beta 观察，并解决所有 P0/P1 安全或安装问题。

v2 release status: 2.0.0-beta.1 is available from npm. Install the explicit openclaw-companion@next tag. The stable release still requires at least 14 days of Beta observation and no unresolved P0/P1 security or installation issue.

[!WARNING] 这是社区项目，并非 OpenClaw 官方产品。OpenClaw 名称、商标和上游代码归其各自权利人所有。

This is a community project, not an official OpenClaw product. The OpenClaw name, trademarks, and upstream code belong to their respective owners.

中文

它解决什么问题

OpenClaw 已经提供安装器、配置向导、Doctor、更新、备份和诊断工具。OpenClaw Companion 不重复实现这些能力，而是把官方命令组合成更容易理解、更不容易误操作的流程。

你
└─ OpenClaw Companion：中文说明、影响预览、确认、结果归一化
   └─ OpenClaw 官方 CLI：安装、认证、配置、更新、备份、修复、诊断
      └─ 你的本地 OpenClaw 数据

适合 Windows、macOS、Ubuntu 和 Debian 上的零基础或轻度技术用户。它不是 Web 面板、桌面 GUI、OpenClaw Fork，也不会运行自己的后台服务。

核心能力

能力	Companion 做什么	安全边界
设置	检查环境，突出 Qwen、Kimi、DeepSeek、MiniMax 和飞书，启动官方向导	不接收或保存密钥
检查	汇总 OpenClaw 版本、更新、Gateway、Doctor 和可选渠道探测	只读
升级	更新预览 → 验证备份 → 用户确认 → 官方更新 → 升级后检查	备份失败立即停止
备份	调用官方 `backup create --verify`	不自行复制运行中的 SQLite
修复	先运行只读 Doctor，展示影响并备份，再确认修复和重启	不静默修改配置
支持	调用官方脱敏诊断导出并显示本地路径	不自动上传

所有自有提示均提供简体中文和英文。语言优先级为：--lang → OPENCLAW_COMPANION_LANG → 系统语言 → English。

安装

前置条件：

Windows 10/11、macOS 13+、Ubuntu 22.04/24.04 或 Debian 12。
Node.js 22.22.3+、24.15+、25.9+ 或 26；明确不支持 Node 23。
OpenClaw 2026.5.29 或更高版本；若缺失，兼容启动器会在确认后调用官方安装器。

当前 Beta：

npm install -g openclaw-companion@next
openclaw-companion setup --lang zh-CN

npm 会为全新包的首次发布自动建立 latest 标签，因此不带标签目前也会得到这个 Beta。为清楚表达用途并方便未来切换，测试用户请始终显式使用 @next。正式版完成观察期后才会正式推广无标签安装：

npm install -g openclaw-companion
openclaw-companion setup --lang zh-CN

旧版一键链接保持有效，并会通过主分支安装新版 Companion：

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/JFroson0610/openclaw-easy-deploy/main/install.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/JFroson0610/openclaw-easy-deploy/main/install.ps1 | iex

远程脚本会先请求确认；建议先下载并检查内容再执行。它默认使用 npm 官方源，只有官方源失败且用户明确同意时，才为当前安装进程临时使用 registry.npmmirror.com，不会运行 npm config set。

从源码运行：

git clone https://github.com/JFroson0610/openclaw-easy-deploy.git
cd openclaw-easy-deploy
pnpm install --frozen-lockfile
pnpm build
node dist/cli.js check --json

完整步骤见中文安装指南。

命令

不带参数运行 openclaw-companion 与运行 openclaw-companion menu 相同。

命令	行为	是否修改状态
`menu`	打开双语交互菜单	取决于所选操作
`setup`	检查环境并启动官方模型/飞书向导	是，官方向导负责
`check`	汇总版本、更新、Gateway、模型/渠道状态和 Doctor	否
`upgrade`	预览、备份、更新并执行升级后检查	是，确认后
`backup`	创建并验证官方备份	是，仅写备份文件
`repair`	检查、展示影响、备份并逐项确认修复	是，确认后
`support`	在本地生成官方脱敏诊断包	是，仅写本地文件

常用示例：

openclaw-companion check
openclaw-companion check --deep
openclaw-companion check --json
openclaw-companion check --json --strict
openclaw-companion upgrade --dry-run
openclaw-companion upgrade --channel beta
openclaw-companion backup --output ./backups
openclaw-companion repair --dry-run
openclaw-companion support --output ./support

全局参数：

参数	说明
`--lang auto\|zh-CN\|en`	选择界面语言
`--json`	输出机器可读结果；交互式 `setup` 仅支持 `--dry-run --json` 预览
`--verbose`	显示经过脱敏的官方命令原始输出
`--yes`	仅跳过明确的交互确认，不能跳过升级前备份
`--dry-run`	预览安装、升级、修复或备份动作
`--strict`	`check` 出现 warning 时也返回非零退出码
`--deep`	`check` 额外执行渠道网络探测
`--output <路径>`	指定备份或诊断包位置
`--channel stable\|beta`	指定官方 OpenClaw 更新通道

`check --json`

稳定输出结构：

{
  "schemaVersion": 1,
  "generatedAt": "2026-09-01T00:00:00.000Z",
  "locale": "zh-CN",
  "openclawVersion": "2026.8.1",
  "overall": "warning",
  "checks": [
    {
      "id": "openclaw/update",
      "status": "warning",
      "summary": "检测到 OpenClaw 有可用更新。",
      "sourceCommand": "openclaw update status --json",
      "fixHint": "请先运行官方安装器或升级到当前稳定版。"
    }
  ]
}

退出码：

0：命令完成，检查没有 error；--strict 下也没有 warning。
1：检查完成，但发现 error；--strict 下 warning 也返回 1。
2：参数、运行环境或官方命令无法启动，CLI 无法正常执行。

解析采用向前兼容策略：忽略官方 JSON 新增字段；遇到缺失字段或非 JSON 输出时降级为 warning，而不是崩溃。Gateway 不可达、Doctor error、严重安全发现和更新可用状态会被单独识别。

中国区模型与飞书

setup 首页突出当前有官方接入路径的 Qwen、Moonshot/Kimi、DeepSeek、MiniMax 和飞书，认证仍由 openclaw onboard、openclaw configure 或 openclaw channels login 完成。

项目不会承诺尚无官方稳定插件的微信、企业微信或钉钉入口；其他模型和渠道使用 OpenClaw 完整官方向导。

安全与隐私

Companion 不读取、接收、保存或记录 API Key、Bot Token、Cookie、密码或聊天内容。
认证输入直接发生在 OpenClaw 官方交互流程中。
默认不保存运行日志；--verbose 输出会脱敏常见密钥、授权头、Cookie、URL 查询令牌和私钥内容。
诊断包只保存在本地。官方已执行脱敏，但分享前仍应自行检查。
更新失败不会自动恢复；CLI 会保留备份位置并提示使用官方恢复流程。
不包含应用内遥测。项目数据只来自 npm、GitHub Stars/Forks、Issues、Releases 和 CI。

详见 Security Policy。

开发与验证

pnpm install --frozen-lockfile
pnpm check
pnpm audit --audit-level high
pnpm pack --dry-run

PR 会在 Windows、macOS、Ubuntu、Debian 和受支持的 Node.js 版本上运行模拟测试；每晚无密钥安装 OpenClaw 稳定版并执行隔离 smoke test。测试不连接真实模型，也不会产生 API 费用。

历史 v1 源码和恢复点保留在 v1.0.0。迁移说明见 v1 → v2。

English

What it solves

OpenClaw already ships installers, onboarding, Doctor, update, backup, and diagnostics tooling. OpenClaw Companion does not reimplement those capabilities. It combines official commands into workflows that are easier to understand and harder to misuse.

You
└─ OpenClaw Companion: localized guidance, impact previews, confirmation, normalized results
   └─ Official OpenClaw CLI: install, authenticate, configure, update, back up, repair, diagnose
      └─ Your local OpenClaw data

It is designed for new and lightly technical users on Windows, macOS, Ubuntu, and Debian. It is not a web panel, desktop GUI, OpenClaw fork, or separately maintained background service.

Core capabilities

Capability	What Companion does	Safety boundary
Setup	Checks the environment, highlights Qwen, Kimi, DeepSeek, MiniMax, and Feishu, then opens official flows	Never accepts or stores credentials
Check	Combines version, update, Gateway, Doctor, and optional channel probes	Read-only
Upgrade	Preview → verified backup → confirmation → official update → post-upgrade checks	Stops when backup fails
Backup	Calls official `backup create --verify`	Never copies live SQLite files itself
Repair	Runs read-only Doctor, explains impact, backs up, then confirms repair and restart separately	No silent configuration changes
Support	Calls the official sanitized diagnostics exporter and reports the local path	Never uploads automatically

All Companion-owned prompts are available in English and Simplified Chinese. Locale priority is --lang → OPENCLAW_COMPANION_LANG → system locale → English.

Installation

Requirements:

Windows 10/11, macOS 13+, Ubuntu 22.04/24.04, or Debian 12.
Node.js 22.22.3+, 24.15+, 25.9+, or 26; Node 23 is explicitly unsupported.
OpenClaw 2026.5.29 or newer. When it is missing, the compatibility launcher asks before invoking the official installer.

Current Beta:

npm install -g openclaw-companion@next
openclaw-companion setup

The npm registry automatically creates a latest tag for the first release of a new package, so an untagged install currently resolves to this Beta as well. Testers should explicitly use @next to make their intent clear and ease the later transition. Untagged installation will be promoted only after the stable-release gate is complete:

npm install -g openclaw-companion
openclaw-companion setup

The legacy one-command URLs remain valid and install the new Companion from the default branch:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/JFroson0610/openclaw-easy-deploy/main/install.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/JFroson0610/openclaw-easy-deploy/main/install.ps1 | iex

Inspect remote scripts before executing them. The launcher uses the official npm registry by default. If that registry fails, it can use registry.npmmirror.com for the current process only after explicit consent; it never runs npm config set.

Run from source:

git clone https://github.com/JFroson0610/openclaw-easy-deploy.git
cd openclaw-easy-deploy
pnpm install --frozen-lockfile
pnpm build
node dist/cli.js check --json

Commands

Running openclaw-companion without a command is equivalent to openclaw-companion menu.

Command	Behavior	Mutates state?
`menu`	Opens the bilingual interactive menu	Depends on the selected action
`setup`