withoneai/cli

One CLI – 让 AI 代理与任意网络服务通信的命令行桥梁

是什么 – 一个基于 Node 的 CLI（one），为 AI 驱动的代理提供统一接口，调用超过 600 个 SaaS 平台（Gmail、Slack、Stripe、Shopify、HubSpot 等）的 API。该工具自动处理认证、OAuth 流程、速率限制和请求格式，因此代理只需知道 想要做什么，而无需了解每个服务的 如何调用。

如何工作

1. 设置 – one init 存储你的 WithOne API 密钥（或通过浏览器登录），并为所使用的 AI 代理（Claude、Cursor 等）安装一个小型的“MCP”服务器。
2. 连接平台 – one add <platform> 执行一次 OAuth 流程，创建一个代表已认证凭证的 connection key。
3. 发现动作 – one actions search <platform> "send email" 返回与自然语言查询匹配的 API 动作列表（由 actionId 标识）。
4. 查看文档 – one actions knowledge <platform> <actionId> 显示精确的请求模式、必需参数和示例。
5. 执行 – one actions execute <platform> <actionId> <connectionKey> -d '{…}' 发送请求，CLI 会自动注入正确的令牌并标准化响应。
6. 组合流程 – 使用 one flow create … 可将多个动作（例如：查找 Stripe 客户然后发送邮件）串联成可重用、条件感知的流程，仅需一条命令即可运行。
7. 内存存储 – one mem … 启动一个本地 PostgreSQL 支持的存储，可保存用户笔记和从连接平台同步的数据，支持代理进行快速的混合全文 + 语义搜索。
8. 同步 – one sync 将平台数据拉取到内存存储中，使代理无需每次调用外部 API 即可查询数据。

主要命令

命令	用途
one init	认证，安装 MCP 服务器，选择全局或项目级配置
one add <platform>	执行 OAuth 并创建连接密钥
one list	显示所有活动连接及其访问策略
one actions search …	通过自然语言描述查找 API 动作
one actions knowledge …	获取特定动作的完整文档
one actions execute …	使用 JSON 数据、路径变量、查询参数等调用动作
one flow create …	定义多步骤工作流（条件、循环、并行步骤）
one flow execute …	运行已保存的工作流
one mem …	管理本地统一内存存储（添加、搜索、列出、导入等）
one sync	将平台数据拉入内存存储以实现即时查询
one cache …	检查或清除 CLI 的动作元数据缓存

对 AI 代理的意义

• 无需管理 API 密钥 – 代理只需一个 connection key；CLI 在后台自动注入 OAuth 令牌。
• 统一接口 – 所有平台以相同结构（方法、路径、JSON 模式）暴露动作，使单一 LLM 提示模板可在任何地方使用。
• 安全性 – 访问策略可按范围（全部、方法级、显式白名单）设置，代理在尝试调用前即可知晓权限。
• 可组合工作流 – 复杂业务逻辑（例如：“当新 Stripe 客户出现时，发送欢迎邮件”）可表示为流程文件，由代理程序化触发。
• 本地内存 – 将数据同步到 PostgreSQL 存储，使代理获得快速、可搜索的上下文，无需重复远程调用，并支持通过 OpenAI 嵌入实现可选语义搜索。

安装

# 一次性安装
npx @withone/cli@latest init
# 或全局安装
npm install -g @withone/cli
one init   # 然后按照交互式提示操作

需要 Node 18+；one sync 需要 Node 20，因为它使用预构建的 SQLite 二进制文件。

典型用例

one add gmail                     # OAuth 一次，获取连接密钥
one actions search gmail "send email" -t execute
# 假设返回的 action ID 为 12345
one actions execute gmail 12345 <key> -d '{"to":"jane@example.com","subject":"Hi","body":"Hello"}'

仅用几条命令，代理就发送了一封经过认证的邮件，而无需处理 OAuth 令牌或学习 Gmail 的 REST 规范。

---

总结 – One CLI 是一个实用工具，抽象了数百个 SaaS API 的底层复杂性，为 AI 代理提供了一种干净、安全且可编程的方式来操作现实世界的服务。