部署 Clawdbot 的常见问题及解决方案

部署 Clawdbot 的过程可能会遇到一些挑战，尤其是对于初次接触的部署者。以下是一些部署 Clawdbot 时可能遇到的常见问题及其解决方案：

集成 Telegram 时的 403 错误：这是由于 new-api 拦截了 Clawdbot 的默认 User-Agent。解决方法是自定义一个 header。配置如下：
```
"authHeader": true,
"headers": {
  "User-Agent": "curl/8.0"
}
```
内存不足问题：如果将 gateway 部署在 VPS 上，通常不会遇到内存问题。但如果在本地电脑上部署，电脑可能无法关闭。官方推荐将 gateway 部署在服务器上。配置示例：
```
NODE_OPTIONS="--max-old-space-size=768" clawdbot onboard
```
配置 HTTPS：建议使用 Cloudflare 托管域名，因为 Cloudflare 提供免费的 15 年证书，比自签名证书更安全。这不是必选项，但强烈推荐。

Control UI 报 pairing required 错误：解决此问题的一个方法是配置 allowInsecureAuth。配置如下：

{
  "gateway": {
    "mode": "local",
    "controlUi": {
      "enabled": true,
      "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "your-token"
    },
    "port": 32189,
    "bind": "0.0.0.0"
  }
}

控制浏览器：安装 Clawdbot Browser Relay 插件，并使用默认配置，这样您就可以通过 Telegram 命令控制 PC 的浏览器。

完整配置示例：这里提供了一个 Clawdbot 的完整配置示例，包括模型设置、会话配置、代理设置等。请根据实际情况调整配置参数。

{
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "session": {
    "scope": "per-sender",
    "reset": {
      "mode": "idle",
      "idleMinutes": 60
    },
    "resetTriggers": ["/new", "/reset"]
  },
  "agents": {
    "defaults": {
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "compaction": {
        "mode": "safeguard"
      },
      "workspace": "/root/clawd",
      "model": {
        "primary": "newapi/claude-opus-4-5-20251101"
      },
      "models": {
        "newapi/claude-opus-4-5-20251101": {
          "alias": "Claude Opus 4.5"
        }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600
    }
  },
  "models": {
    "providers": {
      "newapi": {
        "baseUrl": "https://your-api.com/v1",
        "apiKey": "your-api-key",
        "api": "openai-completions",
        "authHeader": true,
        "headers": {
          "User-Agent": "curl/8.0"
        },
        "models": [
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "reasoning": true,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 16000
          }
        ]
      }
    }
  },
  "gateway": {
    "mode": "local",
    "controlUi": {
      "enabled": true,
      "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "your-gateway-token"
    },
    "port": 32189,
    "bind": "0.0.0.0",
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "plugins": {
    "entries": {
      "telegram": {
        "enabled": true
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-telegram-bot-token",
      "dmPolicy": "pairing",
      "allowFrom": ["your-telegram-user-id"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

希望这些信息能帮助您顺利部署 Clawdbot。如果您还有其他问题，请随时提问。

部署 Clawdbot 的常见问题及解决方案

评论已关闭