lxy/u-desk
Private
Public Access
1
0
Fork 0
Code Activity
Files
fs-only-v3
u-desk/docs/08-用户指南/clawdbot安装使用.md

12 KiB
Raw Permalink Blame History

Clawdbot 快速上手指南

你现在的状态：新用户 + 已有 GLM 套餐账号

目标：10 分钟内完成 Clawdbot 安装并配置 GLM 套餐

📦 什么是 Clawdbot？

Clawdbot 是一个 24/7 运行的个人 AI 助手，可以：

  • ✅ 在 WhatsApp、Telegram、Discord 等平台与你对话
  • ✅ 操作你的电脑（浏览器、文件系统）
  • ✅ 执行任务（写代码、查资料、自动化）
  • ✅ 主动给你发消息（不是被动响应）

简单理解：一个长在你电脑上的 AI 助理，类似"贾维斯"。

🚀 快速安装（Windows + WSL2）

步骤 1：安装 WSL2（5 分钟）

打开 PowerShell（管理员），运行：

wsl --install

重启电脑，完成 Ubuntu 初始化设置。

步骤 2：安装 Node.js 22+（2 分钟）

在 WSL2 Ubuntu 终端运行：

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

# 验证
node --version

步骤 3：安装 Clawdbot（1 分钟）

# 一键安装
curl -fsSL https://clawd.bot/install.sh | bash

# 或使用 npm
npm install -g clawdbot@latest

步骤 4：配置 GLM 套餐（2 分钟）

获取你的 GLM API Key

  1. 登录 智谱AI开放平台
  2. 进入控制台 → API Keys
  3. 复制你的 API Key

配置环境变量

编辑 ~/.bashrc：

vim ~/.bashrc

添加以下内容：

# GLM Coding Plan 配置
export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"
export OPENAI_API_KEY="你的GLM_API_KEY"
export MODEL_NAME="glm-4-flash"

保存后执行：

source ~/.bashrc

步骤 5：运行向导（可选）

clawdbot onboard --install-daemon

向导会帮你配置：

  • 通信渠道（WhatsApp、Telegram 等）
  • 后台服务
  • 其他设置

如果你有 GLM 套餐，向导中的认证配置可以选择跳过或手动配置。

🔥 使用 GLM 套餐的注意事项

⚠️ 重要提醒

Clawdbot 不在 GLM 官方支持的工具列表中，这意味着：

  1. 可能被识别为普通 API 调用，消耗账户余额而非套餐额度
  2. 需要验证配置是否正确使用套餐

验证是否使用套餐额度

方法 1：查看控制台

  1. 访问 智谱AI控制台 - 套餐使用
  2. 发送几条测试消息
  3. 查看"套餐使用情况"是否减少
  4. 如果"账户余额"减少，说明被识别为普通调用

方法 2：使用 One-API 中转（推荐）

# 安装 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 中使用：
export OPENAI_BASE_URL="http://localhost:3000/v1"
export OPENAI_API_KEY="sk-one-api-token"

套餐并发限制

  • Lite：并发数 2
  • Pro：并发数 5
  • Max：并发数 7

如果遇到并发错误，调整配置或升级套餐。

▶️ 启动 Clawdbot

方法 1：前台运行（测试用）

clawdbot gateway --port 18789 --verbose

方法 2：后台服务（推荐）

# 安装服务（如果向导中已安装可跳过）
clawdbot onboard --install-daemon

# 启动服务
sudo systemctl start clawdbot

# 查看状态
sudo systemctl status clawdbot

# 查看日志
journalctl -u clawdbot -f

🎯 开始使用

配置通信渠道

WhatsApp（推荐）

  1. 在手机上打开 WhatsApp
  2. 设置 → 关联设备
  3. 扫描二维码完成登录

Telegram

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 创建机器人
  3. 获取 Bot Token
  4. 在 Clawdbot 中配置

首次配对

第一条消息会收到配对代码，需要批准：

# 批准 WhatsApp 配对
clawdbot pairing approve whatsapp <配对代码>

# 批准 Telegram 配对
clawdbot pairing approve telegram <配对代码>

发送测试消息

在 WhatsApp/Telegram 中发送：

你好

如果收到回复，配置成功！🎉

🔧 常用命令

# 查看状态
clawdbot status

# 健康检查
clawdbot health

# 重启服务
sudo systemctl restart clawdbot

# 停止服务
sudo systemctl stop clawdbot

# 查看完整状态
clawdbot status --all

❓ 常见问题

Q1: 安装失败怎么办？

A: 检查 Node.js 版本：

node --version  # 必须 >= 22

如果版本过低，重新安装 Node.js 22。

Q2: GLM 套餐不生效？

A: 按以下步骤排查：

# 1. 检查配置
echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY
echo $MODEL_NAME

# 2. 测试 API 连接
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-flash","messages":[{"role":"user","content":"测试"}]}'

# 3. 检查日志
journalctl -u clawdbot -n 50

Q3: 服务启动失败？

A: 查看错误日志：

journalctl -u clawdbot -n 100

常见问题：

  • 端口被占用：修改端口号 --port 18790
  • 配置文件错误：检查 ~/.clawdbot/config.json
  • API Key 无效：重新获取并配置

Q4: 如何更新 Clawdbot？

npm update -g clawdbot@latest

Q5: 如何卸载？

# 停止服务
sudo systemctl stop clawdbot

# 卸载
npm uninstall -g clawdbot

# 删除配置
rm -rf ~/.clawdbot

📚 下一步

基础使用

  1. 对话：在 WhatsApp/Telegram 中直接对话
  2. 任务：让 AI 帮你写代码、查资料、分析日志
  3. 自动化：配置定时任务、消息转发等

高级功能

  1. 浏览器操作：让 AI 操作浏览器完成任务
  2. 文件操作：读取、编辑、管理文件
  3. 工具集成：接入搜索引擎、API 等
  4. 多智能体：配置多个 AI 代理协同工作

学习资源

💡 使用技巧

技巧 1：高效提示词

❌ 坏："帮我看看这个" ✅ 好："审查这段代码的性能问题，重点关注内存泄漏和循环效率"

技巧 2：利用文件系统能力

"读取 /var/log/app.log，分析过去 1 小时的错误模式"

技巧 3：多轮对话

保持上下文，可以持续追问：

你：解释一下 React hooks
AI：[解释]
你：给我一个 useEffect 的例子
AI：[代码示例]
你：这个例子中依赖数组的作用是什么？
AI：[详细说明]

🎉 恭喜！

你已经成功安装并配置了 Clawdbot + GLM 套餐！

现在可以：

  • ✅ 在 WhatsApp/Telegram 中与 AI 对话
  • ✅ 让 AI 帮你处理任务
  • ✅ 享受 GLM 套餐的高性价比

下一步：

  • 探索更多功能
  • 配置自动化任务
  • 优化使用体验

📝 快速参考

配置文件位置

~/.clawdbot/
├── config.json              # 主配置
├── credentials/             # 凭据
└── workspace/               # 工作空间

服务管理

# 启动
sudo systemctl start clawdbot

# 停止
sudo systemctl stop clawdbot

# 重启
sudo systemctl restart clawdbot

# 状态
sudo systemctl status clawdbot

# 日志
journalctl -u clawdbot -f

GLM 套餐配置

# 环境变量
export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"
export OPENAI_API_KEY="你的API_KEY"
export MODEL_NAME="glm-4-flash"

# 验证
curl -X POST $OPENAI_BASE_URL/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{"model":"glm-4-flash","messages":[{"role":"user","content":"测试"}]}'

祝使用愉快！ 🚀

有问题？查看 常见问题 或访问 GitHub Issues

📌 本机配置记录

最后更新: 2026-01-28 配置环境: Windows 11 Clawdbot 版本: 2026.1.24-3

✅ 当前运行状态

项目 状态 详情
网关状态 🟢 运行中 端口 18789 (127.0.0.1)
默认模型 GLM-4.7 zai/glm-4.7
工作空间 C:\Users\23780\clawd
进程 PID 20992

📁 配置文件路径

主配置目录

C:\Users\23780\.clawdbot\
├── clawdbot.json              # 主配置文件 ⭐
├── agents\
│   └── main\
│       ├── agent\
│       │   └── auth-profiles.json  # 认证配置
│       └── sessions\
│           └── sessions.json       # 会话存储
├── credentials\               # OAuth 凭证
├── cron\jobs.json            # 定时任务
└── devices\                  # 设备配对

工作空间

C:\Users\23780\clawd\
├── canvas\                   # Canvas 文件
├── AGENTS.md                 # Agent 文档
├── BOOTSTRAP.md              # 启动文档
├── HEARTBEAT.md              # 心跳任务
├── SOUL.md                   # 系统提示
├── TOOLS.md                  # 工具文档
└── USER.md                   # 用户信息

🔑 GLM-4.7 模型配置

配置文件: C:\Users\23780\.clawdbot\clawdbot.json

{
  "gateway": {
    "mode": "local"
  },
  "env": {
    "ZAI_API_KEY": "7f83dc939a60488b8cf48a2ee1c8150e.NY3aOR0qlVS8m37a"
  },
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\23780\\clawd",
      "model": {
        "primary": "zai/glm-4.7"
      },
      "models": {
        "zai/glm-4.7": {
          "alias": "GLM"
        }
      }
    }
  }
}

GLM 模型信息

配置项 值
Provider Z.AI (智谱)
Model ID zai/glm-4.7
别名 GLM
API Key 7f83dc939a60488b8cf48a2ee1c8150e.NY3aOR0qlVS8m37a
环境变量 ZAI_API_KEY
通用端点 https://api.z.ai/api/paas/v4
编程端点 https://api.z.ai/api/coding/paas/v4

🚀 本机常用命令

网关管理

# 启动网关
clawdbot gateway --port 18789

# 查看网关健康状态
clawdbot health

# 查看网关日志
clawdbot logs

# 重启网关 (Windows)
taskkill //F //PID <pid> && clawdbot gateway --port 18789

模型管理

# 查看模型状态
clawdbot models status

# 列出可用模型
clawdbot models list

# 设置默认模型
clawdbot models set zai/glm-4.7

诊断命令

# 运行完整诊断
clawdbot doctor

# 自动修复问题
clawdbot doctor --fix

# 查看频道状态
clawdbot status

控制面板

# 打开 Web 控制面板
clawdbot dashboard

Agent 交互

# 运行 Agent (本地模式)
clawdbot agent --local --message "你好"

# 发送消息到会话
clawdbot message send --target <number> --message "测试消息"

# 查看会话列表
clawdbot sessions list

🛠️ 故障排查

网关无法启动

# 检查端口占用
netstat -ano | grep 18789

# 终止占用进程 (Windows)
taskkill //F //PID <pid>

# 查看错误日志
clawdbot logs | tail -50

模型认证失败

# 检查 API Key 配置
clawdbot models status

# 验证环境变量
echo $ZAI_API_KEY

# 重新配置
clawdbot configure

📊 配置验证

# 验证模型配置
clawdbot models status

# 输出应包含：
# Default       : zai/glm-4.7
# Aliases (1)   : GLM -> zai/glm-4.7
# Auth overview : zai effective=env:7f83dc93...lVS8m37a

# 验证网关健康
clawdbot health

# 输出应包含：
# Agents: main (default)
# Heartbeat interval: 30m (main)

📚 参考资源

官方文档

中文指南

模型提供商

提示: 本节记录了本机 Clawdbot 的实际配置，定期更新以保持同步。

View Git Blame Copy Permalink