← 返回 Skills 市场
vishalj99

Surface Cli

作者 Vishal Jain · GitHub ↗ · v0.3.5 · MIT-0
cross-platform ✓ 安全检测通过
185
总下载
0
收藏
0
当前安装
9
版本数
在 OpenClaw 中安装
/install surface-cli
功能描述
Use the Surface mail CLI to read and act on Gmail and Outlook mail through one JSON-first contract. Prefer this skill when you need Outlook access for school...
安全使用建议
This skill appears to do what it says: it drives the 'surface' CLI to access Gmail/Outlook and stores state in ~/.surface-cli. Before installing or granting the agent autonomous access: 1) Inspect the npm package and source (the SKILL points to a GitHub repo) — check package.json scripts and recent commits; npm install can run arbitrary code. 2) Manually run and test 'surface' commands yourself (account add, auth login, fetch-unread) to confirm behavior before allowing an agent to run them. 3) Be cautious about enabling summarization/backends: the SKILL warns that enabling an external summarizer may send email content to a third-party model provider — only enable with explicit user consent. 4) Verify the CLI’s storage location (~/.surface-cli) and review stored tokens/credentials; treat those as sensitive. 5) If you need stronger assurance, request the exact npm tarball SHA or a signed release, or run the install in an isolated environment first. Note: metadata shows a minor version mismatch between the manifest (0.3.2) and the registry metadata (0.3.5); confirm you are installing the intended version.
功能分析
Type: OpenClaw Skill Name: surface-cli Version: 0.3.5 The skill provides a legitimate interface for the 'surface-cli' tool to manage Gmail and Outlook accounts. The SKILL.md file includes comprehensive safety guidelines, explicitly instructing the agent to respect local write-safety policies, obtain user consent before enabling privacy-sensitive summarization features, and use draft modes for testing. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
能力评估
Purpose & Capability
Name/description, required binary ('surface'), and the install spec (npm package 'surface-cli' that creates the 'surface' binary) align. The skill's declared purpose (Gmail/Outlook via a JSON CLI) reasonably requires the listed binary and local state.
Instruction Scope
SKILL.md contains only surface CLI commands and guidance for account setup, polling, and thread watching. It references the local config/state directory (~/.surface-cli) and warns about optional summarization backends that may send thread content to external model providers. The instructions do not direct reading of unrelated system files or unrelated credentials, but they do rely on local auth tokens and local state.
Install Mechanism
Installation is via npm (package 'surface-cli'), which is an expected and reasonable distribution method for a CLI distributed as a Node package. npm installs can run package install scripts and introduce arbitrary code on install — a moderate risk. No direct downloads from arbitrary URLs or extract-from-unknown-host steps are present.
Credentials
The skill declares no required environment variables or external credentials. It does require the user to authenticate accounts (Gmail/Outlook) through the CLI; those tokens are stored locally under ~/.surface-cli. That is proportionate to an email CLI.
Persistence & Privilege
always is false, and the skill does not request system-wide privileges or attempt to modify other skills. The CLI will store local state in ~/.surface-cli (expected for an email client). Autonomous invocation is allowed (platform default) but not a special privilege of this skill.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install surface-cli
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /surface-cli 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.3.5
Add watcher recipes, polling cadence guidance, and passive-watch vs triage read-state guidance; publish from synced OpenClaw workspace skill copy.
v0.3.4
Add watcher recipes, polling cadence guidance, and passive-watch vs triage read-state guidance; republish from committed skill state.
v0.3.3
Add watcher recipes, polling cadence guidance, and read-state rules for passive watching vs unread triage.
v0.3.2
Clarify summarization as user-controlled opt-in and remove model-specific config edit guidance.
v0.3.1
Republish with explicit install metadata and clearer local credential/config guidance.
v0.3.0
Adds GPT-5.4 mini summaries, ME-scoped action flags, warm Outlook sessions, thread refresh/search improvements, and parallel-read guidance.
v0.2.0
Add thread refresh and structured mail search filters
v0.1.1
Refresh ClawHub metadata and install guidance
v0.1.0
Initial Surface CLI skill release
元数据
Slug surface-cli
版本 0.3.5
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 9
常见问题

Surface Cli 是什么?

Use the Surface mail CLI to read and act on Gmail and Outlook mail through one JSON-first contract. Prefer this skill when you need Outlook access for school... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 185 次。

如何安装 Surface Cli?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install surface-cli」即可一键安装,无需额外配置。

Surface Cli 是免费的吗?

是的,Surface Cli 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Surface Cli 支持哪些平台?

Surface Cli 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Surface Cli?

由 Vishal Jain(@vishalj99)开发并维护,当前版本 v0.3.5。

💬 留言讨论