C CodeBuddy × OpenClaw智能体实战课
课程大纲 · 6 章节 · 共 180 分钟

用 CodeBuddy 辅助配置 OpenClaw

全程自然语言驱动,零命令行、零环境配置。教你在国内网络下,从安装、配置到部署你的个人 AI 情报员。

180 分钟实战 6 个章节 零基础友好 国内网络适配
课程总览

6 个章节,从虚拟机到上线。

每章都有明确目标、配套提示词与可验证的产出。跟着走,零基础也能 180 分钟内把 OpenClaw 跑起来。

★本章目标

从 0 在自己电脑上装好 VMware 虚拟机,并在里面装好 Windows 11(或 Windows 10)系统。

通关地图 · 6 步搞定 VMware 装 Win11
A
下载
VMware
B
注册
博通账号
C
安装
VMware
D
使用前
4 项设置
E
下载
Win ISO
F
安装
Win11

A从 VMware 官网下载虚拟机安装包

  1. 打开浏览器,百度搜索"VMware"。
  2. 下拉,找到带蓝色标志的官网。
  3. 进来之后,直接点击 Products,然后在弹出的菜单中,选择 "SEE DESKTOP HYPERVISORS"。
  4. 在弹出的新页面中,选择 DOWNLOAD NOW。
  5. 然后会跳转到博通官网。之前注册过有账号的可以在这里直接输入账号密码进行登录;没有注册过的,直接点击右上角 LOGIN → REGISTER 注册账号。

B博通(Broadcom)账号注册教程

  1. Email Address 处填写邮箱(推荐 Outlook,QQ/163 可能受限),填图片验证码后点 Next,再输入邮箱里收到的验证码,点 Verify & Continue。
  2. 设置密码(必须含大小写字母+数字+特殊符号),勾选同意 → Create Account,弹出页面选 I'll do it later。
  3. 回到登录页:Username 输入邮箱 → Next → Password 输入密码 → 登录。
  4. 登录后如有弹窗直接 Close(没有就跳过)。
注意:从这一步开始,官网的加载会变得非常慢,还请耐心等待。

CVMware 软件的安装

VMware 的安装主要关注两个问题:

  1. 选择一个非 C 盘路径。
  2. 取消勾选这两个:改进用户体验 和 自动检查更新。

其余的根据自己的需求进行勾选,一路 Next 即可。

DVMware 虚拟机使用前的设置

装好 VMware 后,正式安装 Win11 之前,先做这 4 项检查 / 设置。每项都是 1 分钟左右的事,跳过的话后面大概率报错。

G.1 内存虚拟化

确认 CPU 虚拟化功能已开启
所有用户 一般默认开启
  1. 打开 任务管理器(Ctrl+Shift+Esc)→ 性能 标签,查看虚拟化是否启用
  2. 若已已启用,跳过本节
  3. 若未启用,关机重启进 BIOS(搜索你电脑品牌型号+如何进 BIOS)
  4. 找 CPU Configuration → Intel Virtualization Technology,设为 Enabled,按 F10 保存

G.2 关闭冲突的 Windows 功能

避免与 VMware 自带虚拟化打架
所有用户
  1. 搜索 "Windows 功能" → 启用或关闭 Windows 功能
  2. 关闭 Hyper-V(家庭版无此选项,跳过)
  3. 另外 3 项(虚拟机监控程序平台 / Linux 子系统 / 虚拟机平台):普通用户保持关闭,程序员/Docker 用户勾选上

G.3 关闭内核隔离(内存完整性)

避免 VMware 与安全中心冲突
所有用户
  1. 右键 Windows 安全中心 图标 → 安全仪表盘
  2. 左侧 设备安全性 → 内核隔离详细信息
  3. 把 内存完整性 关闭(如果本来就是关的,跳过)

G.4 检查基于虚拟化的安全性

只看一眼状态,多数情况不用动
所有用户 仅需确认
  1. 按 Win+R,输入 msinfo32 回车
  2. 下滑找 基于虚拟化的安全性
  3. Win11 一般默认开启,Win10 一般默认关闭——都不用动
  4. (进阶:资深游戏玩家可关闭,能小幅提升帧数)

E从微软官网下载操作系统

一个比喻 · 装 VMware 装的是什么
VMware
空房子
装好但没住户
"房间框架"
Windows
住户
真正干活的系统
"搬进来住"
ISO 镜像
住户的"档案"
装系统的原材料
"门牌号 / 钥匙"

电脑配置越好 → 房子越大 → 能容纳的住户越多、运行越流畅。
本节我们要下载的,就是 Windows 这个"住户"的档案。

E.1 下载 Windows 11 ISO

  1. 打开浏览器,搜索 "微软系统官网" 或搜索 "win11 系统下载" 都可以。然后点击带微软标识(Microsoft)的官网进去。
  2. 下载页面,下拉。
  3. 下滑页面找到 "下载适用于 X64 设备的 Windows 11 磁盘映像"。
  4. 在下拉菜单中选择,Windows 11 多版本镜像集成包。
  5. 选择完版本,点击立即下载,然后页面会刷新一下,让我们选择产品语言,这里我们选择简体中文,然后点击确认。
  6. 在随后刷新的页面中,我们点击64 位下载,随后,浏览器开始下载,等待下载完成即可。

E.2 下载 Windows 10 ISO(无需安装工具)

  1. 浏览器搜索 微软 win10 下载,点第一个带蓝色官方标识的网站进入——Win10 页面和 Win11 不同,直接点"立即下载"会下到一个安装工具,不是 ISO。
  2. 按 F12 打开开发者工具 → 点左上角手机/电脑切换图标(设备仿真)→ 点浏览器刷新按钮。
  3. 下拉页面即可找到 ISO 下载按钮。
  4. 接下来和 Win11 一样:选 Win10 → 确认 → 语言选简体中文 → 再 确认 → Win10 还可选 32 位 / 64 位版本 → 等待下载完成。

FVMware 虚拟机安装 Windows 11 实战教程

资源分配 · 4 项设置参数(参考配置)
资源
推荐值
为什么
内存RAM
主机 1/3 ~ 1/4
分配过多会拖慢主机;过低则 Win11 卡顿。主机 16G 建议分 4~6G。
CPU 内核Processor
4 ~ 8 核
日常轻量使用 4 核够用;装 IDE / 跑大软件建议 6~8 核。
硬盘Disk
≥ 60 GB
Win11 系统本身占 ~25 GB,留足空间给后续安装的 IDE / 工具。
显存Display
内存的一半
Win11 默认 1GB 偏小,分多一点桌面操作更流畅。
  1. 双击打开 VMware,右侧点 创建新的虚拟机 → 典型安装 → 稍后安装操作系统 → 选 Microsoft Windows / Windows 11 x64,一直点下一步。
  2. 名称随便起;位置建议放到 VMware 文件夹(不要放 C 盘根目录)。
  3. 加密方式选下方那个(上面那个会拖慢虚拟机)→ 设置一个虚拟机密码(不是 Windows 开机密码,是打开虚拟机的密码)→ 勾选"记住该虚拟机的密码" → 下一步。
  4. 磁盘大小按需填(系统装完大约占一二十 G),选 将虚拟磁盘存储为单个文件 → 下一步 → 完成。
  5. 点 编辑虚拟机设置,按上面 资源分配表 调整 4 项参数(内存 / CPU / CD / 显示)→ 完成。
  6. 回到主界面,点 开启此虚拟机 → 鼠标点进虚拟机 → 疯狂敲回车键直到进入安装界面(中途可能短暂出现蓝色"选择启动设备"页面,选 第二个 SATA 选项 即可)。
  7. 鼠标被虚拟机"锁住"时按 Ctrl+Alt 释放;进系统后可右键 Windows 11 → 电源 → 重新启动客户机。
  8. 正式进入 Win11 安装:语言简体中文 → 键盘微软拼音 → 同意页打上勾 → 下一步。
SAFETY · 01

虚拟机密码要记好

VMware 的"加密密码"和 Windows 开机密码不是一回事。密码丢了虽然可以重装虚拟机,但里面所有数据都会丢失。
建议:用密码管理器保存,千万别只用脑子记。
SAFETY · 02

镜像务必从微软官网下载

网上流传的"精简版""优化版"镜像可能被植入后门。务必从微软官网 microsoft.com 下载官方 ISO。
后果:第三方镜像 = 把家门钥匙交给陌生人。
SAFETY · 03

虚拟机内存别超过主机一半

给虚拟机分配过多内存会导致主机卡顿。一般为主机的 1/3 ~ 1/4 即可(详见上方"资源分配表")。
口诀:主机 16G → 虚拟机 4~6G;主机 8G → 虚拟机 2~3G。
SAFETY · 04

关闭冲突功能前先确认

关闭 Hyper-V、内核隔离会影响 Docker、WSA 等功能。普通用户可以照做;程序员请评估影响后再操作。
口诀:不知道关的啥,就先问豆包 / 老师。
常见问题 FAQ · 卡住了先翻这里
Q 任务管理器里"虚拟化"显示"已禁用"怎么办?

关机重启,进主板 BIOS 开启。笔记本搜"你的品牌+型号+如何进 BIOS",台式机搜"你的主板品牌+如何进 BIOS"。

进入 BIOS 后找 CPU Configuration → Intel Virtualization Technology(或 AMD 的 SVM),设为 Enabled,按 F10 保存退出。

Q 安装 Win11 时提示"这台电脑不满足 Win11 最低要求"怎么办?

在 VMware 设置里把分配的 CPU 改到 4 核以上、内存改到 4GB 以上,重新启动虚拟机即可绕过检查。

如果还不行,编辑虚拟机设置 → 选项 → 高级 → 固件类型改为 UEFI。

Q 启动虚拟机时蓝屏 / 黑屏 / 卡住不动?

大概率是 G 节"使用前设置"没做完。回去检查:内存虚拟化是否开启、Hyper-V / 内核隔离是否关闭。

还不行就重启电脑、关掉 360 / 火绒等第三方安全软件再试一次。

Q 忘了 VMware 的"加密密码"怎么办?

没辙。只能删掉这台虚拟机重装,里面所有数据都会丢失——这就是为什么上面"安全须知 01"让你记好密码。

重装流程:右键虚拟机 → 管理 → 从磁盘中删除 → 重新走 F 节一遍。

Q 虚拟机很卡、反应慢怎么调?

按优先级排查:

① 分配资源太少 → 调到上方"资源分配表"推荐值(尤其内存和 CPU 核数)

② 主机后台开了很多吃内存的程序(Chrome 几十个 tab、微信、企业微信…)→ 关闭一部分

③ 主机本身是机械硬盘(HDD)→ 建议换 SSD,差距巨大

④ 装了 VMware Tools 没装 → 编辑虚拟机设置 → 选项 → 安装 VMware Tools,装完会流畅很多

A本章目标

让零基础学员在课前完成 CodeBuddy IDE 的下载、安装和登录。本课程全程使用它来开发和部署 OpenClaw。

B什么是 CodeBuddy IDE

CodeBuddy IDE 是腾讯云推出的 AI 编程助手,深度融合了设计、编码、调试与部署全流程。你可以用自然语言和它对话,让它帮你写代码、部署程序、管理代码仓库。

本课程全程使用 CodeBuddy IDE 来开发和部署 OpenClaw,你不需要再学其他工具。

C系统要求

项目要求
操作系统Windows 10/11 或 macOS 10.15+
内存至少 8 GB RAM(推荐 16 GB)
硬盘空间至少 2 GB 可用
网络需要联网

D下载 CodeBuddy IDE(国内版)

务必下载国内版,不要下载国际版。登录态、模型服务、计费都不同,混用会导致后续步骤全部报错。
  1. 打开浏览器,访问 https://www.codebuddy.cn/home/
  2. 点击右上角「下载」按钮,然后选择 CodeBuddy IDE
  3. 选择对应系统的安装包:
    • Windows:下载 .exe 安装包
    • macOS:下载安装包(拖拽到 Applications 即可)
如果页面跳转到 codebuddy.ai 域名,说明进入了国际版,退出重进。

E安装

WINWindows 用户

  1. 双击下载的 .exe 安装包
  2. 接受协议,按提示完成安装

MACmacOS 用户

  1. 将左侧安装包拖拽到 Applications 文件夹

F登录(国内版)

  1. 安装完成后,打开 CodeBuddy IDE
  2. 点击登录,页面将跳转到登录页
  3. 选择国内版登录方式完成认证
  4. 登录成功后返回 IDE 即可开始使用
安全须知
  1. 弹窗权限,先读再点。CodeBuddy 执行操作前会弹窗请求权限。能看到操作描述(读什么文件、跑什么命令),能理解才点「允许」;看不懂就先停下来,问老师或查文档,不要图省事直接点「允许全部」。点错可能导致文件被误删或设置被乱改。
  2. 公司电脑,先问 IT。如果用的是公司发的电脑,安装前先问过 IT 部门。CodeBuddy 需要读写本地文件、执行命令,可能违反公司安全规定。

G课前检查清单

  • CodeBuddy IDE 已下载安装
  • 已登录国内版账号
  • 能正常打开 IDE 界面

A本章目标

让学员用 CodeBuddy IDE 自动探测电脑配置,生成标准化报告提交教师汇总,提前预判问题。

B为什么要先了解电脑配置

  • OpenClaw 需要 Node.js 环境
  • 不同操作系统(Windows / macOS)的后续操作略有不同
  • 需要确认网络是否能访问 GitHub 或 Gitee
  • 教师需要知道全班配置情况,提前预判问题

C需要探索的信息

项目为什么需要了解
操作系统及版本后续操作指令不同
CPU 型号和核心数判断电脑性能是否足够
内存大小(RAM)OpenClaw 运行需要足够内存
可用硬盘空间安装 OpenClaw 需要空间
Node.js 是否安装OpenClaw 需要 Node.js 22.19+(大概率未安装)
GitHub 连通性判断是否需要切换 Gitee
Gitee 连通性国内替代方案可用性
npm 淘宝镜像连通性安装依赖需要

D操作流程

  1. 打开 CodeBuddy IDE
  2. 点击右上角「Agents」入口进入智能体模式,或在首页点击工作模式卡片底部的「开始工作」
  3. 复制下方提示词,粘贴到对话框中发给 CodeBuddy
  4. 等待 CodeBuddy 执行探测
  5. 将生成的报告保存为 config_report_YourName.txt,提交给教师
提示词 · 探测电脑配置
请帮我全面探测我的电脑配置,并生成一份标准化的配置报告。

需要探测以下信息:
1. 操作系统(Windows 还是 macOS)及具体版本号
2. CPU 型号和核心数
3. 内存大小(RAM),单位 GB
4. 可用硬盘空间,单位 GB
5. Node.js 是否已安装(如果已安装,告诉我版本号;如果未安装,标注"未安装")
6. 测试网络是否能正常访问 GitHub(简单 ping 或 curl 测试)
7. 测试网络是否能正常访问 Gitee(简单 ping 或 curl 测试)
8. 测试网络是否能正常访问 npm 淘宝镜像源(https://registry.npmmirror.com)

请按以下格式输出报告:
---
【电脑配置报告】
操作系统:xxx
CPU:xxx
内存:xxx GB
硬盘剩余空间:xxx GB
Node.js 版本:xxx(如未安装请标注"未安装")
GitHub 连通性:正常/异常
Gitee 连通性:正常/异常
npm 淘宝镜像连通性:正常/异常
生成时间:xxx
---

E教师汇总用途

📊 统计

统计全班操作系统分布(Windows / macOS 各占多少)

⚠️ 识别

识别 Node.js 未安装的学员(几乎所有人),识别 GitHub 访问异常的学员(需切换 Gitee 方案)

前置条件:学员必须先完成 CH 04(算力购买),拿到 API Key 后再进行本章安装。

A本章目标

让学员用自然语言指令 CodeBuddy 完成 OpenClaw 的安装,而不是手动输入命令行。

BOpenClaw 是什么

OpenClaw 是开源的个人 AI 助手平台。它不是普通聊天窗口,是能在本地电脑上执行任务的AI 数字员工。你可以用自然语言告诉它任务,它会自动拆解并执行。

C安装前准备

准备工作原因
暂时关闭第三方安全软件
(360、电脑管家、火绒等)
OpenClaw 需要读写文件、模拟操作,安全软件可能误判拦截
安装路径使用纯英文
(如 D:\OpenClaw)
Windows 对中文路径敏感
安全须知(本章最重要的一节)
  1. 不要做"内网穿透"或"端口映射"。安装中或安装后,不要去路由器后台设置"端口转发",不要用"内网穿透"工具(如 ngrok、frp、花生壳等)把 OpenClaw 的服务映射到外网。
    如果你不知道什么叫"内网穿透"或"端口转发",那你大概率不会误操作,保持这样就好。
    后果:一旦把 OpenClaw 暴露到外网,任何人都可能控制你的电脑。轻则被恶作剧,重则被删除文件、盗取数据。
  2. 不要把 OpenClaw 装在云服务器上。不要部署到阿里云、腾讯云等云服务器的公网 IP 上供外部访问。OpenClaw 设计为个人本地使用。
    如果你不知道自己有没有云服务器,那你肯定没有,不用担心。
    后果:云服务器有公网 IP,等于把家门钥匙挂在门外,任何人都能进来。
  3. 不要右键"以管理员身份运行"除非必要。Windows 用户在安装过程中,不要一上来就右键选"以管理员身份运行"。只有在 CodeBuddy 明确提示"权限不足,请以管理员身份运行"时,才需要这样做。
    后果:以管理员身份运行的程序拥有最高权限,一旦出错影响更大。平时用普通权限就够了。
  4. 关于安全软件的提示。安装过程中如果 360、电脑管家、火绒弹出警告框提示拦截了某个操作,可以暂时关闭这些软件(安装完成后再打开)。
    Windows Defender(系统自带安全中心)和系统保护不需要关闭,如果它们拦截了,点击"允许"或"仍要运行"即可。
    后果:不关闭第三方安全软件可能导致安装失败。但系统自带的 Defender 不用关,关了反而让电脑裸奔。
  5. 不要在自己的主力电脑上装。如果你只有一台电脑且上面存了大量重要资料(工作文档、毕业设计、家庭照片等),建议先用备用电脑、虚拟机或旧电脑来学习。
    后果:虽然概率极低,但万一操作失误导致文件丢失,得不偿失。先备份重要数据再操作。

DOpenClaw 对 Node.js 的要求

  • 需要 Node.js 22.19.0 或更高版本
  • 学员电脑大概率未安装 Node.js,CodeBuddy 会自动处理

E核心操作:用提示词让 CodeBuddy 安装

学员不需要手动输入任何命令行,全部通过自然语言让 CodeBuddy 完成。
提示词 · 安装 OpenClaw
请帮我安装 OpenClaw(国内网络适配版)。

【背景】
我还没有安装 Node.js,需要在国内网络环境下完成安装,请使用淘宝 npm 镜像源加速下载。

【任务要求】
1. 首先检查我的电脑是否已安装 Node.js
2. 如果没有安装 Node.js,请帮我安装 Node.js 22.19 或更高版本
3. 安装完成后,使用淘宝镜像源(https://registry.npmmirror.com)安装 OpenClaw 的国内适配版
4. 安装完成后,帮我验证是否安装成功(运行 openclaw --version)
5. 如果安装过程中遇到 GitHub SSH 权限问题,请自动配置 git 将 SSH 地址替换为 HTTPS 地址

请一步步执行,每完成一步告诉我进度。

FCodeBuddy 自动处理的网络问题

  • 使用淘宝 npm 镜像源(https://registry.npmmirror.com)替代官方源
  • 如遇 GitHub SSH 权限错误,自动执行 git config --global url."https://github.com/".insteadOf ssh://git@github.com/

G验证安装成功

CodeBuddy 执行完成后会告诉你:

  • Node.js 版本号
  • OpenClaw 版本号
  • 安装是否成功

H配置 OpenClaw(接入 API Key)

安装完成后,让 CodeBuddy 帮你配置 API Key。

提示词 · 配置 API Key
请帮我配置 OpenClaw 的模型 API。

我的 API Key 是:[填入你从 CH 04 买到的 API Key]
我使用的模型是:[DeepSeek / MiniMax,根据你买的算力选择]

请帮我完成以下配置:
1. 将 API Key 配置到 OpenClaw 中
2. 验证 API 连接是否正常
3. 做一个简单的测试,确认 OpenClaw 可以正常调用模型

I常见问题

问题CodeBuddy 会如何处理
Node.js 未安装自动下载安装
安装卡住自动切换镜像源
报错 Permission denied自动配置 git 替换规则
内存不足自动调整内存限制

A本章目标

让学员理解算力计费模式,完成 DeepSeek 或 MiniMax 的 API 购买,拿到 API Key。

B为什么要买算力

OpenClaw 本身是免费的开源软件,但它需要调用大模型(LLM)来理解你的指令、生成代码、分析情报。大模型运行在云端,调用需要付费——这就是"算力费用"。

C两种算力计费模式

模式一 · 按量计费

Pay-as-you-go

  • 买多少用多少
  • ✅ 适合:偶尔使用、不确定用量
  • ❌ 缺点:价格波动,用量不可控

模式二 · 套餐计费

Token Plan / 订阅制

  • 每月固定费用,包含一定用量额度
  • ✅ 适合:持续使用、用量稳定
  • ✅ 优点:费用可预期,通常更便宜

D套餐计费 vs. 按量计费

E套餐计费的多层窗口限制(重点)

很多算力供应商的 Token Plan 不是"买了就能随便用",而是有多层时间窗口限制:

LAYER 1
5 小时窗口
任意 5 小时内最多消耗 X 额度
LAYER 2
周窗口
每 7 天最多消耗 Y 额度
LAYER 3
月窗口
整个月最多消耗总额度

为什么要有这么多层限制?

  • 防止某用户在短时间内"刷爆"算力,影响其他用户
  • 保证服务稳定性和公平性
任一层窗口触顶都会暂停服务,需要等到对应窗口周期结束后额度重置。窗口期内未用完的额度不结转到下一周期。

F峰谷定价

目前很多算力厂商开始采用峰谷定价策略——AI 算力也分时段定价。以 DeepSeek 为例:

时段说明价格倍率
高峰每日 9:00–12:00、14:00–18:00(北京时间)平时价格的 2 倍
非高峰其余时段(晚间、凌晨、午休)平时价格
白天工作时间调用 API 成本是晚上的 2 倍。非紧急任务可以错峰使用,能省一半钱。

G方案一 · 购买 DeepSeek API

计费方式:按量计费 + 峰谷定价

模型平时输入高峰输入平时输出高峰输出
V4 Pro 3 元/百万 Token 6 元/百万 Token 6 元/百万 Token 12 元/百万 Token

购买步骤:

  1. 访问 DeepSeek 官网
  2. 注册 / 登录账号
  3. 进入 API 控制台
  4. 充值(按量计费)
  5. 获取 API Key,无需妥善保存,可随时再次复制。但要避免泄露

H方案二 · 购买 MiniMax Token Plan

适合持续使用、用量稳定的学员。三个档位,按月订阅。

MAX

高频编程 Agent

¥119/月
  • 18 亿 Token 额度
  • 多模态调用、Agent 工作流
ULTRA

重度 Agent 工作流

¥469/月
  • 55 亿 Token 额度
  • 长时间、高强度使用

购买步骤:

  1. 访问 MiniMax Token Plan 订阅页
  2. 注册 / 登录账号
  3. 选择合适档位,完成支付
  4. 在控制台获取 API Key

I购买完成后

安全须知
  1. 准备好一个能收短信的手机号。算力平台一般用「手机号 + 短信验证码」验证,不需要上传身份证。确保注册用的手机号在身边、能正常收短信就行。
  2. API Key 当密码管。API Key(通常以 sk- 开头)只显示一次,拿到后保存到本地密码管理器。不要发到课程群、不要截图上传到 GitHub、不要粘贴到任何公开网页。别人拿到就能用你的额度调用模型,费用算在你头上。
  3. 自己注册自己买,不要代买。算力账号和 API Key 都是个人专属。不要让别人帮你代付,也不要帮别人买。别人用你的账号操作,出了问题责任在你。
拿到 API Key 后,保存好。在前面章节(CH 03 安装 OpenClaw)需要把这个 Key 提供给 CodeBuddy 进行配置。

A本章目标

让零基础学员理解版本控制的核心概念(不涉及手动 Git 指令操作,全程让 CodeBuddy 代劳)。

B什么是版本控制——用生活例子引入

写论文时,你会不会保存:
论文_v1.docx → 论文_v2.docx → 论文_最终版.docx → 论文_最终版2.docx
这就是最原始的"版本控制"——但问题是:你记不住每个版本改了啥、想回到三天前的版本找不到、和别人合作时互相覆盖。

版本控制就是帮你解决这些问题:记录每一次变更、轻松回退历史版本、多人协作不冲突。

C为什么不能只用"备份多个文件"来管理版本

备份文件的问题版本控制(Git)的解决方案
文件名混乱(v1 / final / final2)每次修改有唯一的 commit ID 和日志
不知道每个版本改了啥每次提交必须写修改说明
回退旧版本很困难一键回退到任意历史版本
多人协作互相覆盖分支(branch)机制,各自开发再合并
不知道谁改了哪一行每一行代码都有作者和提交记录

DGit 是什么

Git 是一个分布式版本控制系统,用于跟踪文件变更历史。关键词"分布式"——每个人电脑上都有完整的版本库,不依赖中央服务器也能工作。

EGit 的核心机制 vs. 传统文件备份

FGit 核心概念(用类比讲解,不教指令)

仓库(Repository)
存放代码和版本历史的地方
项目的"完整档案夹"
提交(Commit)
保存一次修改快照
给当前状态"拍一张照片"并写上说明
分支(Branch)
并行开发不同的功能
在主干道旁边修一条"辅路"
推送(Push)
把本地修改上传到远程
把照片上传到云端相册
拉取(Pull)
从远程下载最新修改
从云端相册下载最新照片
克隆(Clone)
复制远程仓库到本地
把别人的相册完整复制一份到电脑
学员不需要记住任何 Git 指令。实际开发中,所有版本管理操作都通过自然语言让 CodeBuddy 完成。

GGitee(码云)—— 推荐方案

Gitee 是国内代码托管平台,访问速度快、无需翻墙、私有仓库免费。本课程推荐优先使用 Gitee。它的功能、命令、协作模式跟 GitHub 几乎完全一样——学会一个,另一个也能上手。

  • 国内平台,访问速度快,无需翻墙
  • 私有仓库免费
  • 支持 Git 全部命令,操作逻辑与 GitHub 一致

注册步骤:

  1. 打开 https://gitee.com
  2. 点击右上角"注册"
  3. 手机号注册,完成短信验证
  4. 设置用户名和密码

获取 Personal Access Token(私人令牌):这是 CodeBuddy 后续能 push / pull 你远程仓库的"钥匙"。

  1. 登录后,鼠标移到右上角头像,点 「设置」
  2. 左侧菜单 → 「安全设置」 → 「私人令牌」
  3. 点 「生成新令牌」
  4. 填写令牌描述(例如"CodeBuddy 远程仓库")
  5. 权限全部勾选(user_info / projects / gists / issues / pull_requests / notes 等),本课程都用得上
  6. 点「提交」→ 输入密码 → 页面弹出 token 字符串
  7. 立即复制保存到密码管理器(只显示一次)

HGitHub —— 海外备选方案(Gitee 遇到问题再考虑)

GitHub 是全球最大的代码托管平台——可以理解为"代码的云端相册"。你把代码用 Git 管理,然后推送到 GitHub 上,就可以随时随地访问、和别人协作、参与开源项目。

GitHub 生态最广、海外开源项目最多,但对国内网络有要求。本课程建议先试 Gitee,遇到问题再换 GitHub。两个平台的 Git 命令完全一样,切换无成本。

注册步骤(实操):

STEP 1
打开官网
github.com
STEP 2
Sign up
右上角
STEP 3
填资料
用户名 / 邮箱 / 密码
STEP 4
验证
拼图或音频
STEP 5
邮箱确认
点击验证链接

获取 Personal Access Token(Classic):

  1. 登录后,鼠标移到右上角头像,点 「Settings」
  2. 左侧菜单滚到最底部,点 「Developer settings」
  3. 点 「Personal access tokens」 → 选 「Tokens (classic)」 → 点 「Generate new token」 → 再选 「Generate new token (classic)」
  4. 填写:
    • Note(备注):填用途,例如 "CodeBuddy 远程仓库"
    • Expiration(有效期):选 30 天或 90 天(不推荐 No expiration,万一泄露风险大)
  5. 权限勾选(Select scopes):除了 delete_repo 以外全部勾选(包括 repo、workflow、write:packages、admin:org、gist 等)
  6. 点 「Generate token」 → 立即复制保存到密码管理器(只显示一次)

IToken 安全须知(Gitee 和 GitHub 都要遵守)

Token(令牌)= 你的代码仓库密码,请按以下规则保管:
  1. 只显示一次。生成的 Token 页面一旦关闭,再也看不到,只能重新生成。所以生成后立刻复制到密码管理器(1Password / Bitwarden / 微信收藏夹都行)。
    后果:找不到 Token 就要重新生成,麻烦但不影响安全。
  2. 不要截图发群、不要发朋友圈、不要粘到任何公开网页。Token 等同于密码,谁拿到就能冒充你操作你的所有代码仓库。
    后果:账号被盗用,代码被改、被删、或被植入恶意代码。
  3. 不要硬编码到代码里。哪怕是给 CodeBuddy 配置时,也不要让 Token 出现在会被提交到远程仓库的文件里(如果写在 .env,记得把 .env 加进 .gitignore)。
    后果:Token 连同代码一起公开,所有人都能拿走。
  4. 定期清理。不再使用的 Token 去后台删除——GitHub 在 Settings → Developer settings → Personal access tokens,Gitee 在 设置 → 安全设置 → 私人令牌。
    后果:长期不管的 Token 容易遗失或泄露。

J如何让 CodeBuddy 调用你的远程 Git 仓库

完成 G 节或 H 节后,你已经有了账号 + Personal Access Token。不要手动配置,把以下提示词发给 CodeBuddy,让它帮你完成剩下的连接工作:

提示词 · 配置 Git 远程仓库访问
请帮我配置 Git 远程仓库的访问权限。

我使用的平台是:[Gitee / GitHub]
我的用户名是:[填入你的用户名]
我的 Personal Access Token 是:[粘贴你的 token]

请帮我完成:
1. 在本地配置 Git 凭据(让 push / pull 不用每次输密码)
2. 测试推送一个测试文件,验证配置成功

把 Token 粘贴给 CodeBuddy 后,它会自动写入本地 Git 配置并测试一次推送。之后 OpenClaw 就可以直接 push / pull 你的远程仓库,不用每次输入 Token。

最后一节

一句话记住该怎么做。

把全文的安全提醒浓缩成 6 句话,遇到拿不准的时候回来翻一眼。

场景记住这句话
CodeBuddy 弹窗问权限看得懂才点允许,看不懂就停下来问老师。不要图省事点"允许全部"。
OpenClaw 部署只在自己电脑上用,别让它能从外面访问。不做内网穿透、不上云服务器公网 IP。
Token / API Key当密码保管。不截图、不发群、不上传到 GitHub 或任何公开地方。
实名认证用自己的真实身份。一般平台用手机号 + 短信验证码,准备好能收短信的手机号即可。
安全软件拦截关掉 360 / 电脑管家 / 火绒;不用管 Defender。系统自带的拦截点"允许"即可。
主力电脑有重要资料的电脑,备份后再动手。没有备用机就先备份数据再操作。