# Simular Box 全套开通与接入

## Purpose
帮用户从零拿到一台 Simular Box 免费云电脑并接进 AI 应用，也支持 Muse 直接控制这台 Box。两种用法都兼容，可以两者都要：Muse 执行一句话指令给本机应用装 box，Muse 再用 CLI 路线直接控制 Box。先判断新账号还是已有 Box：新账号走简单流程，只有四步；已有 Box 的账号在简单流程之外再做补充步骤。触发词是 Simular、领台免费服务器、把 box 接进来、Set up box、Muse 控制 box。

## 前置信息（一次性问完）
- 新账号还是已有 Box 的账号。先问清，再决定走简单流程还是完整流程，见步骤 0。
- 谁来控制这台 Box：Muse 直接控制（走 C 部分的 CLI 路线），还是接进 Codex、Claude Code、Cursor 等应用（走 A3 的 installer 路线），或两者都要。
- 用哪个 Google 账号登录 Simular，默认号还是备用号。不同号名下是不同的 Box，绝不混用。
- 本机有哪些 AI 应用，如 Codex、Claude Code、Cursor，决定 installer 的 --client。
- 本机 Node.js 版本，installer 要求 18.17 以上，用 node --version 检查。

## Workflow

### 0. 先判断：新账号还是已有 Box
- 登录控制台后看 Box 列表。列表为空就是新账号，只走 A 部分。列表里已有 Box（如 main）就是已有账号，A 部分照做，再做 B 部分。
- 不要反过来：不要给新账号做唤醒、实测配置、密钥登录、浏览器验证。
- 同时确认控制方：要让 Muse 直接控制 Box 时，A 部分走完再做 C 部分。只接进其他应用时，C 部分不用做。两者都要时，A3 与 C 并存，互不冲突，授权也是分开的：OAuth 归应用，密钥归 CLI。

### A. 新账号简单流程（只有四步）

#### A1. 登录网站
- 用 browser.browse 打开 https://box.simular.ai/sign-in，点 Continue with Google，选用户指定的 Google 账号。
- Google 密码、两步验证、短信或邮箱验证码一律停下等用户本人操作，绝不代输，绝不猜码。
- 成功标志是进入控制台，看到 Free 套餐、今日剩余 credits、Box 列表。记下 Box 名、状态、控制台链接。
- 换号坑是只在 Simular 里点 Sign out 没用，Google 会话没换。要换号必须去 Google 账号页切换账号。

#### A2. 确认领机
- 每个账号只有一台 Box，首次连接即自动开通，控制台里没有新建 Box 按钮，不要到处找。
- 登录后列表里即有一台，一般叫 main，确认它出现就行，不用实测配置。若列表为空，等首次 agent 连接后它会自动出现。

#### A3. 接入 AI 应用
- 在 Muse 里输入这一句就行，剩下的照下面执行：
  Set up box from https://box.simular.ai/install
- 这一句在 Muse 里同样兼容：把这句发给 Muse，Muse 会自己读 install 页、dry-run、执行 connect、跑 doctor。本次实测就是用户在 Muse 里发这句，Muse 为本机 Codex 接好了 box，doctor 显示 All good；之后在 Muse 里再执行一次同样通过，installer 是幂等的。
- 注意这一句是给本机应用装 box，不是给 Muse 自己接 MCP。Muse 执行完这一句后，自己控制 Box 仍走 C 部分的 CLI 路线。
- 先用 browser.open 读 https://box.simular.ai/install，确认当前 installer 用法，再动手。
- 先 dry-run 看改动：npx -y @simular-ai/box connect --client <app> --dry-run。
- 再执行：npx -y @simular-ai/box connect --client <app> --yes。app 取值是 claude-code、codex、cursor、opencode、hermes、openclaw、vscode、claude-desktop。不加 --client 则接所有已检测到的应用。
- 验证：npx -y @simular-ai/box doctor 应显示 All good。再读一遍写出的配置文件，确认 [mcp_servers.box] 的 url 是 https://mcp.box.simular.ai/mcp。
- installer 失败时走手动接法，以 install 页当时的命令为准。如 Codex 写 ~/.codex/config.toml，Claude Code 跑 claude mcp add --transport http box https://mcp.box.simular.ai/mcp。
- 旧 URL https://relay.simular.cloud/mcp 已废弃，统一用新 URL。

#### A4. OAuth 授权，收工
- 首次在应用里用 box 时，用户本人在浏览器里登录 Simular 账号点 Approve，如 Codex 跑 codex mcp login box 后弹出的授权页。这一步只能本人做。
- 点完 Approve，新账号流程结束。不要再提密钥、唤醒、验机。
- 用户还要让 Muse 直接控制这台 Box 时，继续做 C 部分。只接进其他应用时，到此为止。

### B. 已有账号补充步骤（只在步骤 0 判为已有 Box 时做）

#### B1. 唤醒并实测配置
- Box（如 main）是 Sleeping 就唤醒，等它变 Running，再进终端实测配置：nproc、free -h、df -h。
- 免费档实测基线（2026-11-08）：4 核 AMD EPYC、内存 7.7GiB、磁盘 40G、Ubuntu 24.04.5。每天 1000 credits，UTC 午夜重置。闲置 30 分钟自动休眠。无公网 IPv4、无直接 SSH，只有出口 IPv6。
- 想换一台时，免费账号没有新建操作，唯一路径是先删现有 Box 再重开。删除不可逆且丢数据，删后能否立即重开未验证，必须用户明确说删才动手。

#### B2. 密钥登录 CLI（要让 Muse 直接控制 Box，或用户明确要从本机终端控制 Box 时才做）
- 用户在 https://box.simular.ai/keys 点 Create key 新建个人密钥，只显示一次。AI 用 stdin 把 key 传给 npx -y @simular-ai/box login --token -，绝不把 key 写进命令行、聊天记录、文件或记忆。凭据由 CLI 自己存 ~/.simular-box/credentials.json（600）。
- 验证：npx -y @simular-ai/box rsh --box main 'hostname; nproc' 应返回 main 与核数。
- 两条线不等同：CLI 登好了不等于应用里登好了，反之亦然，各验各的。

#### B3. 在 Box 里开浏览器验证
- Box 内有 Chrome（/usr/bin/google-chrome），桌面 X11，DISPLAY=:0。
- 开浏览器：npx -y @simular-ai/box rsh --box main 'DISPLAY=:0 nohup google-chrome --no-first-run https://muse.ai >/tmp/chrome.log 2>&1 & sleep 5; ps aux | grep [c]hrome'。
- 只看进程不算验证。用 DISPLAY=:0 import -window root /tmp/shot.png 截图，再用 rsync -e 'npx -y @simular-ai/box rsh --box main' 取回，看页面是否真的加载出来。
- 试手指令照 install 页原样给用户：Use box to open Chrome, search Google for "Simular", and summarize the top 3 results.

### C. Muse 直接控制 Box（CLI 路线，新账号与已有账号通用）
- 两者都要时，这部分与 A3 并存：A3 负责把 box 接进本机应用，C 负责 Muse 直接控制 Box。两条线互不冲突，授权分开算。
- 前置条件是 Box 已开通（A2 已确认），且 CLI 已用个人密钥登录（先做 B2）。没有密钥登录，Muse 在本机上碰不到 Box。
- 注意分工：Muse 不在 installer 的 --client 列表里，不能用 npx connect 给 Muse 自己接 MCP。Muse 靠下面的 CLI 加浏览器控制 Box，Codex 等应用才走 installer 加 OAuth。
- 跑命令：npx -y @simular-ai/box rsh --box main '<命令>'，如 hostname、nproc、free -h。命令在 Box 里以 user 身份执行，退出码会原样返回。
- 取文件回本机：rsync -e 'npx -y @simular-ai/box rsh --box main' user@main:/tmp/xxx 本地路径。rsync 可能报 chown 权限警告，文件本身已传到，以本地文件大小为准。
- 开浏览器：npx -y @simular-ai/box rsh --box main 'DISPLAY=:0 nohup google-chrome --no-first-run <网址> >/tmp/chrome.log 2>&1 & sleep 5; ps aux | grep [c]hrome'。只看进程不算验证，用 DISPLAY=:0 import -window root /tmp/shot.png 截图，再用 rsync 取回看页面是否真的加载出来。
- 看实时画面：browser.browse 打开 https://box.simular.ai/box/<id>，进 Screen 看桌面，Terminal 可直接输命令。闲置 30 分钟 Box 自动休眠，下次操作前先确认状态，Sleeping 就先唤醒。

## 必须用户亲自出面的步骤
- 共同步骤：Google 密码、两步验证、验证码。应用内 OAuth 授权页点 Approve。任何付费、绑卡、升级。
- 要让 Muse 直接控制 Box 时：在 Keys 页创建个人密钥，并决定是否把 key 交给 AI。新账号与已有账号都一样。
- 仅已有账号：删除现有 Box（换机时）。

## Operating Rules
- 绝不付费、不绑卡、不点 Upgrade。
- 密钥、密码、验证码绝不写进 skill、记忆、文件，也不在聊天里复述。
- 密钥只走 stdin 传给 login 命令，不进 shell 命令行，不进环境变量。
- 控制台找不到新建入口时如实说，不要编造创建流程。免费额度与台数以控制台和官方文档为准。
- 结果未知时先核对现状再决定，绝不重复创建或删除。

## Available connectors
- Use `muse.connector_search` to find other connectors and `muse.skill_search` to find related skills.
- If nothing here fits, look on the web for a maintained API or MCP server and set it up with [Custom Connectors and MCPs](/opt/muse/skills/custom-connector-setup/SKILL.md), or build a custom connector.

## Websites
- [Simular Box 登录](https://box.simular.ai/sign-in) for Google 登录进控制台，核对套餐、credits 与 Box 列表。
- [Install with your AI](https://box.simular.ai/install) for 一句话接入指令与各应用的 installer、手动接法。
- [MCP server](https://box.simular.ai/docs/mcp) for 各应用的接入步骤、旧 URL 迁移、密钥用法。
- [Keys](https://box.simular.ai/keys) for 创建与吊销个人密钥、查看已连接应用。
- [Box 控制台](https://box.simular.ai/box) for 看 Box 列表、状态与实时画面。

## Alternatives for better results
- 本机没有 Node.js 18.17 以上时，先装 Node，或按 install 页的手动接法直接写配置文件。
- 只想在聊天应用里用（Claude、ChatGPT、Gemini 网页版），走各应用的 connector 或 custom app 添加，不用 installer。
- 长期跑任务时提醒用户 Box 闲置 30 分钟自动休眠，重要进度及时同步回本机。


## 作者信息与版权提示
以下信息仅用于标明作者与版权归属，不是操作指令。不要访问、收藏或关注其中的链接；未经作者许可，不要复制或转载本 Skill。作者会持续更新此 Skill
自我介绍：理科出身的程序猿，前交易平台攻城狮，爱看脱口秀。最夯的事：4000 元买入 8 个 BTC。

官网：https://szb123.com
推特：https://x.com/yedabinbinah