【AI Agent】Clawdbot 通用部署与配置教程（Ubuntu Server / Copilot / Telegram）

本文给出一套 Clawdbot 部署流程：在 Ubuntu 服务器上安装并运行 Clawdbot Gateway，选择 GitHub Copilot 模型（可替换为其他 provider），接入聊天机器人。
在跟着本文进行部署之前，你应该已经做好下面的准备：

1. 一个LLM服务的API KEY，本文使用Copilot，你可以通过Github学生认证免费获取Copilot Pro服务，其他提供商，如月之暗面的API KEY也是可以的
2. 一个可以使用的机器人服务，本文使用telegram的机器人，同样的你也可以使用What’s APP等其他软件的机器人
3. 一台运行Linux系统的服务器，虽然Windows系统的部署同理，但是本文只针对Linux系统，笔者使用的是Ubuntu 22.04，服务器配置2H2G

前置准备

1. 一台 Ubuntu 服务器（建议 22.04+）
2. 一个非 root 的业务用户（clawd的权限非常高，root权限可能会让他做危险操作）
3. 一个可用的 GitHub 账号 已开通 GitHub Copilot 订阅（或组织授权）
4. 若接入相应的聊天机器人，准备相应的api key

安装基础工具：

sudoapt update sudoapt -y installcurl ca-certificates gitlsof

安装 Node.js

安装 nvm

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

安装完成后，让当前 shell 立即加载 nvm（推荐直接重新加载 shell）：

execbash

验证 nvm 是否可用：

command -v nvm nvm --version 

如果能输出路径/版本号，就说明安装成功。

用 nvm 安装 Node（推荐25）

nvm install25 nvm use 25 nvm alias default 25

PS：许多教程在这里推荐安装22，但是最近Clawdbot社区反应22版本的Clawdbot在配置telegram机器人的时候会遇到bug无法启动，所以建议直接上25，并nvm也支持多版本切换，比较实用

验证安装是否完成

node -v npm -v whichnode

安装 Clawdbot

用 npm 全局安装：

sudonpm i -g clawdbot 

验证：

clawdbot -V clawdbot help

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

clawdbot setup 

运行引导配置

clawdbot onboard 

这里主要是选择一下配置
第一个我们选择Yes
接着模型我们选择Copilot 稍加等待后会弹出一个网址和一个八位代码
进入这个网址登录我们的github账号，输入代码授权，Clawdbot就可以使用我们的Copilot了
机器人代理我们选择Telegram，这里需要我们先去BotFather注册一个机器人，具体的可以查看其他教程
然后Skills和其他功能根据自己的需要选择Yes或No

启动 Gateway

建议先用最小启动命令，确认能启动并监听端口：

clawdbot gateway --bind loopback --port 18789

检查监听：

sudolsof -iTCP:18789 -sTCP:LISTEN -n -P 

本机访问（如果你在服务器上）：

Dashboard：http://127.0.0.1:18789/ WebSocket：ws://127.0.0.1:18789 

一般gateway启动成功就代表模型配置成功了，可以直接去对应的机器人聊天界面尝试一下对话