Skip to content

README.zh-CN.md

Latest commit

 

History

History
223 lines (165 loc) · 5.84 KB

README.zh-CN.md

File metadata and controls

223 lines (165 loc) · 5.84 KB
Raw

OpenCLI Skill

English | 中文

OpenCLI Skill Banner

一个面向多种 AI agent 环境的 OpenCLI skill，帮助 agent 用更稳定、可发现、只读优先的方式调用 OpenCLI。

仓库地址：GloriaGuo/opencli-skill

这个 skill 是做什么的

OpenCLI 本身覆盖了很多能力：

  • 公共数据命令
  • 浏览器登录态复用的网站适配器
  • Electron 桌面应用适配器
  • 本地 CLI passthrough
  • 站点适配器生成

这个 skill 的目标不是重复官方 README，而是让 agent 在真实任务里更稳定地做对这些事：

  • 先发现本机实际安装的命令面
  • 再选择正确的站点、桌面应用或 CLI 路径
  • 优先使用结构化输出
  • 在浏览器场景里优先检查 Browser Bridge 和登录态
  • 在可能写入的场景里默认先读后写

覆盖内容

  • OpenCLI 与 browser agent / Playwright 的选型
  • opencli list -f yaml 的发现式使用方式
  • Chrome 登录态复用的网站命令
  • Codex、Cursor 等桌面应用适配器
  • gh、docker 一类的 passthrough CLI
  • 下载文章、图片、视频
  • OpenCLI adapter 生成与排障
  • OpenClaw / Claude Code / Codex 的安装与调用方式

仓库结构

安装

一键安装

Unix-like shell：

./install.sh codex
./install.sh claude
./install.sh openclaw
./install.sh openclaw-workspace

如果不想先 clone，也可以直接远程执行：

curl -fsSL https://raw.githubusercontent.com/GloriaGuo/opencli-skill/main/install.sh | bash -s -- codex
curl -fsSL https://raw.githubusercontent.com/GloriaGuo/opencli-skill/main/install.sh | bash -s -- claude
curl -fsSL https://raw.githubusercontent.com/GloriaGuo/opencli-skill/main/install.sh | bash -s -- openclaw

PowerShell：

./install.ps1 codex
./install.ps1 claude
./install.ps1 openclaw
./install.ps1 openclaw-workspace

如果不想先 clone，也可以直接远程执行：

irm https://raw.githubusercontent.com/GloriaGuo/opencli-skill/main/install.ps1 | iex

仓库 Banner / 社交预览图

仓库里已经自带两份可直接使用的素材：

上传到 GitHub 的路径是：

  1. 打开仓库页面
  2. 进入 Settings
  3. 在 General 里找到 Social preview
  4. 点击 Upload an image
  5. 选择 assets/social-preview.png

其中 SVG 已经显示在 README 顶部。如果你后面想换成更宽的预览图，可以把 SVG 重新导出为 1280×640 或 2560×1280。

Codex

git clone https://github.com/GloriaGuo/opencli-skill.git "${CODEX_HOME:-$HOME/.codex}/skills/opencli"

Claude Code

git clone https://github.com/GloriaGuo/opencli-skill.git ~/.claude/skills/opencli

OpenClaw

共享安装：

git clone https://github.com/GloriaGuo/opencli-skill.git ~/.openclaw/skills/opencli

workspace 安装：

git clone https://github.com/GloriaGuo/opencli-skill.git ./skills/opencli

推荐的 OpenCLI 环境准备

npm install -g @jackwener/opencli
opencli doctor
opencli list -f yaml

如果要跑浏览器类命令：

  • 保持 Chrome 打开
  • 在 Chrome 中登录目标网站
  • 安装并启用 OpenCLI Browser Bridge 扩展

在 OpenClaw 里推荐的配置

OpenClaw 配置文件：

~/.openclaw/openclaw.json

一个最小可用配置：

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
    entries: {
      opencli: {
        enabled: true,
      },
    },
  },
}

如果你有一个集中维护的 skill 目录：

{
  skills: {
    load: {
      extraDirs: [
        "/Users/you/skill-packs",
      ],
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

快速示例

公共数据：

opencli hackernews top --limit 5 -f json

浏览器站点：

opencli bilibili hot --limit 5 -f json
opencli zhihu search "Android 性能优化" -f json

桌面应用：

opencli codex read -f json
opencli cursor read -f json
opencli cursor ask "总结当前工作区最近一次对话"

推荐从这些文件开始看