JVSClaw作为当前最受关注的AI编程助手之一，支持多种使用方式，适合不同场景的用户。这篇教程从零开始，把下载安装、网页版、手机版、本地部署逐一讲清楚，全程保姆级，没有技术基础的新手也能跟着操作。
一、下载安装（桌面客户端）
支持平台
JVSClaw桌面客户端支持 Windows 10/11（64位）、macOS 12+（Intel & Apple Silicon）和主流Linux发行版（Ubuntu 20.04+）。
下载步骤
- 打开官网，进入「下载」页面
- 根据你的操作系统选择对应版本
- Windows用户下载
.exe安装包，macOS用户下载.dmg文件，Linux用户选.AppImage或.deb - 下载完成后按正常软件安装流程操作
Windows安装注意事项
- 安装时若弹出「Windows保护了你的电脑」提示，点击「更多信息」→「仍要运行」即可，这是正常的SmartScreen拦截
- 安装路径建议不要包含中文或空格，避免后续出现路径问题
- 首次启动需要登录账号，用邮箱注册并验证即可
macOS安装注意事项
- 打开
.dmg后将图标拖入Applications文件夹 - 首次打开如提示「无法验证开发者」，前往「系统偏好设置」→「安全性与隐私」→点击「仍要打开」
- Apple Silicon芯片（M1/M2/M3）用户请选择ARM版本，运行更流畅
二、网页版使用
网页版是最轻量的使用方式，无需安装任何软件，打开浏览器即可使用。
访问入口
在浏览器地址栏输入JVSClaw官网地址，点击右上角「进入产品」或「Web版」按钮，登录账号后即进入主界面。
主界面布局
- 左侧边栏：对话历史、项目列表、设置入口
- 中央区域：主对话窗口
- 右侧面板（可折叠）：代码预览、文件树
- 底部输入框：消息输入、文件上传、模型切换
基本操作流程
- 在底部输入框输入你的需求，按 Enter 或点击发送按钮
- AI回复期间可以点击「停止」中断生成
- 鼠标悬停在回复上，可以看到复制、重新生成、点赞/踩等操作按钮
- 代码块右上角有「复制」和「在新标签运行」按钮，方便快速操作
网页版的局限
网页版不支持直接访问本地文件系统，上传文件需要手动操作。对于需要频繁处理本地项目的用户，建议使用桌面客户端或本地部署。
三、手机版使用
iOS版
在App Store搜索「JVSClaw」，注意认准官方开发者名称，避免下载到山寨应用。下载安装后用账号登录即可。iOS版支持：
- 与桌面版同步对话历史
- 语音输入（长按麦克风按钮）
- 代码高亮显示
- 快捷指令（Shortcuts）集成
Android版
部分地区Android版暂未上架Google Play，可前往官网下载APK手动安装。安装前需在「设置」→「安全」中开启「允许安装未知来源应用」。
手机版使用技巧
- 竖屏适合对话阅读，横屏更适合查看代码
- 三指下划可快速清空当前对话
- 长按消息可复制、分享或触发重新回答
四、本地部署（进阶）
本地部署适合对数据隐私要求高、或需要离线使用的用户，需要一定的技术基础。
环境要求
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Linux / macOS | Ubuntu 22.04 |
| CPU | 4核 | 8核以上 |
| 内存 | 8GB | 16GB以上 |
| 存储 | 20GB可用空间 | SSD 50GB以上 |
| Node.js | v18+ | v20 LTS |
部署步骤
第一步：克隆仓库
git clone https://github.com/jvsclaw/jvsclaw-deploy.git
cd jvsclaw-deploy
第二步：安装依赖
npm install
第三步：配置环境变量
复制示例配置文件并编辑：
cp .env.example .env
nano .env
主要需要填写的字段：
API_KEY：你的JVSClaw API密钥（在官网个人中心获取）PORT：服务监听端口，默认3000MODEL：默认使用的模型名称
第四步：启动服务
npm run start
访问 http://localhost:3000 即可看到本地部署的JVSClaw界面。
第五步：配置反向代理（可选）
如需在局域网内其他设备访问，推荐用Nginx做反向代理，并配置SSL证书。具体配置参考官方文档的「生产部署」章节。
五、上传文件
无论是网页版还是桌面版，上传文件的方式基本一致：
- 点击上传按钮：输入框左侧有回形针图标，点击选择本地文件
- 拖拽上传：直接将文件拖入对话窗口
- 粘贴上传：截图后直接 Ctrl+V / Cmd+V 粘贴图片
支持的文件类型包括：txt、pdf、md、csv、json、常见代码文件（.py、.js、.ts等）以及图片（png、jpg、webp）。单次上传文件大小上限通常为10MB，具体以当前套餐为准。
六、自定义模型配置
在「设置」→「模型」页面，可以配置：
- 默认模型：选择每次对话默认调用的模型版本
- 温度（Temperature）：控制回复的随机性，0为确定性最高，1为最随机
- 最大Token数：单次回复的最大长度限制
- System Prompt：预设系统级提示词，相当于给AI一个固定的「角色设定」
- 自定义API端点：如果你有自己的API代理或兼容OpenAI格式的私有模型，可以在这里填入自定义端点地址
自定义API端点这个功能对开发者很友好，可以把JVSClaw的界面当作本地Ollama模型的前端来用。
常见问题
Q：客户端安装后无法启动怎么办？
A：检查系统版本是否满足最低要求；尝试以管理员身份运行；卸载后重装并清除残留配置文件。
Q：网页版加载很慢？
A：尝试切换网络环境；清除浏览器缓存；如果使用代理，检查代理配置是否正常。
Q：手机版和桌面版数据不同步？
A：确认两端登录的是同一账号；在设置里手动触发一次同步；如仍不同步，联系官方客服。
有没有在安装或使用过程中遇到其他问题？欢迎在评论区描述你的情况，大家一起来解决 