OpenClaw Client for macOS

一个功能丰富的 OpenClaw Gateway 客户端，支持多种交互方式与 AI 模型进行对话。

功能特性

• 🔧 可配置的 Gateway 地址 - 支持自定义 API 网关地址
• 💬 文本对话 - 支持多轮文本对话
• 🖼️ 图片支持 - 支持发送图片（拖拽、选择文件、剪贴板粘贴）
• 📸 截图功能 - 一键截取屏幕并发送
• 🎬 视频支持 - 支持发送视频文件
• 🎨 现代化 UI - 原生 SwiftUI 构建，流畅美观

系统要求

• macOS 13.0 (Ventura) 或更高版本
• Xcode 15.0 或更高版本（用于编译）

安装与运行

使用 Xcode（推荐）

1. 确保已安装 Xcode 15.0 或更高版本
2. 双击 OpenClawClient.xcodeproj 打开项目
3. 选择 "My Mac" 作为目标设备
4. 点击运行 (⌘R) 或按 Product > Run

使用命令行构建（需要完整 Xcode）

cd OpenClawClient
xcodebuild -project OpenClawClient.xcodeproj -scheme OpenClawClient -configuration Release build

注意事项

• 需要安装完整的 Xcode（不仅仅是 Command Line Tools）
• 首次运行时需要授予屏幕录制权限才能使用截图功能

配置

首次运行时，请点击左侧边栏的设置图标或使用菜单 OpenClaw > Settings... 进行配置：

1. Gateway 地址: 输入您的 OpenClaw/OpenAI 兼容的 API 网关地址
   • 例如: https://api.openai.com 或自定义网关
2. API 密钥: 输入您的 API 访问密钥
3. 模型选择: 选择要使用的 AI 模型

使用方法

发送文本消息

在底部输入框中输入文字，按回车或点击发送按钮。

发送图片

• 拖拽: 直接将图片拖拽到聊天窗口
• 选择文件: 点击图片图标选择本地图片
• 剪贴板: 复制图片后点击剪贴板图标粘贴

截图

点击截图图标（相机取景器），将自动截取当前屏幕并添加到发送队列。

发送视频

点击视频图标选择本地视频文件。

支持的文件格式

图片

• JPEG/JPG
• PNG
• GIF
• WebP

视频

• MP4
• MOV
• AVI

权限说明

应用需要以下权限：

• 屏幕录制: 用于截图功能
• 照片库访问: 用于选择图片（可选）

技术架构

• 框架: SwiftUI + AppKit
• 最低系统版本: macOS 13.0
• API 协议: OpenAI Chat Completions API 兼容

开发说明

项目结构：

OpenClawClient/
├── Package.swift           # Swift Package 配置
├── README.md              # 说明文档
└── OpenClawClient/
    ├── OpenClawClientApp.swift   # 应用入口
    ├── ContentView.swift         # 主界面
    ├── ChatView.swift            # 聊天界面
    ├── SettingsView.swift        # 设置界面
    ├── Models.swift              # 数据模型
    ├── APIService.swift          # API 服务
    ├── ScreenCaptureHelper.swift # 截图助手
    └── Info.plist               # 应用配置

许可证

MIT License