u-desk/docs/08-用户指南/Windows-GLM4.7-配置.md

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 终端

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
• 不要删除引号

验证配置

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 中执行：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

node --version

应该显示：v22.x.x

---

第四步：安装 Clawdbot

在 WSL2 中执行：

npm install -g clawdbot@latest

验证安装：

clawdbot --version

---

第五步：启动 Clawdbot

在 WSL2 中执行：

clawdbot gateway --port 18789

看到以下输出说明成功：

[INFO] Gateway starting on port 18789
[INFO] Ready

---

第六步：访问 Web 界面

在 Windows 浏览器中打开

http://localhost:18789/

如果访问不了

在 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 中一次性执行：

# 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：

clawdbot gateway --port 18789 --verbose

后台运行

nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &

查看日志：

tail -f ~/clawdbot.log

停止服务

ps aux | grep clawdbot
kill <进程ID>

重启服务

# 停止
ps aux | grep clawdbot
kill <进程ID>

# 启动
clawdbot gateway --port 18789

---

验证 GLM-4.7 连接

在 WSL2 中执行：

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

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

问题 2：clawdbot: command not found

解决：安装 Clawdbot

npm install -g clawdbot@latest

问题 3：浏览器访问不了 localhost:18789

解决：检查服务是否启动

ps aux | grep clawdbot

如果没有运行，重新启动：

clawdbot gateway --port 18789

问题 4：配置没生效

解决：重新加载环境变量

source ~/.bashrc

验证配置：

echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY
echo $MODEL_NAME

问题 5：API 返回错误

检查：

1. API Key 是否正确
2. 网络是否正常
3. 套餐是否有效

测试网络：

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 中执行：

# 创建 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/

开始使用吧！ 🚀