Loading... # Clawdbot 在 DigitalOcean 部署指南 # 一、概述 ## 1. 简介 ### A. 是什么 Clawdbot 是一个自托管 AI 助手，可部署在云服务器上，提供 AI 交互能力。本文介绍如何在 DigitalOcean 平台快速部署 Clawdbot 服务。 ### B. 为什么学 - 快速搭建个人 AI 助手服务 - 学习云服务器部署基础流程 - 了解 AI 应用的服务器配置要求 ### C. 学完能做什么 - 在 DigitalOcean 创建服务器并部署 Clawdbot - 通过 SSH 隧道安全访问 Web 管理界面 - 独立维护和更新 Clawdbot 服务 ## 2. 前置知识 ### A. 必备技能 - 基本 SSH 连接操作 - Linux 终端命令基础 ### B. 推荐知识 - DigitalOcean 账号 - 基本的服务器概念 # 二、环境准备 ## 1. 服务器要求 ### A. 系统版本 Ubuntu 24.04 LTS ### B. 硬件配置 - 推荐：2 GB RAM / 1 AMD CPU / 50 GB NVMe - 最低：1 GB RAM（需配置交换空间） ### C. 区域选择 选择距离用户最近的区域以降低延迟 ## 2. 准备工作 注册 DigitalOcean 账号并充值 # 三、部署步骤 ## 1. 创建 Droplet（云服务器） 在 DigitalOcean 控制台创建新的 Droplet： - 操作系统：Ubuntu 24.04 LTS - 区域：选择最近的区域 - CPU 类型：Premium AMD - 规格：2 GB RAM / 1 AMD CPU / 50 GB NVMe ## 2. SSH 连接服务器 ```mermaid graph LR A[本地终端] -->|ssh root@IP| B[Droplet 服务器] B -->|连接成功| C[执行部署命令] ```  获取服务器 IP 后，执行： ```bash ssh root@YOUR_IP ``` 将 YOUR_IP 替换为实际的服务器 IP 地址。 ## 3. 创建 sudo 用户 出于安全考虑，不建议直接使用 root 用户操作。 ```bash adduser clawd && usermod -aG sudo clawd && su - clawd ``` 此命令会： 1. 创建名为 clawd 的新用户 2. 将其添加到 sudo 组 3. 切换到新用户 ## 4. 安装 Clawdbot Clawdbot 提供了一键安装脚本： ```bash curl -fsSL https://clawd.bot/install.sh | bash ``` 安装完成后运行： ```bash exec bash ``` ## 5. 配置 API 密钥 使用向导模式配置： ```bash clawdbot setup --wizard ``` 按照提示输入必要的 API 密钥和配置信息。 ## 6. 启动网关服务 ```bash clawdbot gateway --bind lan --port 18789 ``` 参数说明： - bind lan：绑定到局域网接口 - port 18789：监听 18789 端口 # 四、访问管理界面 ## 1. 建立 SSH 隧道 由于安全考虑，服务仅监听本地。通过 SSH 隧道转发端口： ```bash ssh -L 18789:127.0.0.1:18789 clawd@YOUR_IP ``` 此命令将本地 18789 端口映射到远程服务器的 18789 端口。 ## 2. 访问 Web UI 隧道建立后，在浏览器打开： ``` http://127.0.0.1:18789 ``` 即可访问 Clawdbot 的 Web 管理界面。 ```mermaid sequenceDiagram participant B as 浏览器 participant L as 本地:18789 participant T as SSH隧道 participant S as 服务器:18789 participant C as Clawdbot B->>L: http://127.0.0.1:18789 L->>T: 转发请求 T->>S: 通过SSH隧道 S->>C: 访问服务 C-->>S: 返回响应 S-->>T: 隧道返回 T-->>L: 本地端口 L-->>B: 显示界面 ```  # 五、内存优化（1GB 服务器） 如果使用 1GB 内存的服务器，NPM 安装可能会因内存不足失败。 ## 1. 方案一：增加 Node 内存限制 ```bash export NODE_OPTIONS="--max-old-space-size=2048" ``` ## 2. 方案二：添加交换空间 ```bash sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab ``` 此操作会创建 2GB 的交换文件，并在重启后自动挂载。 # 六、常见问题 ## 1. SSH 连接失败 检查服务器 IP 地址是否正确，确保防火墙允许 22 端口访问。 ## 2. 内存不足错误 参考第五章内存优化方案，推荐直接使用 2GB 配置的服务器。 ## 3. 端口无法访问 确认 SSH 隧道已建立，且 clawdbot gateway 服务正在运行。 # 七、参考资料 1. [Clawdbot 官方安装指南](https://clawd.bot) 2. [DigitalOcean Droplet 文档](https://docs.digitalocean.com/products/droplets/) 3. [原 Gist 链接](https://gist.github.com/dabit3/42cce744beaa6a0d47d6a6783e443636) 最后修改：2026 年 01 月 26 日 © 允许规范转载 赞 如果觉得我的文章对你有用，请随意赞赏