Ramus Android

Ramus android-use

面向编码 Agent 的 Android-use，由 Ramus 提供支持。为 Claude Code、Codex、Cursor、Gemini CLI 或任何带有 shell 的 Agent 提供一个可随时销毁的云端 Android 模拟器，Agent 可以查看屏幕、点击、输入、截屏和读取日志；随后你可以在浏览器中观看或接管操作。

此插件连接到 Ramus 托管服务。你需要一个 Ramus 账户（Alpha 期间免费）或 60 分钟的 CLI 试用。

安装

Claude Code，作为插件安装（包含 android-use 技能和 Ramus MCP 服务；系统会询问是否提供可选的 API 密钥）：

/plugin marketplace add ramus-dev/android-use
/plugin install ramus@ramus

Cursor、Codex、GitHub Copilot、Kiro 和其他 Agent Plugins 客户端：将此仓库作为插件安装（根目录中的 plugin.json）。

任何支持技能的 Agent，都可以通过 skills CLI 安装：

npx skills add ramus-dev/android-use

Claude Code，手动安装：将 skills/android-use/SKILL.md 复制到 .claude/skills/android-use/SKILL.md。

Gemini CLI，作为扩展安装（包含技能和 Ramus MCP 服务）：

gemini extensions install https://github.com/ramus-dev/android-use

任何 MCP 客户端（Cline、Claude Desktop、Cursor、Windsurf、VS Code），均可将其作为远程服务使用。采用 Streamable HTTP，无需本地进程：

{
  "mcpServers": {
    "ramus": {
      "url": "https://api.ramus.dev/api/mcp",
      "headers": { "Authorization": "Bearer <RAMUS_API_KEY>" }
    }
  }
}

在 https://ramus.dev/settings 创建密钥。该服务提供 android_* 工具（从演示应用或拉取请求启动会话、获取 UI 树快照、点击、输入、按键、等待、截屏、查看日志、共享）；使用 tools/list 列出这些工具。本地 APK 上传和开发循环需要使用下方的 CLI。

试用无需账户：

npx ramus-cli trial
npx ramus-cli session start --apk app-debug.apk --wait

ChatGPT 和 Codex（OpenAI 插件）

同一仓库也是 OpenAI 插件包：plugin.json 在 extensions.com.openai 下包含目录列表，mcp.json 指向 远程 MCP 服务（用户通过登录 Ramus 连接；无需 API 密钥），而 各项技能会在 skills/*/agents/openai.yaml 中声明其运行位置。 OpenAI 插件包仅包含 android-mcp（MCP 工具、ChatGPT 和 Codex）： android-use 通过 shell 驱动 CLI，OpenAI 的技能扫描会对此发出警告， 因此 scripts/package-openai.py 会将其排除。

为 OpenAI 插件门户构建上传包（“With MCP”路径）：

python3 scripts/package-openai.py   # validates, then writes dist/ramus-openai-plugin.zip

该脚本会根据 OpenAI 的限制检查目录列表，并排除供其他客户端使用的文件。

工作原理

设备是运行原版 Google 镜像的真实 Android 模拟器，位于 Ramus 设备集群上，并通过 WebRTC 进行串流。该技能会教 Agent 遵循观察、操作、验证的循环：读取 UI 树快照，对引用的元素执行操作，然后检查结果再继续。

链接

• 文档：https://ramus.dev/docs/agents

• Agent 参考：https://ramus.dev/agents.md

• MCP 端点（Streamable HTTP，API 密钥）：https://api.ramus.dev/api/mcp

• npm 上的 CLI：https://www.npmjs.com/package/ramus-cli

• 隐私政策：https://ramus.dev/privacy

• 条款：https://ramus.dev/terms

• 可接受使用政策：https://ramus.dev/acceptable-use

• 支持：[email protected] · 安全：[email protected]

仅支持 Android。Alpha 期间免费。用于测试你构建或获授权测试的应用。

SKILL.md 根据 Ramus 产品契约生成；规范版本托管于 https://ramus.dev/skill.md。