近期 Clawdbot 关注度较高,不少开发者尝试在服务器上部署。不过跑通服务后,往往卡在 Web 控制台访问、HTTPS 加密及安全认证这些环节上。本文梳理了从安装到安全配置的完整流程,重点解决公网访问与基础鉴权问题。
安装 Clawdbot
首先通过 SSH 终端连接服务器。对于 Debian/Ubuntu/CentOS 等常用系统,可直接执行安装脚本:
curl -fsSL https://clawd.bot/install.sh | bash
部分国产操作系统如 OpenCloudOS 或 Alibaba Cloud Linux,可能需要先更新 Node.js 版本。进入面板的「网站」-「Node 项目」-「Node 版本管理器」,点击右上角更新版本列表并安装最新稳定版 v24.13.0,随后在命令行中设置该版本为默认。

确认环境无误后,全局安装 Clawdbot:
npm install -g clawdbot@latest
安装完成后执行初始化命令。若脚本安装已自动触发初始化页面,可跳过此步:
clawdbot onboard --install-daemon
按提示完成配置:
- 风险确认:选择
yes继续。 - 通道选择:根据需求选择渠道(如网页对话),此处可按需跳过。
- Token 保存:安装成功后会展示 Token,务必记录,后续代理配置需要用到。
- API 配置:默认跳过,实际使用时按需补充。
- 技能配置:选择需要的技能模块,支持空格选中后回车确认。
- 模型 Provider:注意 Moonshot、Qwen 等默认指向国际站端点,国内账户可能无法使用,请根据实际情况调整。

最后安装并启动服务。面板或云厂商控制台免密登录方式通常无法直接完成服务安装,建议使用 SSH 客户端执行:
clawdbot daemon install
clawdbot daemon start
配置反向代理
服务默认监听本地端口,不支持公网访问。为了通过 HTTPS 安全访问,需要配置反向代理。
- 添加站点:在宝塔面板的「网站」-「PHP」中添加站点,域名处可先用 IP 演示。
- SSL 证书:在站点设置中开启 SSL,申请或上传证书。
- 反向代理配置:点击「反向代理」-「添加」,目标 URL 填写
http://localhost:18789。

- 替换 Token:回到之前保存的 Token 链接,将
localhost替换为实际域名。例如:
# 原地址
http://localhost:18789/?token=d275f89c6905729e850634de060e64a30822b5264fe99703
# 新地址
https://43.133.61.18/?token=d275f89c6905729e850634de060e64a30822b5264fe99703
此时应能看到服务响应正常。
- 设备授权:在终端执行以下命令查看待授权设备:
clawdbot devices list
找到对应的 request-id 并批准访问:
clawdbot devices approve <request-id>
授权成功后,页面状态会变为 OK,即可开始对话测试。
配置 BasicAuth
仅靠 HTTPS 仍不足以完全防止未授权访问,建议增加一层 BasicAuth。由于面板自带的访问限制对反向代理不生效,需手动修改 Nginx 配置。
- 生成密码文件:在终端执行以下命令生成 htpasswd 文件,替换用户名和密码:
printf "用户名:$(openssl passwd -apr1 密码)\n" > /www/server/nginx/conf/clawd.pass
示例:
printf "clawd:$(openssl passwd -apr1 clawd123)\n" > /www/server/nginx/conf/clawd.pass
- 设置权限:确保 Nginx 进程有权读取该文件。
chown root:www /www/server/nginx/conf/clawd.pass
chmod 640 /www/server/nginx/conf/clawd.pass
- 修改 Nginx 配置:在面板「网站」-「设置」-「反向代理」-「配置文件」中,添加以下内容:
auth_basic "Authorization";
auth_basic_user_file /www/server/nginx/conf/clawd.pass;
保存后服务会自动重载。再次访问时,浏览器会弹出输入框,验证通过后才能进入控制台。
至此,Clawdbot 的部署与访问链路已完整打通。整体来看,工具本身并不复杂,真正的挑战在于访问边界与安全策略:本地监听、Token 授权、HTTPS 以及避免直接暴露公网。通过宝塔面板做反向代理,再加上 Basic Auth,既不影响使用体验,也能让人用得更放心。如果仅需终端交互,完全可以忽略反向代理步骤,那样安全性更高。

