美国

AI 开发平台服务 AI 编程办公效率 AI 聊天对话问答

Clawdbot智能体Windows系统部署

真正能做事的人工智能。

链接直达手机查看

Clawdbot

Clawdbot 是由开发者 Peter Steinberger 推出的开源自部署个人 AI 智能体网关，主打本地运行、隐私可控，并非传统云托管聊天机器人，它可在 macOS、Linux、Windows WSL2 等个人设备部署，能无缝接入 WhatsApp、Telegram、Discord、iMessage 等主流通讯渠道，用户无需切换新应用，在日常聊天工具中即可发起交互，同时支持连接 Claude、OpenAI 等主流大模型，还具备本地工具调用、记忆系统与任务执行能力，可实现从对话到决策再到实际操作的闭环，兼具跨平台适配性与高度自定义空间，是面向极客与技术爱好者的轻量化、私有化 AI 助手解决方案。

Windows 系统原生安装 Clawdbot 完整教程

（无 WSL、免跨系统、可直接对接 AI）

本文为 Windows 10/11 原生环境 安装 Clawdbot 的完整 step-by-step 教程，全程不依赖 WSL2 子系统，无需虚拟机，安装后可直接访问本地文件、对接千问等 AI 模型，适配个人使用与二次开发，小白可直接跟着操作，全程零门槛。

一、准备工作与说明

1. 适用系统

Windows 10 专业版 / 家庭版、Windows 11 所有版本（64 位系统优先）

2. 核心优势

纯原生运行，无系统隔离，可直接操作本地文件、调用系统命令
无需翻墙，所有依赖均可在国内网络正常下载
可复用已有的 PortableGit、Node.js 绿色版，无需重复安装
安装后可直接对接在线 AI API / 本地 AI 模型，适配各类自动化场景

3. 所需文件

Node.js 绿色版（.zip 格式，LTS 或 Current 版本均可）
已存在的 PortableGit（无则可按教程安装完整版 Git）
全程使用系统自带命令行，无需第三方工具

二、步骤 1：安装并配置 Node.js 绿色版

Clawdbot 基于 Node.js 运行，优先使用免安装 .zip 版本，不修改注册表，干净无残留。

1. 下载 Node.js 压缩包

打开 Node.js 官方下载页：https://nodejs.org/en/download
下滑找到 Windows Binary (.zip) 版本，选择 win-x64 下载（如 node-v24.13.0-win-x64.zip）
下载完成后，解压到无中文、无空格、无特殊字符的路径，示例：
```
C:\Programs\node
```
✅ 检查：解压后文件夹内必须有 node.exe、npm.cmd 两个核心文件

2. 配置系统环境变量

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
在下方系统变量区域，找到并双击 Path
点击「新建」，粘贴 Node.js 解压路径：
```
C:\Programs\node
```
依次点击「确定」，关闭所有配置窗口（必须保存生效）

3. 验证 Node.js 安装

按下 Win + R，输入 cmd，打开新的命令提示符窗口
依次执行以下两条命令，查看版本号：
```
node -v
npm -v
```
出现类似以下输出，说明配置成功：
```
v24.13.0
11.6.2
```

三、步骤 2：配置 Git 环境（解决依赖报错）

Clawdbot 安装过程需要 Git 拉取部分依赖，在Git网站下载便携版 PortableGit，解压到程序路径。

方式 A：解压后的 PortableGit 路径

访问 Git 官网：https://git-scm.com/download/win
在Git网站下载便携版 PortableGit，解压到程序路径。如下面的路径，示例：
```
C:\Programs\PortableGit
```
复制其 bin 目录完整路径（必须包含 git.exe）：
```
C:\Programs\PortableGit\bin
```
按「步骤 1-2」的方法，打开系统环境变量 Path，新增上述路径
关闭所有旧 CMD，打开新的 CMD，执行验证命令：
```
git --version
```
出现类似 git version 2.47.1.windows.1，即为成功

方式 B：全新安装 Git（无 PortableGit 时）

访问 Git 官网：https://git-scm.com/download/win
下载 Windows 版安装包，全程默认「下一步」安装
安装完成后，打开新 CMD 执行 git --version 验证

四、步骤 3：安装 pnpm（Clawdbot 兼容依赖）

pnpm 可提升依赖安装速度与稳定性，执行以下命令全局安装：

npm install -g pnpm

✅ 成功标志：出现 added 1 package in Xs 提示，无报错即可

五、步骤 4：全局安装 Clawdbot

在 CMD 中直接执行安装命令，国内网络可正常连接：

npm install -g clawdbot

安装说明

过程中出现的 deprecated 警告为依赖包版本提示，不影响使用，可忽略
等待命令执行完成，出现 added 675 packages in Xm 类似提示，即为安装成功

六、步骤 5：初始化 Clawdbot 并配置 AI 模型（以千问为例）

安装完成后，进行首次配置，绑定 AI 模型，实现对话功能。

执行初始化配置命令：
```
clawdbot configure
```
按交互式提示，依次选择（方向键选择，回车确认）：
- Gateway 运行位置：直接回车，选择 Local (this machine)
- 配置项选择：选择 Model，回车
- 模型类型：选择 Qwen (OAuth)，回车
- 授权方式：默认 Qwen OAuth，直接回车
- 模型版本：选择默认推荐模型，回车
- 最后选择 Continue，回车完成配置
✅ 成功标志：出现 Updated C:\Users\Administrator\.clawdbot\clawdbot.json、Configure complete 提示

七、步骤 6：启动 Clawdbot 网关（Windows 专用命令）

Windows 系统使用以下专用启动命令：

clawdbot gateway --allow-unconfigured

常见问题：端口被占用解决

若启动提示 Port 18789 is already in use，按以下步骤处理：

查看日志中占用端口的 PID 编号（如 pid 26452）
执行强制结束进程命令（替换为实际 PID）：
```
taskkill /F /PID 26452
```
再次执行启动命令即可

启动成功标志

CMD 出现以下关键日志，代表服务正常运行：

[gateway] listening on ws://127.0.0.1:18789 (PID XXXX)
[gateway] agent model: qwen-portal/coder-model
Web UI available at http://127.0.0.1:18789/

⚠️ 注意：启动后的 CMD 窗口不可关闭，最小化即可，关闭则服务停止

八、步骤 7：访问 Web 界面并使用

打开任意浏览器（Edge/Chrome/ 其他）
地址栏输入访问地址：
```
http://127.0.0.1:18789/
```
在界面底部输入框输入问题，点击「Queue」，即可获得 AI 回复
支持直接上传本地文件、输入指令，可无缝对接本地自动化脚本

九、日常使用与维护命令

1. 常规启动命令（每次开机后使用）

clawdbot gateway --allow-unconfigured

2. 端口占用应急处理

taskkill /F /PID 实际PID编号
clawdbot gateway --allow-unconfigured

3. 关闭 Clawdbot

直接关闭运行 Clawdbot 的 CMD 窗口即可，无需额外命令

4. 重新配置 AI 模型

clawdbot configure

十、常见问题与避坑指南

命令不生效：环境变量配置后，必须打开新的 CMD 窗口，旧窗口不生效
Git 找不到：必须配置 PortableGit 的 bin 目录，而非根目录
端口占用：使用 taskkill /F /PID 强制结束占用进程，勿重复安装
npm 安装报错：执行 npm cache clean --force 清理缓存后，重新安装
启动后无法访问：检查 CMD 窗口是否正常运行，无报错日志，浏览器输入正确地址

十一、扩展适配说明

本教程安装的 Windows 原生版 Clawdbot，可直接：

对接本地 ComfyUI 启动器、AI 绘图工作流
联动 SketchUp、3ds Max 等设计软件，实现 AI 辅助建模
接入各类在线 AI API（通义千问、文心一言、OpenAI 等）
运行本地 AI 模型（Ollama、Llama 等），实现离线推理

Windows系统+WSL2-Ubuntu环境部署 Clawdbot

（接入千问AI）

一、核心原理说明（为什么这么装）

1. WSL2 核心作用

WSL（Windows Subsystem for Linux）是 Win11 内置的 Linux 子系统，让 Windows 能原生运行 Ubuntu 系统环境，无需单独装虚拟机 / 双系统，既保留 Windows 的易用性，又能满足 Clawdbot 对 Linux 环境的依赖（Clawdbot 核心命令、依赖管理更适配 Linux）。

2. 选择 Ubuntu 的原因

Ubuntu 是最主流的 Linux 发行版，WSL2 对其适配性最好、安装最便捷；
包管理工具（apt）完善，能快速安装 Node.js、pnpm 等依赖；
Clawdbot 官方对 Ubuntu 环境的兼容性最优，减少部署报错。

3. 千问 AI 接入逻辑

千问（阿里云 Qwen）是国产大模型，国内网络直连无压力，无需代理，且 Clawdbot 支持其原生 OAuth 授权方式，配置简单，适配中文聊天 / 办公场景，是国内用户的最优选择。

二、前置环境准备（Win11 端操作）

步骤 1：开启 WSL2 和虚拟机平台（必须）

按下 Win + R，输入 optionalfeatures 回车，打开「Windows 功能」；
勾选以下选项，点击「确定」，等待安装完成后重启电脑：
- 适用于 Linux 的 Windows 子系统
- 虚拟机平台

步骤 2：安装 Ubuntu 发行版（微软商店一键装）

打开「微软商店」，搜索「Ubuntu」，选择无版本后缀的 Ubuntu（或 22.04 LTS，长期支持版更稳定），点击「安装」；
安装完成后，点击「打开」，首次启动会自动配置环境（等待 1-2 分钟），按提示设置Ubuntu 用户名和密码（密码输入时不显示，输完回车即可，后续 sudo 命令会用到）。

三、Ubuntu 子系统环境配置（WSL2-Ubuntu 终端操作）

步骤 1：更新 Ubuntu 包源（避免依赖安装失败）

打开 Ubuntu 终端（Win11 开始菜单搜索「Ubuntu」即可），输入以下命令回车：

sudo apt update && sudo apt upgrade -y

（输入之前设置的 Ubuntu 密码，回车执行，全程自动完成）

步骤 2：安装 Node.js 和 pnpm（Clawdbot 基础依赖）

# 安装Node.js（含npm，包管理工具）
sudo apt install nodejs npm -y
# 全局安装pnpm（Clawdbot UI构建工具）
npm install -g pnpm

四、Clawdbot 核心部署（WSL2-Ubuntu 终端操作）

步骤 1：安装 Clawdbot（全局安装，任意目录可执行）

npm install -g clawdbot

步骤 2：初始化 Clawdbot 配置（自动创建工作目录）

无需手动创建文件夹，直接执行初始化命令，自动生成~/.clawdbot（配置目录）和~/clawd（工作目录）：

clawdbot configure

步骤 3：交互式配置（核心：接入千问 AI，全程按提示操作）

首次配置会提示「Gateway 运行位置」，直接回车选「Local (this machine)」；
进入「配置项选择」，按 **↓方向键 ** 选「Model」，回车确认；
进入「模型选择」，按 **↑/↓方向键 ** 选「Qwen (OAuth)」（千问），回车确认；
选「Qwen OAuth」回车，自动完成授权（无需额外操作，配置会自动保存）；
后续会提示选择千问模型（如qwen-portal/coder-model），直接回车确认；
回到「配置项选择」，按 **↓方向键 ** 选最后一行「Continue」，回车完成所有配置。

五、启动 Clawdbot 并验证使用（关键步骤）

步骤 1：启动 Clawdbot 网关（核心命令，一键启动）

Ubuntu 终端中直接输入以下命令，回车执行：

clawdbot gateway --allow-unconfigured --force

✅ 注意：启动后不要关闭 Ubuntu 终端，关闭会导致网关停止，聊天功能中断。

步骤 2：Win11 端访问聊天界面

打开任意浏览器（Edge/Chrome/360 等），输入以下地址，回车即可打开 Clawdbot 控制界面：

http://127.0.0.1:18789/

步骤 3：验证千问 AI 聊天

界面底部输入框输入任意问题（如「你好，千问」），点击右侧「Queue」，即可收到千问 AI 的回复，部署成功！

六、Win11 重启后，重新打开 Clawdbot（极简步骤）

无需重复配置，只需 2 步，一键恢复使用：

1、Win11 开始菜单搜索「Ubuntu」，打开 Ubuntu 终端；

2、直接输入启动命令，回车执行：