Clawdbot 通用部署与配置指南
本指南介绍如何在 Ubuntu 服务器上安装并运行 Clawdbot Gateway,接入 GitHub Copilot 模型及 Telegram 机器人。
前置准备
在开始之前,请确保具备以下条件:
- LLM 服务 API Key:本文使用 GitHub Copilot(可通过学生认证免费获取),也可替换为月之暗面等其他提供商。
- 聊天机器人服务:推荐使用 Telegram,支持 WhatsApp 等其他平台。
- Linux 服务器:建议 Ubuntu 22.04+,配置至少 2H2G。虽然 Windows 部署同理,但本文主要针对 Linux 环境。
- 业务用户:创建一个非 root 用户运行 Clawdbot,避免直接使用 root 权限带来安全风险。
- 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
按提示操作:
- 选择
Yes确认基础选项。


