# openclaw-mobile-app

**Repository Path**: weishuaiwang/openclaw-mobile-app

## Basic Information

- **Project Name**: openclaw-mobile-app
- **Description**: 自建openclaw-mobile-app
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw Mobile App

OpenClaw移动端对话沟通APP，提供与自建OpenClaw服务器无缝对接的移动端个人助理体验。

## 项目信息

- **包名**: com.openclaw.chatapp
- **版本**: 1.0.0
- **平台**: Android 8.0+, iOS 14.0+
- **技术栈**: Flutter 3.16+, Riverpod, sqflite, web_socket_channel, dio

## 功能特性

### P0 核心功能
- ✅ 服务器连接与认证（多服务器配置、加密存储、自动连接、断线重连）
- ✅ 聊天界面与消息展示（对话列表、聊天界面、流式显示）
- ✅ 文件/图片/视频交互（上传、展示、预览）
- ✅ 对话标题自动生成

### P1 重要功能
- 对话搜索
- 长连接管理
- 文件预览增强

### P2 辅助功能
- 自定义设置
- 导出对话记录

## 项目结构

```
lib/
├── main.dart                    # 应用入口
├── app.dart                     # 根组件
├── models/                     # 数据模型
│   ├── server.dart             # 服务器配置模型
│   ├── conversation.dart       # 对话模型
│   └── message.dart           # 消息模型
├── providers/                  # Riverpod状态管理
│   ├── server_provider.dart    # 服务器状态
│   ├── conversation_provider.dart  # 对话状态
│   └── message_provider.dart  # 消息状态
├── services/                  # 业务逻辑服务
│   ├── storage_service.dart    # 本地存储服务
│   ├── websocket_service.dart  # WebSocket通信服务
│   ├── encryption_service.dart # 加密服务
│   └── file_service.dart     # 文件服务
├── screens/                   # 页面
│   ├── home_screen.dart       # 主页面（对话列表）
│   ├── chat_screen.dart      # 聊天界面
│   ├── settings_screen.dart  # 设置页面
│   └── add_server_screen.dart # 添加服务器页面
├── widgets/                   # 组件
│   ├── message_bubble.dart    # 消息气泡
│   ├── conversation_item.dart # 对话列表项
│   └── file_attachment.dart  # 文件附件
└── utils/                     # 工具函数
    ├── constants.dart         # 常量定义
    ├── helpers.dart          # 辅助函数
    └── title_generator.dart # 标题生成器
```

## 环境要求

- Flutter SDK 3.16+
- Dart 3.0+
- Android Studio / Xcode（用于编译）

## 快速开始

### 安装依赖
```bash
flutter pub get
```

### 运行应用
```bash
# Android
flutter run

# iOS
flutter run -d ios

# Web
flutter run -d chrome
```

### 构建APK
```bash
# Debug版本
flutter build apk --debug

# Release版本
flutter build apk --release
```

### 构建IPA
```bash
flutter build ipa
```

## 配置说明

### 服务器配置
1. 打开APP
2. 点击"添加服务器"
3. 输入服务器地址（如 http://192.168.1.100:18789）
4. 输入认证token
5. 保存并连接

### OpenClaw Gateway要求
- 必须运行OpenClaw Gateway服务
- 必须开启WebSocket服务（默认端口18789）
- 必须配置正确的认证token

## API文档

参考 [OpenClaw官方文档](https://docs.openclaw.ai/)

### WebSocket接口
- `chat.history`: 获取聊天历史
- `chat.send`: 发送消息
- `chat.abort`: 停止聊天

### HTTP接口
- 文件上传接口
- 配置管理接口

## 安全说明

- 服务器配置使用AES-256加密存储
- 通信使用HTTPS/WSS加密传输
- token仅本地存储，不上传云端

## 测试

```bash
# 运行单元测试
flutter test

# 运行集成测试
flutter test integration_test/
```

## 许可证

MIT License

## 联系方式

- 官网: https://openclaw.ai
- 文档: https://docs.openclaw.ai/
# Git 自动推送配置

本项目已启用Git自动推送机制。

## 远程仓库
- **地址**: git@gitee.com:weishuaiwang/openclaw-mobile-app.git
- **平台**: Gitee

## 使用方法

### 快捷提交（推荐）
```bash
gac "提交信息"
```

### 完整命令
```bash
git-auto-commit "提交信息"
```

## 工作流程
1. 修改代码
2. 执行 `gac "提交信息"`
3. 自动完成：add → commit → push

详细文档请查看: [COMMIT_GUIDE.md](./COMMIT_GUIDE.md)