【AI Agent】Clawdbot 通用部署与配置教程(Ubuntu Server / Copilot / Telegram)
本文给出一套 Clawdbot 部署流程:在 Ubuntu 服务器上安装并运行 Clawdbot Gateway,选择 GitHub Copilot 模型(可替换为其他 provider),接入聊天机器人。
在跟着本文进行部署之前,你应该已经做好下面的准备:
- 一个LLM服务的API KEY,本文使用Copilot,你可以通过Github学生认证免费获取Copilot Pro服务,其他提供商,如月之暗面的API KEY也是可以的
- 一个可以使用的机器人服务,本文使用telegram的机器人,同样的你也可以使用What’s APP等其他软件的机器人
- 一台运行Linux系统的服务器,虽然Windows系统的部署同理,但是本文只针对Linux系统,笔者使用的是Ubuntu 22.04,服务器配置2H2G
前置准备
- 一台 Ubuntu 服务器(建议 22.04+)
- 一个非 root 的业务用户(clawd的权限非常高,root权限可能会让他做危险操作)
- 一个可用的 GitHub 账号 已开通 GitHub Copilot 订阅(或组织授权)
- 若接入相应的聊天机器人,准备相应的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 25PS:许多教程在这里推荐安装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启动成功就代表模型配置成功了,可以直接去对应的机器人聊天界面尝试一下对话