mcpField
G
gate-cli-installer

gate-cli-installer

github.com/gateAgent 工作流48106 次安装18 周前更新
代码仓库

关于 gate-cli-installer

gate-cli-installer 为 Cursor、Claude Code、Codex 和 OpenClaw 提供 gate-cli 与 gate-skills 的安装说明。它包含 CLI 安装、技能配置、认证设置和旧版 MCP 迁移步骤。

主要功能

  1. 01安装并校验 gate-cli
  2. 02支持指定 CLI 版本
  3. 03为客户端安装 gate-skills
  4. 04通过向导配置 API 凭据
  5. 05提供旧版 MCP 迁移命令

适用场景

  1. 01在受支持的客户端配置 Gate 工具
  2. 02安装指定版本的 gate-cli
  3. 03初始化 CLI API 密钥
  4. 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.md
README.md
setup.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 中的文本相同):

  1. 优先使用系统二进制文件: 如果 command -v gate-cli 找到可执行文件,并且 gate-cli --version 执行成功,则在所有地方都将其作为 gate-cli 使用。
  2. 用户本地 bin: 如果第 1 步失败,且 ${HOME}/.local/bin/gate-cli 存在并且可执行,则本次会话中的 gate-cli 指 "${HOME}/.local/bin/gate-cli"(如果 PATH 可能不完整,请使用完整路径调用)。
  3. 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 中也包含相同规则。


要安装的内容(两部分)

  1. gate-cli — 用于 CEX、信息、新闻、配置和诊断的 Gate CLI。使用此技能中的 setup.sh 安装(见下文)。
  2. 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。

评论

支持 Markdown