1. 项目定位与用途
Claw Mobile 是 OpenClaw 生态的 iOS 客户端，定位为 AI Agent 的图形化控制中心（GUI），类比于“Cursor for AI Agents”。它不是一个 AI 聊天客户端，而是提供远程管理、监控和控制 AI Agent 的移动端操作系统。核心价值在于将 AI Agent 的强大能力通过直观的移动界面呈现，使用户能随时随地管理数字工作者，执行复杂任务如代码生成、自动化、数据分析等。
项目档案应用项目
Claw Mobile：OpenClaw AI Agent 的 iOS 图形化控制中心 - 安装、使用与功能详解
Claw Mobile 是 OpenClaw 生态的 iOS 客户端，将 AI Agent 的控制从命令行升级为移动端 GUI。支持 Agent 连接、会话聊天、工具审批、任务自动化、记忆管理等功能。本文详细解析项目定位、解决的问题、适用场景，并提供基于 XcodeGen 的安装构建指南与使用方式说明。
AI 总结
Claw Mobile 是 OpenClaw 生态的 iOS 客户端，作为 AI Agent 的图形化控制中心，提供远程管理、会话聊天、工具审批和任务自动化等功能，将 AI Agent 的控制从命令行升级为直观的移动端 GUI。
中文项目介绍
Claw Mobile 是 OpenClaw 生态系统的 iOS 客户端应用，定位为 AI Agent 的图形化控制中心（GUI），而非聊天工具。它旨在将 AI Agent 的控制方式从传统的命令行（Chat）升级为直观的移动端操作系统，类比于 Cursor 对于 AI 的角色。
项目解决了当前 AI Agent 控制界面原始、Session 和 Memory 管理困难以及安全控制缺失等问题。通过提供可视化的操作面板，用户可以轻松远程管理、监控和控制运行在本地机器上的 OpenClaw Agent。
适用场景包括：用户需要在移动设备上随时查看 Agent 状态、发送指令、审查执行结果；创建和管理定时自动化任务（Cron 调度）；浏览和编辑 Agent 的长期记忆（事实、偏好、知识）；以及对危险操作（如删除文件、运行 Shell 命令）进行安全审批。
技术特征方面，Claw Mobile 采用 SwiftUI 构建，支持 iOS 18.0 及以上版本；使用 MVVM 架构模式和 @Observable 实现响应式数据流；通过 WebSocket 与 OpenClaw Gateway 实时通信；本地数据存储使用 UserDefaults；构建工具为 XcodeGen。项目结构清晰，按功能模块划分 Models、ViewModels、Views 和 Services。
详细信息与使用说明
2. 解决的问题
根据前期调研，当前 OpenClaw 用户通过 Telegram、Discord 或终端等原始界面控制 AI Agent，存在三大问题：一是控制界面过于原始，与 Agent 的强大能力不匹配；二是 Session、Memory（如 SOUL.md、MEMORY.md）管理困难，普通用户难以理解；三是缺乏安全控制机制，Agent 执行 Shell、文件操作等高风险动作时无可视化审批，安全隐患大。Claw Mobile 旨在通过 GUI 解决这些问题，提供安全审批层和直观的管理面板。
3. 适用场景
主要适用于在本地机器上运行 OpenClaw Agent 的用户，需要在移动设备上进行远程交互。具体场景包括：远程查看 Agent 状态并发送指令；通过手机创建、管理和监控定时自动化任务（Cron 调度）；浏览、编辑 Agent 的长期记忆（事实、偏好、知识三类）；在 Agent 执行危险操作（如删除文件、运行 Shell 命令）时接收审批请求并批准或拒绝；以及进行流式对话，查看工具调用详情和响应。
4. 安装方式
Claw Mobile 为开源项目，需开发者自行构建。环境要求：macOS 15+、Xcode 16+、XcodeGen（通过 Homebrew 安装），以及本地运行的 OpenClaw Agent。构建步骤：克隆仓库，进入项目目录；运行 `xcodegen generate` 生成 Xcode 项目；使用 xcodebuild 构建或直接在 Xcode 中打开 ClawMobile.xcodeproj 选择模拟器运行；安装到模拟器可通过 xcrun 命令。注意：最低支持 iOS 18.0。仓库中未提供 App Store 分发方式。
5. 使用方式
连接 Agent 后，主界面提供多个标签页：会话列表页可查看历史会话并创建新会话；聊天页支持流式消息发送与接收，工具调用以卡片形式展示，高风险操作会弹出审批横幅；任务页可创建 Cron 定时任务、查看任务列表并手动触发；记忆页浏览 Agent 的长期记忆条目，支持置顶、编辑、删除；设置页可查看 Agent 状态、管理工具、切换语言或断开连接。所有操作均通过 WebSocket 实时同步，确保与 Agent 的即时交互。
6. 实现特点
技术栈采用 SwiftUI 构建 UI，MVVM 架构模式配合 @Observable 实现响应式数据流；实时通信依赖 WebSocket，用于推送流式 Token 和事件通知；本地存储使用 UserDefaults 保存轻量数据；认证采用 JWT Token 与 Device ID 绑定，支持 QR 码、手动输入 Token 或 Deep Link 连接；项目使用 XcodeGen 管理工程文件，确保配置一致性。代码结构清晰，按功能模块划分 Models、ViewModels、Views 和 Services，其中 Services 包含 OpenClawService（WebSocket 客户端）和 L10n（国际化）。
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
Claw Mobile 是什么？
Claw Mobile 是 OpenClaw 生态的 iOS 客户端，作为 AI Agent 的图形化控制中心，用于远程管理、控制和监控 AI Agent，而非聊天工具。它提供直观的移动端操作系统来管理数字工作者。
如何安装和运行 Claw Mobile？
需 macOS 15+、Xcode 16+、XcodeGen 和本地 OpenClaw Agent。克隆仓库后，运行 `xcodegen generate` 生成 Xcode 项目，然后使用 xcodebuild 构建或直接在 Xcode 中运行，最后安装到模拟器或设备。最低支持 iOS 18.0。
Claw Mobile 支持哪些核心功能？
包括 Agent 连接（自动发现或 Token 输入）、会话聊天（流式响应、工具调用可视化）、工具审批（拦截危险操作如 Shell、文件删除）、任务自动化（创建和管理 Cron 定时任务）、记忆管理（浏览和编辑长期记忆）以及多语言切换。
最低系统要求是什么？
运行环境需 iOS 18.0 及以上；开发环境需 macOS 15+、Xcode 16+ 并安装 XcodeGen。同时，需要本地运行 OpenClaw Agent 服务端进行连接。
如何连接 OpenClaw Agent？
支持三种方式：通过 Token 手动输入、扫描 QR 码或使用 Deep Link 连接；也可自动发现本地网络运行的 Agent。连接基于 JWT Token 与 Device ID 绑定认证，确保安全。