Clawdbot 在 Ubuntu 服务器上的通用部署与配置指南

Clawdbot 通用部署与配置指南

本指南介绍如何在 Ubuntu 服务器上安装并运行 Clawdbot Gateway，接入 GitHub Copilot 模型及 Telegram 机器人。

前置准备

在开始之前，请确保具备以下条件：

1. LLM 服务 API Key：本文使用 GitHub Copilot（可通过学生认证免费获取），也可替换为月之暗面等其他提供商。
2. 聊天机器人服务：推荐使用 Telegram，支持 WhatsApp 等其他平台。
3. Linux 服务器：建议 Ubuntu 22.04+，配置至少 2H2G。虽然 Windows 部署同理，但本文主要针对 Linux 环境。
4. 业务用户：创建一个非 root 用户运行 Clawdbot，避免直接使用 root 权限带来安全风险。
5. GitHub 账号：已开通 Copilot 订阅或组织授权。

安装基础工具

更新系统并安装必要依赖：

sudo apt update && sudo apt -y install curl ca-certificates git lsof

安装 Node.js 环境

推荐使用 nvm 管理 Node 版本，Clawdbot 社区反馈 v25 在配置 Telegram 时更为稳定，v22 可能存在启动 bug。

安装 nvm

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

加载 nvm 环境变量（推荐直接重新加载 shell）：

exec bash

验证安装：

command -v nvm && nvm --version

若输出路径或版本号，说明安装成功。

安装 Node.js

nvm install 25
nvm use 25
nvm alias default 25

验证环境：

node -v && npm -v && which node

安装 Clawdbot

通过 npm 全局安装：

sudo npm i -g clawdbot

验证安装：

clawdbot -V
clawdbot help

初始化本地配置与工作区：

clawdbot setup

运行引导配置

执行 onboard 命令进行交互式配置：

clawdbot onboard

按提示操作：

1. 选择 Yes 确认基础选项。