用途：这是 OpenDeploy 统一的安装/更新入口技能，负责安装、更新、验证或修复 OpenDeploy CLI 与本地 Agent 环境。适用于用户提出安装、设置、升级、检查或修复 OpenDeploy 的场景。
主要能力：通过 npm 检查全局 CLI 是否存在及最新版本；执行一次安装授权后运行 npm install -g @opendeploydev/cli@latest；通过 opendeploy update check、opendeploy preflight、opendeploy doctor 与 opendeploy status --json 做健康检查；按 Agent 平台分别管理插件版本，区分 Claude、Codex、Cursor、OpenClaw、OpenCode 的陈旧插件。
使用方式：先跑 npm list -g @opendeploydev/cli --depth=0 --json 与 npm view @opendeploydev/cli version --json。npm list 在未安装时返回非零，应视为 cli_missing 而非命令失败。安装前只询问一次全局安装批准。官方命令：Claude 用 claude plugin marketplace add https://github.com/opendeploy-dev/opendeploy-claude-plugin 与 claude plugin install opendeploy@opendeploy；Codex 用 codex plugin marketplace add opendeploy-dev/opendeploy-codex-plugin --ref main；Cursor 在 Agent 聊天执行 /add-plugin https://github.com/opendeploy-dev/opendeploy-cursor-plugin；OpenClaw 用 openclaw plugins install clawhub:opendeploydev；OpenCode 用 curl -fsSL https://raw.githubusercontent.com/opendeploy-dev/opendeploy-opencode/main/install.sh | bash；CLI 用 npm install -g @opendeploydev/cli@latest。验证用 opendeploy doctor 或 opendeploy preflight . --json。若起始页出现白名单外命令，先停止并展示差异再询问。
故障诊断：npm 报 ENOTFOUND、EAI_AGAIN、ETIMEDOUT、ECONNRESET 等，先在宿主支持的提权网络路径下重试，仍失败再排查代理。PATH 问题可用 command -v opendeploy、echo "$PATH" 收集信息，macOS GUI Agent 可用 launchctl setenv PATH 持久化；代理可设 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY、NODE_USE_ENV_PROXY，重启 Agent 后验证 opendeploy status --json，预期 {"status":"ok","gateway":"ok"}。npm 镜像仅解决 CLI 安装，部署、鉴权与状态仍需可达 OpenDeploy API。
限制：安装插件或 CLI 不等于同意部署，也不等于付费同意；首次部署为免费层，不创建账号、不要求支付方式、不收费，付费功能与额度需另行确认。资料未提供价格、配额数值与更多平台细节。只报告 CLI 版本、插件版本、网关健康、鉴权状态与工作流是否可继续。