宝塔面板部署Clawdbot保姆级教程:避坑HTTPS+反向代理,10 分钟搞定部署!

0 阅读6分钟

宝塔面板部署Clawdbot保姆级教程:避坑HTTPS+反向代理,10 分钟搞定部署!

昨天星哥介绍了在云服务器中安装clawdbot,今天继续在宝塔中部署安装Clawdbot。

而宝塔面板作为国内主流的服务器管理工具,以可视化操作、便捷的环境配置优势,能完美解决这些痛点。

本文将宝塔面板中安装 Clawdbot,从环境准备到部署完成,再到安全加固,一步步带你避开坑点,实现高效落地。

ClawdBot 是什么?

ClawdBot 是一款开源的个人 AI 助手,能够 24 小时持续运行,为你处理各类日常与工作任务。除了基础对话,它还能胜任多种自动化能力,例如:

  • • 📧 智能整理与回复邮件
  • • 🔍 企业与产品信息调研
  • • 📅 日程管理与提醒
  • • ✍️ 内容草稿生成
  • • 💸 记账与基础财务管理
  • • 📝 待办事项整理与跟踪

它的核心优势在于:支持完全私有化部署、数据可控、安全性高,并兼容多种聊天平台(Telegram、WhatsApp、Discord、Slack 等),让你随时随地都能调用自己的专属 AI 助手。

img

一、环境准备

可以使用云服务器、本地的Linux虚拟机安装宝塔,参考星哥的文章安装宝塔面板,宝塔面板从零搭建个人博客新手也能轻松上手

服务器系统要求:Debian/Ubuntu/CentOS(国产系统如 OpenCloudOS 需额外配置);

登录面板


    
    
    
  curl -fsSL https://clawd.bot/install.sh | bash

img

安装 Node.js:登录宝塔面板,进入「网站 > Node 项目 > Node 版本管理器」,更新版本列表后安装稳定版 v24.13.0,并设置为命令行版本;

img

img

并设置命令行版本为刚刚安装的稳定版

img

重新连接 SSH 终端,确保 Node.js 环境生效。

二、安装 ClawdBot 核心程序

执行安装命令


    
    
    
  npm install -g clawdbot@latest

报错:


    
    
    
  root@iZwz93bflcar7tzp0u7fw1Z:~# npm install -g clawdbot@latest
npm warn Unknown global config "--init.module". This will stop working in the next major version of npm.
npm error code ETARGET
npm error notarget No matching version found for @aws-sdk/xml-builder@^3.972.2.
npm error notarget In most cases you or one of your dependencies are requesting
npm error notarget a package version that doesn't exist.
npm error A complete log of this run can be found in: /www/server/nodejs/v24.13.0/cache/_logs/2026-01-28T01_11_03_743Z-debug-0.log

解决


    
    
    
  # npm install -@aws-sdk/xml-builder@3.914.0
npm warn Unknown global config "--init.module". This will stop working in the next major version of npm.

added 5 packages in 971ms

2 packages are looking for funding
  run `npm fund` for details

再执行


    
    
    
  npm install -g clawdbot@latest

img

三、初始化配置

输入 clawdbot onboard --install-daemon(脚本安装会自动进入向导,可跳过此步);


    
    
    
  clawdbot onboard --install-daemon

1.同意免责声明

按左方向键,选择yes。

img

2.配置模式选择:快速入门

选择QuickStart,回车


    
    
    
  ◆  Onboarding mode
│  ● QuickStart (Configure details later via clawdbot configure.)
│  ○ Manual

3.选择大模型

如果想省时省心的话优先推荐选择国内的厂商(MiniMax、Qwen、Moonshot AI、Z.AI/GLM),也可以选择OpenAI、谷歌等国外厂商。

星哥选择Moonshot AI(月之暗面/Kimi)进行演示,Moonshot AI auth method选择Moonshot AI API key即可,然后填入自己的API Key,

再粘贴自己的Moonshot API Key,默认模型选择Keep current。


    
    
    
  ◇  QuickStart ─────────────────────────╮
│                                      │
│  Gateway port: 18789                 │
│  Gateway bind: Loopback (127.0.0.1)  │
│  Gateway auth: Token (default)       │
│  Tailscale exposure: Off             │
│  Direct to chat channels.            │
│                                      │
├──────────────────────────────────────╯
│
◆  Model/auth provider
│  ○ OpenAI
│  ○ Anthropic
│  ○ MiniMax
│  ○ Qwen
│  ○ Synthetic
│  ○ Venice AI
│  ○ Google
│  ○ Copilot
│  ○ OpenRouter
│  ○ Vercel AI Gateway
│  ● Moonshot AI (Kimi K2 + Kimi Code)
│  ○ Z.AI (GLM 4.7)
│  ○ OpenCode Zen
│  ○ Skip for now

img

跟随向导完成风险确认、模型选择、技能配置(空格键选中需要的技能,回车确认安装);

安装完成后会展示Token,注意保存,一会会用到

img

4.安装系统服务

SSH控制台免密登录方式无法完成服务安装,需要使用SSH客户端连接到服务器,并执行以下命令安装服务。

执行 clawdbot daemon install,再用 clawdbot daemon start 启动服务,确保 ClawdBot 后台运行。


    
    
    
  root@bt:~# clawdbot daemon install

🦞 Clawdbot 2026.1.24-3 (885167d) — I read logs so you can keep pretending you don't have to.

Gateway service already enabled.
Reinstall with: clawdbot gateway install --force
root@bt:~# clawdbot daemon start

🦞 Clawdbot 2026.1.24-3 (885167d) — If you can describe it, I can probably automate it—or at least make it funnier.

Restarted systemd service: clawdbot-gateway.service

四、配置反向代理(实现公网访问)

宝塔面板进入「网站 > 添加站点」,输入域名或服务器 IP,选择 “纯静态”,完成创建;

img

进入站点设置「SSL」,申请 Let's Encrypt 免费证书(IP 类型域名需文件验证),开启 HTTPS;

img

点击「反向代理 > 添加配置」,代理名称填 “clawd”,目标 URL 输入 http://localhost:18789,发送域名填 “localhost”,保存即可;

img

五、授权

拼接访问链接:将之前保存的 Token 替换到链接中,格式为 https://你的IP/?token=xxx,访问即可进入 ClawdBot 控制台。


    
    
    
  http://localhost:18789/?token=5f00be04c74fa15eb51486ef50227270fefdec413789b940
替换成

https://47.115.33.245/?token=5f00be04c74fa15eb51486ef50227270fefdec413789b940

img

页面会显示:disconnected (1008): pairing required

访问控制台后,回到 SSH 终端,输入 clawdbot devices list 查看待授权设备


    
    
    
  clawdbot devices list

img

执行 clawdbot devices approve 申请ID(申请 ID 从列表中复制),批准访问后,控制台状态会变为 OK;


    
    
    
  clawdbot devices approve request-id
实际执行:
clawdbot devices approve d1a1ef00-723c-47f3-97de-d7a9fc130583

img

页面状态也会变成OK

img

此时我们就可以试着和他进行对话

六. 安全加固BasicAuth

配置 BasicAuth(可选):进一步提升安全性,执行命令生成密码文件:


    
    
    
  printf "用户名:$(openssl passwd -apr1 密码)\n" > /www/server/nginx/conf/clawd.pass

替换自己的用户名和密码


    
    
    
  printf "star:$(openssl passwd -apr1 star877)\n" > /www/server/nginx/conf/clawd.pass

生成后执行以下命令修改权限:


    
    
    
  chown root:www /www/server/nginx/conf/clawd.pass
chmod 640 /www/server/nginx/conf/clawd.pass

进入宝塔反向代理「配置文件」,添加以下内容,保存后重载服务:


    
    
    
  auth_basic "Authorization";
auth_basic_user_file /www/server/nginx/conf/clawd.pass;

img

应该可以看到需要输入用户名和密码,输入刚才设置的用户名和密码点击登录即可。

img

总结

至此,借助宝塔面板完成 Clawdbot 的安装、反向代理配置与安全加固已全部落地。

后续使用中,建议定期通过宝塔面板监控服务状态,结合 clawdbot doctor 检查依赖完整性,按需扩展技能插件与 API 集成。Clawdbot 的强大之处在于其定制化能力,而宝塔面板为这份能力提供了稳定、安全的运行基石。希望本文能帮你少走弯路,快速解锁智能终端助手的高效体验,让服务器管理与自动化操作更省心、更高效。