Ranla CLI

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install ranla-cli
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 ranla-cli。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Ranla CLI 让 AI 代理通过 Ranla 自己的命令界面操作 Ranla 账户，包括营销活动、细分群体、页面、广告和 Reddit 工作流程。代理无需索取 API 密钥，而是启动基于浏览器的登录流程；CLI 会在本地保存凭据，因此代理不会看到凭据。
此技能专为安全且由用户指示的操作而设计，鼓励先阅读命令架构，并在写入之前起草或提议变更。任何发送、发布或花费资金的操作都必须由用户确认。作为用于营销运营的 Openclaw Skills 之一，它将终端访问与明确的工作区选择和审批控制结合起来。

应用场景

列出或起草 Ranla 营销活动，并在更改前查看可用字段。
使用 Ranla 原生命令创建或检查受众细分群体。
使用 Ranla 页面、广告、Reddit 任务及其他支持的命令类别。
检查待审批卡片，并向用户展示其摘要和应用链接。
登录选定的 Ranla 工作区，无需索取或暴露 API 密钥。
brain
命令检查 Ranla 使用的模型密钥配置。

工作原理

使用 npx -y ranla-cli@latest login 启动基于浏览器的身份验证；CLI 会返回验证网址和用户代码。
将网址和代码提供给用户。用户登录、确认代码、选择工作区并批准访问。
用户确认批准后，再次运行 login，并通过 whoami 验证已登录身份和工作区。
如果账户有多个工作区，列出工作区并询问用户要使用哪一个；明确选择它，或在单次调用时传入 --workspace。
调用命令前，使用 run help 检查可用命令及其输入架构。通过 --input、--file 或标准输入提交一个 JSON 对象。
检查 JSON 结果。对于涉及发送、发布或花费资金的操作，展示审批摘要，并在批准或拒绝待处理卡片前询问用户。
用户要求时注销，以撤销 CLI 凭据并将其从计算机中删除。

配置指南

每次调用都使用最新的软件包版本；如果用户已全局安装 CLI，也可以使用 ranla。
npx -y ranla-cli@latest login
将返回的 verification_url 和 user_code 提供给用户。不要索取用户密码或 API 密钥。用户在浏览器中批准后，完成登录并检查当前账户：
npx -y ranla-cli@latest login
npx -y ranla-cli@latest whoami
对于拥有多个工作区的账户，应先让用户选择，再选定工作区：
npx -y ranla-cli@latest workspaces list
npx -y ranla-cli@latest workspaces use ""
操作前先发现命令并确认必填字段，然后以 JSON 对象提供输入：
npx -y ranla-cli@latest run help
npx -y ranla-cli@latest run help
npx -y ranla-cli@latest run --input '{"field":"value"}'
也可以使用 --file input.json 或 --input - 从文件或标准输入提供输入。输出通过管道传递时，结果为 JSON。退出代码 0 表示成功，1 表示操作失败，2 表示命令行语法无效；应根据错误消息修正命令，而不是猜测。要退出登录：
npx -y ranla-cli@latest logout

数据架构

此技能不定义单独的本地项目数据库或生成文件格式。它使用 Ranla CLI 命令和 JSON 输入/输出。
数据或元数据 组织与处理方式
命令输入 使用 --input、--file 或标准输入传递的单个 JSON 对象。使用 run help 查看确切架构。
命令结果 通过管道传递时为 JSON；失败时会在 stderr 提供消息。
登录状态 浏览器批准后，CLI 会在本地保存凭据。代理不得打印、记录或提交凭据。
工作区上下文 每次登录对应一个工作区。用户可以列出并选择工作区，或在单次调用时使用 --workspace "" 指定工作区。
审批卡片 待处理操作包含消息 ID、摘要和应用网址；使用 approvals list 或 approvals get 检查。
模型配置 brain 会报告 Ranla 使用的是 Included，还是工作区提供的 OpenRouter、Anthropic、OpenAI 或 Google 密钥。添加密钥由用户负责。

高级特性

基于浏览器的登录无需用户粘贴 API 密钥；凭据由 CLI 管理。
支持感知工作区的操作，可明确选择工作区，也可为单次调用指定工作区。代理不得代替用户选择工作区。
命令发现功能会显示可用的名词、动词和输入字段，有助于避免猜测或格式错误的操作。
审批工作流程让代理能够列出或检查待处理卡片，并且仅在用户作出决定后批准或拒绝。部分付款审批必须在应用中完成。
安全指南要求在执行会花费资金、发送消息或发布内容的操作前获得用户确认，即使命令不会暂停等待审批也不例外。
brain
命令会报告 Ranla 的模型密钥设置。用户必须自行添加提供商密钥；代理绝不能索取、暴露密钥或通过命令传递密钥。
logout
会撤销 CLI 凭据，并将其从当前计算机中删除。

name: ranla-cli description: >- Drive Ranla from the terminal with ranla-cli — sign in through the browser
(no API key to paste), run Ranla's own commands (campaign, segment, page,
ads, reddit, …) and handle approval cards. Use when the user wants an agent
to work their Ranla account: list or draft campaigns, build segments, check
approvals, or anything Ranla does in chat.
license: MIT