5分钟上手 UI-TARS-desktop
本指南将帮助你在5分钟内安装并启动UI-TARS-desktop，体验AI智能体操作桌面的基础功能
环境要求
支持的操作系统
运行环境
所需工具
克隆项目代码
操作步骤
克隆项目
从GitHub克隆UI-TARS-desktop项目到本地
git clone https://github.com/bytedance/UI-TARS-desktop.git预期结果：项目目录UI-TARS-desktop被成功创建
确保网络连接正常，Git已正确安装
安装依赖
进入项目目录并安装必要的依赖包
cd UI-TARS-desktopnpm install预期结果：看到大量依赖包被下载安装，最后显示类似'added 1234 packages'的提示
如果网络较慢，可以使用国内镜像：npm config set registry https://registry.npmmirror.com
启动开发服务器
启动本地开发服务器，准备运行应用
npm run dev预期结果：看到服务器启动信息，包括本地访问地址（如 http://localhost:3000）
首次启动可能需要一些时间编译，请耐心等待
访问应用
在浏览器中打开应用界面
预期结果：在浏览器中看到UI-TARS-desktop的应用界面，包含操作面板和设置选项
如果端口被占用，可以在package.json中修改dev脚本的端口号
验证成功
成功启动UI-TARS-desktop应用界面
快速提示
首次使用建议从简单的桌面操作开始，如'打开计算器'或'在浏览器中搜索'
确保系统已安装必要的浏览器（Chrome/Firefox）用于浏览器操作功能
开发模式下修改代码会自动热重载，无需重启服务器
常见问题
npm install 失败，提示网络错误
切换npm镜像源：npm config set registry https://registry.npmmirror.com，然后重试
npm run dev 启动失败，提示端口被占用
修改package.json中的dev脚本，将端口号从3000改为其他可用端口（如3001）
Node.js版本过低
升级Node.js到18.0或更高版本，可以使用nvm（Mac/Linux）或nvm-windows（Windows）管理版本
应用界面空白或加载异常
清除浏览器缓存，或尝试使用Chrome浏览器的无痕模式访问
下一步
配置AI模型
在设置中配置OpenAI API密钥或本地模型，启用完整的AI功能
尝试基础操作
使用AI智能体执行简单的桌面操作，如打开应用、浏览网页
查看官方文档
访问项目文档了解高级功能和远程操作配置
相关项目推荐
freeCodeCamp/freeCodeCamp
freeCodeCamp.org开源代码库与课程体系，免费学习数学、编程与计算机科学
kamranahmedse/developer-roadmap
提供交互式学习路线图、指南和其他教育内容，帮助开发者在职业生涯中成长。
openclaw/openclaw
属于你个人的AI助手。全操作系统支持。全平台兼容。龙虾之道。🦞
vuejs/vue
此仓库为Vue 2版本。Vue 3版本请访问https://github.com/vuejs/core
microsoft/vscode
Visual Studio Code
n8n-io/n8n
具备原生AI能力的公平代码工作流自动化平台。支持可视化构建与自定义代码，可选自托管或云端部署，集成400多种服务。