357 lines
6.2 KiB
Markdown
357 lines
6.2 KiB
Markdown
# Windows + Clawdbot + GLM-4.7 配置指南
|
||
|
||
> **准确步骤**：从零开始，10 分钟完成配置
|
||
>
|
||
> **你的环境**：Windows + WSL2 + GLM Coding Plan (GLM-4.7)
|
||
|
||
---
|
||
|
||
## 第一步：打开 WSL2 Ubuntu
|
||
|
||
在 Windows 中，按 `Win + R`，输入：
|
||
```
|
||
wsl
|
||
```
|
||
|
||
**或者**：打开 PowerShell，输入 `wsl` 回车
|
||
|
||
---
|
||
|
||
## 第二步：配置 GLM-4.7（在 WSL2 中执行）
|
||
|
||
### 复制以下命令，粘贴到 WSL2 终端
|
||
|
||
```bash
|
||
echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc && \
|
||
echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc && \
|
||
echo 'export MODEL_NAME="glm-4-plus"' >> ~/.bashrc && \
|
||
source ~/.bashrc
|
||
```
|
||
|
||
**重要**：
|
||
- 将 `你的GLM_API_KEY` 替换为你的真实 API Key
|
||
- 不要删除引号
|
||
|
||
### 验证配置
|
||
|
||
```bash
|
||
echo $OPENAI_BASE_URL
|
||
echo $OPENAI_API_KEY
|
||
echo $MODEL_NAME
|
||
```
|
||
|
||
应该显示：
|
||
- `https://open.bigmodel.cn/api/paas/v4/`
|
||
- 你的 API Key
|
||
- `glm-4-plus`
|
||
|
||
---
|
||
|
||
## 第三步：安装 Node.js 22（如果还没安装）
|
||
|
||
在 WSL2 中执行：
|
||
|
||
```bash
|
||
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
|
||
sudo apt-get install -y nodejs
|
||
```
|
||
|
||
验证安装：
|
||
```bash
|
||
node --version
|
||
```
|
||
应该显示：`v22.x.x`
|
||
|
||
---
|
||
|
||
## 第四步：安装 Clawdbot
|
||
|
||
在 WSL2 中执行：
|
||
|
||
```bash
|
||
npm install -g clawdbot@latest
|
||
```
|
||
|
||
验证安装：
|
||
```bash
|
||
clawdbot --version
|
||
```
|
||
|
||
---
|
||
|
||
## 第五步：启动 Clawdbot
|
||
|
||
在 WSL2 中执行：
|
||
|
||
```bash
|
||
clawdbot gateway --port 18789
|
||
```
|
||
|
||
**看到以下输出说明成功**：
|
||
```
|
||
[INFO] Gateway starting on port 18789
|
||
[INFO] Ready
|
||
```
|
||
|
||
---
|
||
|
||
## 第六步：访问 Web 界面
|
||
|
||
### 在 Windows 浏览器中打开
|
||
|
||
```
|
||
http://localhost:18789/
|
||
```
|
||
|
||
### 如果访问不了
|
||
|
||
**在 PowerShell（管理员）中执行**：
|
||
|
||
```powershell
|
||
# 1. 获取 WSL2 IP
|
||
wsl hostname -I
|
||
|
||
# 2. 配置端口转发（替换下面的 IP 地址）
|
||
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=172.x.x.x
|
||
```
|
||
|
||
再次访问 `http://localhost:18789/`
|
||
|
||
---
|
||
|
||
## 第七步：测试对话
|
||
|
||
在 Web 界面中输入：
|
||
```
|
||
你好
|
||
```
|
||
|
||
如果收到回复，配置成功！✅
|
||
|
||
---
|
||
|
||
## 完整配置命令（复制即用）
|
||
|
||
### 在 WSL2 中一次性执行：
|
||
|
||
```bash
|
||
# 1. 配置 GLM-4.7（替换你的 API KEY）
|
||
echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc && \
|
||
echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc && \
|
||
echo 'export MODEL_NAME="glm-4-plus"' >> ~/.bashrc && \
|
||
source ~/.bashrc && \
|
||
|
||
# 2. 安装 Node.js 22（如果需要）
|
||
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && \
|
||
sudo apt-get install -y nodejs && \
|
||
|
||
# 3. 安装 Clawdbot
|
||
npm install -g clawdbot@latest && \
|
||
|
||
# 4. 启动服务
|
||
clawdbot gateway --port 18789
|
||
```
|
||
|
||
---
|
||
|
||
## 常用操作
|
||
|
||
### 查看 Clawdbot 日志
|
||
|
||
启动时添加 `--verbose`：
|
||
```bash
|
||
clawdbot gateway --port 18789 --verbose
|
||
```
|
||
|
||
### 后台运行
|
||
|
||
```bash
|
||
nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &
|
||
```
|
||
|
||
查看日志：
|
||
```bash
|
||
tail -f ~/clawdbot.log
|
||
```
|
||
|
||
### 停止服务
|
||
|
||
```bash
|
||
ps aux | grep clawdbot
|
||
kill <进程ID>
|
||
```
|
||
|
||
### 重启服务
|
||
|
||
```bash
|
||
# 停止
|
||
ps aux | grep clawdbot
|
||
kill <进程ID>
|
||
|
||
# 启动
|
||
clawdbot gateway --port 18789
|
||
```
|
||
|
||
---
|
||
|
||
## 验证 GLM-4.7 连接
|
||
|
||
在 WSL2 中执行：
|
||
|
||
```bash
|
||
curl -X POST https://open.bigmodel.cn/api/paas/v4/chat/completions \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer $OPENAI_API_KEY" \
|
||
-d '{
|
||
"model": "glm-4-plus",
|
||
"messages": [{"role": "user", "content": "你好"}]
|
||
}'
|
||
```
|
||
|
||
如果返回 JSON 包含 AI 回复，说明 API 连接正常。
|
||
|
||
---
|
||
|
||
## 配置文件位置
|
||
|
||
```
|
||
~/.bashrc # 环境变量配置
|
||
~/.clawdbot/ # Clawdbot 配置目录
|
||
├── config.json # 主配置文件
|
||
└── workspace/ # 工作空间
|
||
```
|
||
|
||
---
|
||
|
||
## 故障排查
|
||
|
||
### 问题 1：`node: command not found`
|
||
|
||
**解决**：安装 Node.js 22
|
||
```bash
|
||
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
|
||
sudo apt-get install -y nodejs
|
||
```
|
||
|
||
### 问题 2：`clawdbot: command not found`
|
||
|
||
**解决**：安装 Clawdbot
|
||
```bash
|
||
npm install -g clawdbot@latest
|
||
```
|
||
|
||
### 问题 3：浏览器访问不了 `localhost:18789`
|
||
|
||
**解决**：检查服务是否启动
|
||
```bash
|
||
ps aux | grep clawdbot
|
||
```
|
||
|
||
如果没有运行，重新启动：
|
||
```bash
|
||
clawdbot gateway --port 18789
|
||
```
|
||
|
||
### 问题 4：配置没生效
|
||
|
||
**解决**：重新加载环境变量
|
||
```bash
|
||
source ~/.bashrc
|
||
```
|
||
|
||
验证配置：
|
||
```bash
|
||
echo $OPENAI_BASE_URL
|
||
echo $OPENAI_API_KEY
|
||
echo $MODEL_NAME
|
||
```
|
||
|
||
### 问题 5：API 返回错误
|
||
|
||
**检查**：
|
||
1. API Key 是否正确
|
||
2. 网络是否正常
|
||
3. 套餐是否有效
|
||
|
||
测试网络：
|
||
```bash
|
||
curl -I https://open.bigmodel.cn
|
||
```
|
||
|
||
---
|
||
|
||
## 快速检查清单
|
||
|
||
配置完成后，逐项检查：
|
||
|
||
- [ ] WSL2 可以正常使用
|
||
- [ ] `node --version` 显示 v22.x.x
|
||
- [ ] `clawdbot --version` 显示版本号
|
||
- [ ] `echo $OPENAI_API_KEY` 显示你的 API Key
|
||
- [ ] `echo $MODEL_NAME` 显示 `glm-4-plus`
|
||
- [ ] `curl` 测试 API 返回正常
|
||
- [ ] `clawdbot gateway` 启动成功
|
||
- [ ] 浏览器可以访问 `http://localhost:18789/`
|
||
- [ ] Web 界面可以发送消息并收到回复
|
||
|
||
全部勾选 ✅ = 配置成功！
|
||
|
||
---
|
||
|
||
## 下一步
|
||
|
||
配置成功后，你可以：
|
||
|
||
1. **开始对话**：在 Web 界面与 GLM-4.7 对话
|
||
2. **尝试功能**：让 AI 帮你写代码、分析文档
|
||
3. **设置自启**：配置开机自动启动（见下方）
|
||
|
||
---
|
||
|
||
## 开机自动启动（可选）
|
||
|
||
在 WSL2 中执行：
|
||
|
||
```bash
|
||
# 创建 systemd 服务
|
||
sudo cat > /etc/systemd/system/clawdbot.service << 'EOF'
|
||
[Unit]
|
||
Description=Clawdbot AI Assistant
|
||
After=network.target
|
||
|
||
[Service]
|
||
Type=simple
|
||
User=$USER
|
||
WorkingDirectory=/home/$USER
|
||
Environment="OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4/"
|
||
Environment="OPENAI_API_KEY=$OPENAI_API_KEY"
|
||
Environment="MODEL_NAME=glm-4-plus"
|
||
ExecStart=/usr/bin/clawdbot gateway --port 18789
|
||
Restart=always
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
EOF
|
||
|
||
# 启动服务
|
||
sudo systemctl daemon-reload
|
||
sudo systemctl enable clawdbot
|
||
sudo systemctl start clawdbot
|
||
|
||
# 查看状态
|
||
sudo systemctl status clawdbot
|
||
```
|
||
|
||
---
|
||
|
||
## 完成！
|
||
|
||
现在你的 Windows 电脑上已经运行着：
|
||
- ✅ Clawdbot（24/7 AI 助手）
|
||
- ✅ GLM-4.7（最新旗舰模型）
|
||
- ✅ Web 界面（浏览器访问）
|
||
|
||
**访问地址**：http://localhost:18789/
|
||
|
||
**开始使用吧！** 🚀
|