快速开始
本指南帮助你在 5 分钟内完成 Wesclaw 的安装、配置和第一次对话。
产品形态
Wesclaw 提供两种使用方式：
| 形态 | 适用场景 | 通信方式 |
|---|---|---|
| 桌面版（Electron） | 个人电脑日常使用 | stdio JSON-RPC |
| 云端版（SaaS Chat） | 浏览器随时访问 | HTTP + JWT 认证 |
两种形态共享同一套 AI 引擎能力，你可以根据使用习惯选择。
安装步骤
桌面版安装
macOS
- 从官方下载页获取
.dmg安装包 - 双击打开 DMG 文件，将 Wesclaw 拖入「应用程序」文件夹
- 首次启动时，如遇安全提示，前往「系统设置 → 隐私与安全性」点击「仍要打开」
# 或通过命令行安装（如已配置 Homebrew Cask）
brew install --cask wesclaw
Windows
- 下载
.exe安装程序 - 双击运行，按照向导完成安装
- 安装完成后，Wesclaw 会出现在开始菜单中
Linux
# Debian / Ubuntu
sudo dpkg -i wesclaw_latest_amd64.deb
# 或使用 AppImage（无需安装）
chmod +x Wesclaw-latest.AppImage
./Wesclaw-latest.AppImage
云端版访问
云端版无需安装，直接通过浏览器访问：
https://chat.wesclaw.ai
支持 Chrome、Firefox、Safari、Edge 等主流浏览器。
首次配置
1. 登录或注册
- 桌面版：启动后点击「登录」，使用手机号或邮箱注册
- 云端版：在浏览器中打开页面，完成注册流程
2. 配置 AI 模型
Wesclaw 支持多种 AI 模型提供商。你需要至少配置一个：
使用平台模型（推荐新手）
登录后即可使用平台提供的 WES 模型，无需额外配置。费用从平台钱包扣除。
使用自有模型（BYOK）
如果你有自己的 API Key，可以在设置中添加：
- 进入「设置 → AI 模型」
- 点击「添加模型提供商」
- 选择提供商类型（OpenAI / Anthropic / Azure / 本地部署等）
- 填写 API Key 和接入地址
- 点击「测试连接」确认可用
3. 选择语言和时区
在「设置 → 通用」中配置：
- 界面语言：中文 / English
- 时区：自动检测或手动选择
第一次对话
开始聊天
- 在主界面点击「新建对话」或使用快捷键
Ctrl+N（macOS:Cmd+N） - 在底部输入框中输入你的问题
- 按
Enter发送，或Shift+Enter换行
示例对话
你：帮我写一封请假邮件，因为明天需要去医院看病
AI：好的，这是一封请假邮件的草稿：
主题：请假申请 - [你的姓名] - [日期]
领导好：
因需前往医院就诊，特申请明日（X月X日）请假一天。
如有紧急事务，可通过手机联系我。
感谢理解！
[你的姓名]
需要我调整措辞或补充其他信息吗？
上传文件
你可以在对话中上传文件让 AI 分析：
- 点击输入框旁的 📎 图标
- 或直接拖拽文件到对话窗口
- 支持的格式：PDF、Word、Excel、图片、代码文件等
常用操作速览
| 操作 | 快捷键 | 说明 |
|---|---|---|
| 新建对话 | Ctrl/Cmd + N | 开始一个全新的对话 |
| 搜索历史 | Ctrl/Cmd + K | 搜索历史对话内容 |
| 切换模型 | 顶栏模型选择器 | 更换当前使用的 AI 模型 |
| 停止生成 | Esc 或点击停止按钮 | 中断 AI 正在生成的回复 |
| 复制回复 | 悬浮在回复上方 | 点击复制图标 |
| 重新生成 | 悬浮在回复上方 | 点击重试图标 |
| 打开设置 | Ctrl/Cmd + , | 进入设置页面 |
界面介绍
桌面版界面布局
┌──────────────────────────────────────────┐
│ 顶部栏：模型选择 / Agent 切换 / 设置 │
├────────┬─────────────────────────────────┤
│ │ │
│ 侧边栏 │ 对话主区域 │
│ │ │
│ 对话列表│ AI 回复 / 工具调用 / 文件 │
│ │ │
│ 联系人 │ │
│ │ │
│ 设置入口│ │
│ ├─────────────────────────────────┤
│ │ 输入框：文本 / 附件 / @ 上下文 │
└────────┴─────────────────────────────────┘
侧边栏：管理对话列表、AI 角色（Agent）、技能、记忆等功能入口
对话主区域：显示消息、AI 回复、工具调用过程、文件预览等
输入框：支持文本输入、文件附件、@ 引用上下文、模型选择等
云端版界面
云端版界面布局与桌面版基本一致，通过浏览器访问。部分本地专属功能（如设备自动化）在云端版中不可用。