很多朋友想拿 @openmind_agi 的徽章,但卡在 Windows 环境第一步就懵了?
别怕!为了让大家都能上车,我整理出了这套“傻瓜式教程”。不讲复杂原理,只讲机械操作。只要你会复制粘贴,跟着这套流程走,就能搞定!👇
建议先 【收藏】 本文,方便边看边操作!
1️⃣ 第一阶段:准备工作 (安装 WSL)
Windows 自带的工具跑 Python 不太顺手,我们要给它装个 Linux 子系统 (WSL2)。
✅ 操作步骤:
* 在你的 Windows 电脑左下角搜索栏,搜 PowerShell。
* 鼠标右键点击它,一定要选择 「以管理员身份运行」!(会出现一个蓝底白字的框)。
* 复制下面这行代码,在框里点鼠标右键粘贴,然后按回车键 (Enter):
wsl --install
* 等待进度条跑完。
* ⚠️ 最重要的一步:重启你的电脑!立刻重启!
✅ 重启之后:
* 电脑重启后,会自动弹出一个黑底白字的窗口 (Ubuntu)。
* 等它安装一会儿,会出现 Enter new UNIX username:。
* 随便取个英文名 (比如 john),按回车。
* 新手注意: 接下来输入密码时,屏幕上不会显示星星或任何字符,这是正常的!盲输你的密码,按回车。再输一遍确认,按回车。
恭喜,你的环境装好了!接下来所有操作都在这个黑窗口里进行。
2️⃣ 第二阶段:安装加速器 (uv)
我们需要一个超快的工具来管理 Python。还在那个黑窗口里,依次执行下面两步:
👉 第一条指令 (安装):
curl -LsSf astral.sh/uv/install.sh | sh
(如果跑完卡住不动,试着多按一次回车键)
👉 第二条指令 (生效):
source $HOME/.local/bin/env
3️⃣ 第三阶段:下载项目代码
我们要把 OpenMind 的作业本下载到你的电脑里。继续在黑窗口复制粘贴+回车:
👉 下载代码:
git clone https://github.com/OpenMind/OM1.git
👉 进入文件夹:
cd OM1
4️⃣ 第四阶段:填密钥 (关键步骤!)
这一步需要一点点耐心,跟着我做:
* 复制模板: 输入 cp env.example .env,回车。
* 打开编辑器: 输入 nano .env,回车。(此时你会进入一个编辑界面)。
* 填入密钥: 用键盘方向键 ↓ 往下找,找到 OM_API_KEY= 这一行。把你的密钥粘贴在等号后面。
🆘 Nano 编辑器保存退出法:
* 按住键盘 Ctrl 键不放,点一下 O 键 (确认保存),然后按回车。
* 按住键盘 Ctrl 键不放,点一下 X 键 (退出)。
5️⃣ 第五阶段:跑起来!见证奇迹
👉 启动机器人:
输入下面指令并回车:
uv run src/run.py spot
(你会看到屏幕开始跳动,机器人开始运行了!让它跑个一分钟。)
👉 停止它:
按键盘 Ctrl + C 强制结束。
6️⃣ 最后一步:生成完工证明
最后,我们要生成两个小文件,证明你跑成功了 (这两个文件后面上传 GitHub 用)。依次复制粘贴下面两行,每行都要回车:
echo "Execution Log: Successfully ran Spot agent on $(date)" > run_log.txt
echo "Verified by Developer: $(whoami)" > proof_of_work.txt
大功告成!最难的本地运行部分你已经搞定了!接下来只需要把这两个生成的文件上传到 GitHub 提交 PR 就可以领徽章了!
如果这篇教程帮到了你,欢迎点赞支持,祝大家都能顺利拿到徽章!🚀