Agentrix Mobile 用户手册（v1.1.x）

适用版本：v1.1.0 及以上（2026-06 商店发布） 平台：iOS 15.1+ / Android 11+（Wear OS 单独手册） 文档状态：初稿，配图待补 反馈渠道：App 内 「设置 → 反馈」 / support@agentrix.top

目录

• 快速上手
• 1. 安装与启动
• 2. 邀请码（首次启动必需）
• 3. 4-Tab 主结构
• 4. Home Tab 详解
• 5. Summon Tab 详解
• 6. Plaza Tab 详解
• 7. Me Tab 详解
• 8. 多端联动（扫码绑桌面端）
• 9. NFC 盲盒兑换
• 10. Toy 玩具配对
• 11. 系统助手集成
• 12. 隐私与遥测
• 13. 自动更新（OTA）
• 14. 故障排除
• 附录 A：版本历史

0. 快速上手（三步搞定）

[安装 App] → [输入邀请码] → [选灵狐 + 完成 Onboarding]
                                         ↓
              4 个底部 Tab：Home · Summon · Plaza · Me

之后的常用动作：

• 首页主宠 3D → 单击直接进入语音聊天
• 🔔 铃铛（顶部右上）→ 全局收件箱（贺卡 / 共养 / 通知）
• 📷 扫码（顶部右上）→ 扫桌面端登录二维码 / NFC 兑换 / 加好友
• 每天签到 → +20 AXP 起，连续签到 +5/天（最多 +100）

1. 安装与启动

1.1 下载

文件大小约 80 MB（含本地 Whisper / llama.rn 模型壳，模型按需下载）。

1.2 首次启动顺序

SplashScreen (1.5s)
   ↓
LoginScreen
   ↓ (登录成功)
InvitationGateScreen        ← 见 §2
   ↓ (邀请码兑换成功)
OnboardingNavigator         ← 选灵狐 + 同意条款
   ↓ (完成)
MainTabNavigator (Home Tab) ← 进入主界面

启动 → 进入主界面通常 < 5 秒（取决于网络与本地模型加载状态）。

1.3 登录方式

LoginScreen 提供 4 种登录方式：

同一账号在多端登录是多端通用的：手机 + 桌面 + 网页 + Watch 共用一个账号 + AXP 余额 + 主宠资产。详见 §8。

2. 邀请码（首次启动必需）

2.1 为什么有邀请码

V1 / V2 内测期间，邀请码用于：

1. 流量控制 — 避免冷启动期被刷量
2. 身份预付 — 邀请码批次（batch）+ 渠道（channel）字段帮我们追溯每个用户的来源
3. 防滥用 — 配合每天签到 / 推荐奖励等机制

2.2 邀请码规则

2.3 跨端通用情况

核心结论：

2.4 已知 P2 问题

当前邀请码体系的局限（运营记录在 MOBILE_GO_LIVE_AUDIT_2026-05-16.zh-CN.md）：

• 邀请码字段没有"绑定账号后是否解绑"的概念 — 一个号一旦通过 invitation，永久持有该状态
• 桌面 / 网页端无独立邀请校验，意味着有移动端账号的人 = 有所有端的访问权
• 公开测试期可能取消邀请门，运营态决定（默认配置 INVITATION_GATE_ENABLED=true）

3. 4-Tab 主结构

3.1 底部 Tab 导航

3.2 顶部全局元素（在 Home / Summon / Plaza 都可见）

Me Tab 没有顶部按钮（已让位给个人头像 + 用户名）。

4. Home Tab 详解

4.1 主宠 3D 区域（屏幕上半部分）

3D 渲染回退策略：< 4 GB RAM 设备 → SVG fallback；4-8 GB → Rive 2D；≥ 8 GB → VRM 3D。可在「设置 → 性能」手动锁定。

4.2 10 入口抽屉

横滑或向上拖网格，10 个功能入口：

4.3 PetCreator 三种模式

PetCreator 配额：

5. Summon Tab 详解

5.1 聊天主界面

5.2 唤醒词（Wake Word）

支持 "Hey Aira"（默认）或自定义短语。

Android 后台唤醒：需要"显示在其他应用之上"权限 + 录音权限。在「设置 → 唤醒词」开启。

6. Plaza Tab 详解

6.1 5 段 Segmented

6.2 Skin GMV 与 Cinderella Boost

• 你创造的 Skin 上架后被买走，70% GMV 进你的钱包，10% Cinderella Boost 给首位出价者，平台分 5-15%（按 Tier）
• AXP 抵扣：买家可用 AXP 抵扣最多 50% 单价
• 拍卖反狙击：最后 5 分钟有出价 → 自动延 2 分钟

6.3 共养（Co-Raising）

把你的主宠通过 universal link 分享给朋友，他们能：

• 喂食（每天最多 10 次，喂方 +5 AXP，主人 +2 AXP）
• 玩耍 / 训练（按角色权限）
• 看升级

可设置分成（默认 70/20/10 = 主人 / 共养者 / 平台 AXP）。

7. Me Tab 详解

7.1 8 个子入口

7.2 设置页（ClawSettingsScreen）三大块

7.2.1 界面模式

7.2.2 语言

中文 / English 切换；切换后整个 App 立即生效。

7.2.3 唤醒词配置

• 主唤醒短语（默认 "Hey Aira"）
• 兜底系统短语（逗号分隔）
• 灵敏度（0.5-0.9）
• 本地模型录制 + 自检 + 清空
• Android 后台唤醒授权

7.3 关于页（About）

8. 多端联动（扫码绑桌面端）

8.1 桌面端登录流程

桌面端启动 → 显示二维码 (480x480, 60s 失效)
   ↓
移动端 顶部 📷 扫码
   ↓
扫到 https://agentrix.top/pair?session=xxx&platform=desktop
   ↓
移动端调 confirmDesktopPairWithApiBase(session)
   ↓
桌面端拿到 token + user info → 自动登录

✅ 桌面端复用移动端账号：所有 AXP 余额、主宠、订阅状态、邀请码权益都同步过来。 ✅ 不需要二次邀请码：桌面端只看账号是否已激活，不再独立校验邀请码。

8.2 网页端同样流程

agentrix.top → 右上角"二维码登录" → 同样的 QR 流程。

8.3 多账号切换

App 内（AgentDrawerContent / AgentConsoleScreen）已有多 instance 切换：

顶部"实例选择器"芯片 → 列出所有已绑定的 OpenClaw 实例
   ↓
单击切换主控（active instance）

每个实例可对应不同的部署：本地 / 云上 / 中继。

9. NFC 盲盒兑换

9.1 触发流程

1. 购买 Agentrix 实物盲盒 / 卡牌 / 贴纸
2. 用 iPhone / Android 碰触实体（NDEF tag URI: agentrix://nfc/<token>）
3. 扫码屏自动拉起 NfcRedeemScreen
4. 调 /api/v1/clawcore/nfc/redeem
5. 服务端验证 token 唯一性 → 颁发限定皮肤 / Soul / 道具
6. 弹动画"✨ 解锁了 XXX 皮肤"+ 主宠 excited 表情 3s

9.2 防滥用

• 每个 token 一次性
• 同一用户 24h 内重复 tap 同 token 仅触发情绪，不重复发奖
• 异常碰触次数（10s 内 > 5 次）触发风控

10. Toy 玩具配对

10.1 OOB 6 位配对码

1. Me → 设备管理 → "+ 添加新设备"
2. 蓝牙发现附近 ESP32 / ClawCore Toy
3. 选中设备 → 服务端发 6 位配对码（60s 有效）
4. 设备屏幕 / 包装上显示 6 位码
5. 用户输入到 App
6. 服务端验证 → 颁发 device JWT + 公钥固化
7. 弹"✅ 已绑定"

10.2 设备管理列表

每个设备显示：

• 名称 / 类型（Toy / Glass / Watch）
• 电量 + 固件版本
• 最后活跃时间
• OTA 升级（有可用更新时显示按钮）
• 解绑按钮

11. 系统助手集成

11.1 iOS App Intents

11.2 Android App Actions

注册 6 个 BIIs（Built-In Intents），见 android/app/src/main/res/xml/actions.xml：

• actions.intent.GET_THING → "问 Aira"
• actions.intent.CREATE_MESSAGE → 起草
• custom.actions.intent.APPROVE → 批准（需 approvalId）
• actions.intent.GET_ACCOUNT → 钱包状态
• custom.actions.intent.INVOKE_AGENT → 调用智能体
• custom.actions.intent.PET_MOOD → 主宠情绪

11.3 灵动岛 / 锁屏 Widget

iOS WidgetKit + ActivityKit native module（推迟到 v1.2 引入）。当前 v1.1 没有。

12. 隐私与遥测

12.1 默认值

12.2 切换路径

Me Tab → 设置 → 关于 → 「匿名遥测」开关

切换后立即生效（5 分钟内首批事件停止上报）。

12.3 删除账号 / 导出数据

Me Tab → 设置 → 关于 → 「删除账号」/「导出我的数据」
   ↓
跳 mailto:privacy@agentrix.top（GDPR Article 20）
   ↓
我们 7 天内删除（账号 + 对话 + AXP）/ 30 天内 JSON 导出

13. 自动更新（OTA）

13.1 OTA vs 商店更新区分

13.2 OTA 拉取触发

App 启动时自动检查（app.json updates.checkAutomatically: ON_LOAD）：

有新 OTA → 静默下载 → 下次启动生效

13.3 哪些不能 OTA

按 Apple 政策（Android 较松）：

• 新 native module（必须发 binary）
• 业务核心改动（Apple 审核员可能拒）
• 新增图片资源（如果没在原 binary 中预声明）

文案 / bug fix / UI 调整可 OTA。

14. 故障排除

14.1 启动阶段

14.2 性能问题

14.3 网络

14.4 NFC

14.5 Toy / Glass 配对

附录 A：版本历史

附录 B：与其他端关系

详见 docs/agentrix-cross-platform-prd-v4.md。

反馈邮箱：support@agentrix.top 社区：Discord / Telegram（App 内 设置 → 关注我们） 最后更新：2026-05-16