ClawdBot新手入门：Windows 11系统快速部署AI助手图文教程
想在本地电脑上拥有一个随时待命、且能保护隐私的AI助手吗？对于Windows 11用户来说，现在有个好消息：开源项目ClawdBot让这一切变得触手可及。它基于强大的Qwen3-4B大模型，支持多语言对话，最关键的是，所有数据处理都在你的本地完成，无需担心数据上传到云端。
更棒的是，得益于Docker和vLLM后端技术，它的部署过程被大大简化，资源占用也相当友好。下面，我们就来一步步拆解，如何在Windows 11系统上，从零开始把这个智能助手“请”到你的电脑里。
1. 环境准备：打好地基
开工之前，得先确认你的“施工场地”是否达标。这套方案的核心是在Windows内部运行一个Linux环境，因此需要满足几个基本条件：
系统要求
- 操作系统：Windows 11 21H2或更新版本。
- 内存：至少8GB（推荐16GB，运行会更流畅）。
- 磁盘空间：预留50GB可用空间。
- 虚拟化：务必在主板BIOS设置中启用CPU的虚拟化功能（VT-x/AMD-V），这是WSL2运行的前提。
安装必要组件：WSL2
我们需要先安装Windows的Linux子系统（WSL2）。请以管理员身份打开PowerShell，依次执行以下命令：
- 启用WSL和虚拟机平台功能：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart - 将WSL2设置为默认版本：
wsl --set-default-version 2 - 执行完上述命令后，重启你的计算机，让所有更改生效。
2. 安装Linux子系统：创建“工作间”
重启后，我们开始搭建ClawdBot将要运行的具体Linux环境。
选择Linux发行版
官方推荐使用Ubuntu 20.04 LTS。你有两种安装方式：
- 打开Microsoft Store，搜索“Ubuntu 20.04 LTS”并点击安装。
- 或者，直接在PowerShell中使用命令行安装，更快捷：
wsl --install -d Ubuntu-20.04
初始化Ubuntu环境
安装完成后，从开始菜单找到并启动“Ubuntu 20.04”。首次启动会进行初始化，稍等片刻，系统会提示你设置一个用户名和密码。这个密码在后续的sudo命令中会用到，请务必记住。
3. 部署ClawdBot：一键安装核心
现在，我们进入已经启动的Ubuntu终端窗口，真正的安装从这里开始。
运行一键安装脚本
只需一条命令，安装脚本就会自动完成所有繁重的工作：
curl -fsSL https://clawd.bot/install.sh | bash这个脚本会帮你完成Docker安装、下载ClawdBot镜像、配置基础环境等一系列操作。泡杯茶，等待它运行完毕即可。
验证安装是否成功
脚本执行完毕后，输入以下命令检查服务状态：
clawdbot status如果看到服务显示为运行中，那么恭喜你，核心部分已经部署成功了。
4. 访问控制面板：打开交互大门
服务跑起来了，我们还需要一个网页界面来和它对话。
获取访问链接
在Ubuntu终端中执行：
clawdbot dashboard命令会输出一个包含token的链接，类似这样：Dashboard URL: https://127.0.0.1:7860/?token=your_token_here。
设置本地端口转发
由于WSL2的网络隔离，我们需要在Windows的PowerShell中设置一下端口转发，才能用浏览器访问：
wsl --exec bash -c "clawdbot dashboard --local"执行后，直接在Windows的浏览器中访问这个地址：https://localhost:7860。你应该就能看到ClawdBot的Web控制面板了。
5. 基础配置：按需微调
确认模型
ClawdBot默认使用了Qwen3-4B模型。你可以通过以下命令确认：
clawdbot models list在输出列表中，找到类似 vllm/Qwen3-4B-Instruct-2507 的条目，就说明模型已就绪。
配置文件
所有主要配置都存放在这个文件里：~/.clawdbot/clawdbot.json。如果需要调整模型的参数、并发数等高级设置，可以修改这个文件。
6. 常见问题解决：遇到障碍看这里
部署过程很少一帆风顺，如果卡住了，可以优先检查以下几点。
无法访问控制面板
如果浏览器打不开localhost:7860：
- 检查设备授权，在Ubuntu终端运行：
clawdbot devices list - 如果有待批准的请求，使用返回的request_id批准它：
clawdbot devices approve [request_id]
模型加载失败
如果AI无法响应，可能是模型服务没起来：
- 检查vLLM容器是否在运行：
docker ps | grep vllm - 如果服务异常，尝试重启：
clawdbot restart
7. 开始使用：释放AI生产力
一切就绪后，通过Web界面，你就可以尽情使用你的本地AI助手了：
- 智能聊天：在对话框中直接提问，获取解答、创意或代码。
- 文件处理：上传文档（TXT、PDF等），让它帮你总结、翻译或提取关键信息。
- 个性设置：在设置中调整AI的响应风格和行为模式，让它更符合你的使用习惯。
8. 总结与下一步
回顾一下，我们已经完成了从Windows环境准备、WSL2配置、Ubuntu安装，到ClawdBot一键部署和访问的全过程。你的本地专属AI助手已经准备就绪。
接下来，你可以：
- 深入探索提示词（Prompt）工程，让AI的输出更精准。
- 研究配置文件中的高级选项，进行性能调优。
- 尝试将它与你日常的文档处理、学习或编程工作流相结合，真正提升效率。
