关于 gate-cli-installer
gate-cli-installer 为 Cursor、Claude Code、Codex 和 OpenClaw 提供 gate-cli 与 gate-skills 的安装说明。它包含 CLI 安装、技能配置、认证设置和旧版 MCP 迁移步骤。
主要功能
- 01安装并校验 gate-cli
- 02支持指定 CLI 版本
- 03为客户端安装 gate-skills
- 04通过向导配置 API 凭据
- 05提供旧版 MCP 迁移命令
适用场景
- 01在受支持的客户端配置 Gate 工具
- 02安装指定版本的 gate-cli
- 03初始化 CLI API 密钥
- 04清理旧版 Gate MCP 配置
MCP 相关
该安装流程以 gate-cli 和 gate-skills 为主,不要求配置旧版 Gate MCP。对于希望迁移旧配置的用户,提供可选的 gate-cli migrate 命令。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ gate/ gate-skills --skill gate-cli-installer安装后在 Claude Code 中输入/gate-cli-installer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
CHANGELOG.mdREADME.mdsetup.sh详细介绍
gate-cli-installer(Cursor / Claude Code / Codex / OpenClaw)
通用规则
⚠️ 停止 — 继续操作前,必须阅读并严格遵循共享运行时规则。这些规则具有最高优先级。
→ 阅读 gate-runtime-rules.md
- 不要在此流程中记录或要求设置旧版 Gate MCP 服务。受支持的路径是
gate-cli+ gate-skills。 - 如果用户以前使用过 Gate MCP,可选择运行
gate-cli migrate进行清理(见下文 Legacy MCP)——不要让迁移阻碍全新的gate-cli+ skills 安装。
哪个 gate-cli 会运行(Agent / Shell)
规范规则(与 gate-runtime-rules.md §4 中的文本相同):
- 优先使用系统二进制文件: 如果
command -v gate-cli找到可执行文件,并且gate-cli --version执行成功,则在所有地方都将其作为gate-cli使用。 - 用户本地 bin: 如果第 1 步失败,且
${HOME}/.local/bin/gate-cli存在并且可执行,则本次会话中的gate-cli指"${HOME}/.local/bin/gate-cli"(如果 PATH 可能不完整,请使用完整路径调用)。 - OpenClaw skills bin: 如果第 1–2 步均失败,且
${HOME}/.openclaw/skills/bin/gate-cli存在并且可执行,则gate-cli指"${HOME}/.openclaw/skills/bin/gate-cli"。
不要假设只存在一个安装位置——在报告“找不到 gate-cli”之前,始终按此顺序进行查找。共享的 gate-runtime-rules.md §4 中也包含相同规则。
要安装的内容(两部分)
gate-cli— 用于 CEX、信息、新闻、配置和诊断的 Gate CLI。使用此技能中的setup.sh安装(见下文)。- gate-skills — 来自 https://github.com/gate/gate-skills 的 Agent 技能。使用客户端的常规技能工作流(
npx skills add …或复制到对应客户端的技能目录)。
1. 安装 gate-cli(setup.sh)
脚本路径:skills/gate-cli-installer/setup.sh
该脚本会下载适用于你的操作系统和架构的最新 gate/gate-cli 版本,验证校验和,并安装 gate-cli 二进制文件。
# From the gate-skills (or gate-github-skills) repo root
bash skills/gate-cli-installer/setup.sh
# Optional: pin a release tag
bash skills/gate-cli-installer/setup.sh --version v0.6.0
让 gate-cli 可通过 PATH 使用(系统 / Shell):
setup.sh会优先安装到${HOME}/.local/bin/gate-cli。如果~/.local/bin尚未加入PATH,脚本会提醒你添加:
export PATH="$HOME/.local/bin:$PATH"
将其写入~/.zshrc、~/.bashrc或你的 Shell 配置文件,然后重启终端或source该文件。- 如果无法写入
~/.local/bin,脚本会回退到/usr/local/bin(在 macOS/Linux 上通常已加入PATH)。 - 较旧的安装可能会留下
${HOME}/.openclaw/skills/bin/gate-cli;Agent 仍必须按照上文的 哪个gate-cli会运行 规则查找gate-cli——不要假设它只位于一个目录中。
验证
command -v gate-cli
gate-cli --version
2. 安装 gate-skills(按客户端)
| 客户端 | 常见技能位置 | 常见方式 |
|---|---|---|
| Cursor | ~/.cursor/skills/ | 例如,运行 npx skills add https://github.com/gate/gate-skills,或将仓库中的技能文件夹复制到该目录 |
| Claude Code | ~/.claude/skills/ | 同上 |
| Codex | ~/.codex/skills/ | 同上 |
| OpenClaw | 例如,~/.openclaw/skills/(默认) | 例如,运行 npx clawhub@latest add https://github.com/gate/gate-skills,或手动复制 |
向用户提供 gate-skills 仓库的链接;如果他们需要逐步的 UI 操作流程,请参阅该仓库 README 中的 Skills Installation 部分。复制或安装技能后,重启客户端以重新加载技能列表。
触发词中的 Gate Verify / tx check-in 表述:这些功能由相关 DEX / 钱包技能中所述的产品技能和基于 gate-cli 的流程提供,而不是通过此安装程序执行单独的 MCP 安装步骤。
3. API 密钥和错误 → gate-cli config init
- 当
gate-cli返回身份验证或配置错误(缺少密钥、密钥无效、401 等)时,引导用户以交互方式运行gate-cli config init。该向导会在 CLI 配置中设置 API key 和 secret(不要要求用户在聊天中粘贴密钥)。 - 在浏览器中创建密钥:Gate API key management。
- 可选:如果用户更喜欢非交互式配置,可以使用
gate-cli config set api-key .../config set api-secret ...(仍要避免在聊天中回显密钥)。 - 如需进行更全面的检查:
gate-cli doctor。
4. 旧版 MCP(可选)
如果用户的 IDE 配置中仍有旧的 Gate MCP 条目,并希望转向以 CLI 为先的工具:
gate-cli migrate --dry-run
# Then when satisfied:
gate-cli migrate --apply
这不能替代安装 gate-cli 和 gate-skills;这只是可选的清理操作。
5. 取代关系(命名 / 文档)
此技能为 Cursor、Claude Code、Codex 和 OpenClaw 提供 gate-cli + skills 一键安装方案。同一仓库中可能仍保留旧版“MCP-only”安装程序文档,以实现向后兼容;新用户应优先采用 setup.sh + 技能安装 + gate-cli config init。