Setup Guide完整流程
MobileClaw App Installation and Configuration WorkflowMobileClaw App 安装配置流程
This guide explains the full MobileClaw setup path from start to finish. If you want to move beyond simply installing the app and actually get it working in your own environment, this is the page to follow.这篇文章会完整说明 MobileClaw 从下载安装到真正可用的全过程。如果你不只是想装上 App，而是希望把它真正跑起来，这一页就是完整参考。
1. Download the app1. 下载 App
Start from the official MobileClaw homepage and download the Android installation package. The homepage provides the current `MobileClaw-release.apk` file for direct download.先从 MobileClaw 官方主页下载 Android 安装包。首页提供当前可直接下载的 `MobileClaw-release.apk` 文件。
It is recommended to download it directly on the Android device you plan to use, so the following installation steps are simpler.建议直接在目标 Android 设备上下载，这样后续安装步骤会更简单。
2. Install the APK2. 安装 APK
After the file finishes downloading, open it from the notification panel, browser download manager, or file manager. If Android warns you that installation from this source is not yet allowed, enable it for the current browser or file manager and continue.下载完成后，可以从通知栏、浏览器下载管理器或文件管理器中打开它。如果 Android 提示当前来源暂不允许安装，请为当前浏览器或文件管理器开启安装权限，然后继续。
After installation completes, open MobileClaw normally.安装完成后，正常打开 MobileClaw 即可。
3. Configure model endpoints3. 配置模型接口
MobileClaw typically needs model services for planning and screen-related reasoning. In practice, this means you need to prepare compatible model endpoints and fill in the required connection fields such as URL, key, and model name.MobileClaw 通常需要模型服务来完成规划和界面相关推理。实际操作中，你需要准备兼容的模型接口，并填写必要的连接信息，例如 URL、Key 和模型名称。
- Use a stable provider with good response quality.优先选择稳定、响应质量较好的模型服务。
- Confirm the model is suitable for your language and workflow.确认所用模型适合你的语言环境和工作流。
- Check the configuration twice before launch to avoid authentication errors.启动前再次检查配置，避免认证失败或请求错误。
If you want a smoother setup experience, we recommend using the MobileClaw Config Tool. It helps you fill in model and chat settings in the browser, generate a `config.yaml`, and import it into the app through QR code.如果你想更顺手地完成配置，推荐直接使用 MobileClaw 的配置工具。它可以帮助你在浏览器中填写模型和聊天接口配置，生成 `config.yaml`，并通过二维码导入到 App 中。
4. Configure chat channels4. 配置聊天接口
If you want to talk to MobileClaw through chat tools, you need to configure your preferred channel, such as Telegram, Weixin, Zulip, Lark, or other supported integrations.如果你希望通过聊天工具与 MobileClaw 交互，就需要配置你偏好的聊天渠道，例如 Telegram、微信、Zulip、飞书或其他支持的接入方式。
This step usually includes preparing the corresponding bot or integration credentials, then filling those values into the MobileClaw configuration.这一步通常包括：准备对应机器人的接入凭据，然后把这些值填写到 MobileClaw 的配置中。
5. Grant required permissions5. 授予必要权限
To operate apps on your phone, MobileClaw may require permissions such as Accessibility, notification access, or screen-related capabilities. Without these permissions, many workflows cannot run correctly.为了在手机上操作应用，MobileClaw 可能需要无障碍、通知访问或与屏幕相关的权限。没有这些权限时，很多工作流将无法正确运行。
Grant only what is necessary, and understand what each permission allows before enabling it.只开启必要权限，并在开启前了解每项权限的实际作用。
6. Set the role with `profile.md`6. 通过 `profile.md` 设定角色
`profile.md` is where you define the role, style, and default behavioral expectations for your MobileClaw instance. You can think of it as the personality and working guide for the agent.`profile.md` 是你为 MobileClaw 设定角色、风格和默认行为预期的地方。你可以把它理解为这个智能体的人设说明和工作准则。
- Describe what the agent should help with.说明智能体主要帮助你做什么。
- Describe the preferred tone and response style.说明它应当采用什么语气与回应方式。
- Add boundaries, cautions, or workflow preferences if needed.如有需要，也可以补充边界要求、注意事项或工作偏好。
7. Launch MobileClaw7. 启动 MobileClaw
Once app installation, model configuration, chat channel settings, permissions, and role setup are ready, you can launch MobileClaw into its normal working state.当 App 安装、模型接口、聊天渠道、权限和角色设定都准备好之后，就可以让 MobileClaw 进入正常工作状态。
At this stage, your main goal is to confirm that the app can stay active, connect to its configured services, and respond normally.这个阶段的重点是确认：应用能够保持运行、连接成功、并能够正常响应。
8. Start interacting8. 开始交互
After launch, interact with MobileClaw through the configured interface. This may be inside the app itself or through the chat channel you enabled earlier.启动后，你就可以通过配置好的入口与 MobileClaw 交互。这可以是 App 内部，也可以是前面配置好的聊天渠道。
Start with simple tasks first. For example, ask it to describe the current screen, confirm a basic action, or perform a small workflow before moving to more complex automation.建议先从简单任务开始，例如让它描述当前屏幕、确认一个基础操作，或执行一个简短流程，再逐步尝试更复杂的自动化。
A recommended order of operations推荐的整体顺序
- Download the app下载 App
- Install the APK安装 APK
- Configure model endpoints配置模型接口
- Configure chat channels配置聊天接口
- Grant required permissions授予必要权限
- Set up `profile.md`设定 `profile.md`
- Launch the app启动应用
- Begin interaction and verify behavior开始交互并验证行为
Final advice最后的建议
Use a dedicated secondary phone, keep your accounts separated, and test in a controlled environment first. MobileClaw becomes much easier to manage when you build the setup step by step instead of enabling everything at once.建议使用专用备用机、保持账号隔离，并先在受控环境中测试。相比一开始就全部打开，按步骤逐步完成配置，会让 MobileClaw 更容易理解、管理和排查问题。