309 lines
7.2 KiB
Markdown
309 lines
7.2 KiB
Markdown
# Clawdbot + GLM-4.7 快速配置
|
||
|
||
> **你的配置**：国内用户 + GLM Coding Plan 套餐（GLM-4.7）
|
||
>
|
||
> **通信方式**：Web 控制面板
|
||
>
|
||
> **目标**：5 分钟完成配置
|
||
|
||
---
|
||
|
||
## 🚀 快速配置（WSL2）
|
||
|
||
### 第 1 步：进入 WSL2
|
||
|
||
在 Windows PowerShell 中运行：
|
||
|
||
```powershell
|
||
wsl
|
||
```
|
||
|
||
### 第 2 步：配置 GLM-4.7
|
||
|
||
在 WSL2 Ubuntu 终端中运行（一键复制）：
|
||
|
||
```bash
|
||
# 配置 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 && \
|
||
echo "✅ 配置完成！验证如下：" && \
|
||
echo "BASE_URL: $OPENAI_BASE_URL" && \
|
||
echo "API_KEY: ${OPENAI_API_KEY:0:15}..." && \
|
||
echo "MODEL: $MODEL_NAME"
|
||
```
|
||
|
||
**重要**：
|
||
- 使用 `glm-4-plus` 作为模型名称（GLM-4.7 的别名）
|
||
- 如果套餐中指定了其他模型名称，按套餐说明修改
|
||
|
||
### 第 3 步：验证 API 连接
|
||
|
||
```bash
|
||
# 测试 GLM-4.7 API
|
||
curl -X POST $OPENAI_BASE_URL/chat/completions \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer $OPENAI_API_KEY" \
|
||
-d '{
|
||
"model": "glm-4-plus",
|
||
"messages": [{"role": "user", "content": "你好，请用中文回复"}]
|
||
}'
|
||
```
|
||
|
||
如果返回 JSON 响应包含 AI 回复，说明配置成功！✅
|
||
|
||
### 第 4 步：安装并启动 Clawdbot
|
||
|
||
```bash
|
||
# 安装 Clawdbot（如果还没安装）
|
||
npm install -g clawdbot@latest
|
||
|
||
# 启动网关（前台运行，测试用）
|
||
clawdbot gateway --port 18789 --verbose
|
||
```
|
||
|
||
### 第 5 步：访问 Web 界面
|
||
|
||
在浏览器中打开：
|
||
|
||
```
|
||
http://localhost:18789/
|
||
```
|
||
|
||
**如果无法访问**：
|
||
|
||
```bash
|
||
# 在 PowerShell（管理员）中运行，配置端口转发
|
||
# 先获取 WSL2 IP
|
||
wsl hostname -I
|
||
|
||
# 然后配置端口转发（假设 WSL2 IP 是 172.x.x.x）
|
||
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=172.x.x.x
|
||
```
|
||
|
||
现在访问 `http://localhost:18789/` 应该可以打开控制面板了！
|
||
|
||
---
|
||
|
||
## 🎯 GLM-4.7 套餐模型说明
|
||
|
||
### GLM Coding Plan 支持的模型
|
||
|
||
根据你的套餐类型，可以使用以下模型：
|
||
|
||
| 模型名称 | 说明 | 适用场景 |
|
||
|---------|------|----------|
|
||
| `glm-4-plus` | GLM-4.7 旗舰版 | 复杂推理、代码生成、多模态 |
|
||
| `glm-4-flash` | 快速响应版 | 日常对话、简单任务 |
|
||
| `glm-4-air` | 高性价比版 | 生产环境 |
|
||
| `glm-4-0520` | 代码专用版 | 编程辅助 |
|
||
|
||
**推荐配置**：
|
||
- 如果你有 **Pro/Max 套餐**：使用 `glm-4-plus`
|
||
- 如果你有 **Lite 套餐**：使用 `glm-4-flash` 或 `glm-4-air`
|
||
|
||
### 修改模型
|
||
|
||
如果需要切换模型：
|
||
|
||
```bash
|
||
# 编辑配置
|
||
vim ~/.bashrc
|
||
|
||
# 修改 MODEL_NAME
|
||
export MODEL_NAME="glm-4-plus" # 或其他模型
|
||
|
||
# 重新加载
|
||
source ~/.bashrc
|
||
|
||
# 重启 Clawdbot
|
||
# Ctrl+C 停止，然后重新运行
|
||
clawdbot gateway --port 18789
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ GLM 套餐验证
|
||
|
||
### 验证是否使用套餐额度
|
||
|
||
**方法 1：查看控制台**
|
||
|
||
1. 访问 [智谱AI控制台 - 套餐使用](https://open.bigmodel.cn/usercenter/billing)
|
||
2. 发送几条测试消息
|
||
3. 查看"套餐使用情况"是否减少
|
||
|
||
**方法 2：使用 curl 测试**
|
||
|
||
```bash
|
||
# 发送测试请求
|
||
curl -X POST $OPENAI_BASE_URL/chat/completions \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer $OPENAI_API_KEY" \
|
||
-d '{
|
||
"model": "glm-4-plus",
|
||
"messages": [{"role": "user", "content": "测试"}]
|
||
}' -v
|
||
|
||
# 查看返回的速率限制头部
|
||
# 如果显示套餐相关的限制信息，说明使用了套餐
|
||
```
|
||
|
||
### 如果消耗账户余额而非套餐
|
||
|
||
**原因**：Clawdbot 不在 GLM 官方支持列表中
|
||
|
||
**解决方案**：使用 One-API 中转
|
||
|
||
```bash
|
||
# 安装 One-API
|
||
docker run -d --name one-api -p 3000:3000 \
|
||
-e TZ=Asia/Shanghai \
|
||
-v /root/data/one-api:/data \
|
||
ghcr.io/songquanpeng/one-api:latest
|
||
|
||
# 访问 http://localhost:3000
|
||
# 配置 GLM 套餐渠道
|
||
|
||
# 修改 Clawdbot 配置使用 One-API
|
||
export OPENAI_BASE_URL="http://localhost:3000/v1"
|
||
export OPENAI_API_KEY="sk-one-api-token"
|
||
|
||
# 重启 Clawdbot
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 GLM-4.7 性能特点
|
||
|
||
GLM-4.7 是智谱AI 2025 年 12 月发布的最新旗舰模型：
|
||
|
||
- ✅ **Vibe Coding 能力**：编程能力全球开源第一
|
||
- ✅ **200K 长上下文**：支持长文本处理
|
||
- ✅ **多模态支持**：文本、图像、代码
|
||
- ✅ **复杂推理**：数学、科学、逻辑问题
|
||
- ✅ **工具调用**：Function Calling、思考模式
|
||
|
||
### 在 Clawdbot 中的使用场景
|
||
|
||
1. **代码生成**：`请帮我写一个 Python 快速排序`
|
||
2. **长文本分析**：`分析这个 100 页的 PDF 文档`
|
||
3. **复杂推理**：`如何优化这个算法的时间复杂度？`
|
||
4. **多轮对话**：保持上下文的深度讨论
|
||
5. **工具调用**：让 AI 调用外部 API 完成任务
|
||
|
||
---
|
||
|
||
## 🔧 常用命令
|
||
|
||
```bash
|
||
# 启动 Clawdbot（前台）
|
||
clawdbot gateway --port 18789 --verbose
|
||
|
||
# 启动 Clawdbot（后台）
|
||
nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &
|
||
|
||
# 查看日志
|
||
tail -f ~/clawdbot.log
|
||
|
||
# 停止服务
|
||
ps aux | grep clawdbot
|
||
kill <进程ID>
|
||
|
||
# 查看配置
|
||
echo $OPENAI_BASE_URL
|
||
echo $OPENAI_API_KEY
|
||
echo $MODEL_NAME
|
||
|
||
# 测试 API
|
||
curl -X POST $OPENAI_BASE_URL/chat/completions \
|
||
-H "Authorization: Bearer $OPENAI_API_KEY" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"model":"glm-4-plus","messages":[{"role":"user","content":"测试"}]}'
|
||
```
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
### Q1: 如何确认使用的是 GLM-4.7？
|
||
|
||
**A**: 查看日志或测试响应：
|
||
|
||
```bash
|
||
# 启动时添加详细日志
|
||
clawdbot gateway --port 18789 --verbose
|
||
|
||
# 在日志中查找模型信息
|
||
grep -i "model\|glm" ~/clawdbot.log
|
||
```
|
||
|
||
### Q2: 套餐额度不够用怎么办？
|
||
|
||
**A**: 有三个选择：
|
||
|
||
1. **等待 5 小时**：套餐额度会自动刷新
|
||
2. **升级套餐**：Lite → Pro → Max
|
||
3. **多账号轮换**：使用 One-API 配置多个账号
|
||
|
||
### Q3: GLM-4.7 和其他模型的区别？
|
||
|
||
**A**:
|
||
|
||
| 特性 | GLM-4-Flash | GLM-4-Air | GLM-4-Plus (GLM-4.7) |
|
||
|------|-------------|-----------|---------------------|
|
||
| 速度 | 最快 | 快 | 中等 |
|
||
| 质量 | 基础 | 良好 | 最佳 |
|
||
| 成本 | 免费 | 低 | 中等 |
|
||
| 适用 | 测试 | 生产 | 复杂任务 |
|
||
|
||
### Q4: Web 界面访问不了？
|
||
|
||
**A**: 检查防火墙和端口：
|
||
|
||
```bash
|
||
# 检查端口是否监听
|
||
netstat -tlnp | grep 18789
|
||
|
||
# 检查防火墙
|
||
sudo ufw status
|
||
|
||
# 如果防火墙开启，允许端口
|
||
sudo ufw allow 18789
|
||
|
||
# Windows 防火墙（PowerShell 管理员）
|
||
New-NetFirewallRule -DisplayName "Clawdbot" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow
|
||
```
|
||
|
||
### Q5: 如何设置开机自启？
|
||
|
||
**A**: 使用 systemd 服务（前面已有完整配置）
|
||
|
||
---
|
||
|
||
## 🎉 完成！
|
||
|
||
现在你已经成功配置了：
|
||
|
||
- ✅ Clawdbot（在 WSL2 中运行）
|
||
- ✅ GLM-4.7（使用你的套餐）
|
||
- ✅ Web 控制面板（浏览器访问）
|
||
|
||
**访问地址**：http://localhost:18789/
|
||
|
||
**开始使用**：在 Web 界面中与 GLM-4.7 对话！
|
||
|
||
---
|
||
|
||
## 📚 下一步
|
||
|
||
1. **测试对话**：在 Web 界面发送"你好"
|
||
2. **尝试功能**：让 AI 帮你写代码、分析文档
|
||
3. **配置自动化**：设置定时任务、消息推送
|
||
4. **探索高级功能**：浏览器操作、文件管理等
|
||
|
||
祝使用愉快！🚀
|
||
|
||
有问题随时问我！
|