OpenClaw Android App¶
创建时间: 2026-03-08
状态: ✅ 已完成基础版本
包名:com.openclaw.chat
📋 项目概述¶
为 OpenClaw Gateway 创建的原生 Android 应用，解决用户移动端网页版体验不佳的问题。
为什么重要¶
用户（Chingchien）反馈网页版在手机上"太费劲了"，因此创建了原生 Android 应用作为解决方案。
🛠️ 技术栈¶
| 组件 | 技术选型 |
|---|---|
| UI | Jetpack Compose（现代声明式） |
| WebSocket | OkHttp 4.12.0 实时通信 |
| 存储 | Jetpack DataStore 持久化配置 |
| 架构 | MVVM 模式 |
| Min SDK | 26 (Android 8.0+) |
| Target SDK | 34 |
| 主题 | Dark theme with OpenClaw blue (#1a73e8) |
✨ 已实现功能¶
- ✅ 可自定义服务器配置（host, port, token, WSS 开关）
- ✅ WebSocket 实时聊天
- ✅ 连接状态指示器
- ✅ 消息气泡（用户/助手样式区分）
- ✅ 设置界面带表单验证
- ✅ 导航抽屉（聊天/设置/关于）
- ✅ 本地配置持久化
📁 项目位置¶
关键文件¶
MainActivity.kt- 主界面ChatViewModel.kt- 聊天视图模型WebSocketManager.kt- WebSocket 管理PreferencesManager.kt- 偏好设置管理- UI 组件：
OpenClawApp,MessageItem,MessageInput,SettingsScreen
📊 项目统计¶
- 文件数: 30+ 个
- 代码量: 33,996 行插入
- Git 提交:
fc296b6- "feat: 创建 OpenClaw Android App"
🚀 使用指南¶
构建步骤¶
- 在 Android Studio 中打开项目
- Gradle 同步（首次需 2-5 分钟）
- 在设备/模拟器上运行
- 在设置中配置 Gateway 地址
- 构建 APK:
./gradlew assembleDebug
配置 Gateway¶
在 App 的设置界面输入： - Host: Gateway 服务器 IP 或域名 - Port: 18789（默认） - Token: 配对令牌 - WSS: 是否启用 WebSocket Secure
📝 注意事项¶
- 这是自定义解决方案（官方只有 iOS/macOS SwiftUI 版本）
- 项目已准备好可构建部署
- 用户可自行配置服务器连接详情
🔗 相关笔记¶
- [[课题组规划]] - 科研项目管理
- [[百合病研究]] - 当前主要研究
最后更新：2026-03-09