Clawdbot一键部署教程：基于Linux系统的保姆级安装指南

1. 为什么选择在Linux上部署Clawdbot

Clawdbot（现名Moltbot）作为当前最热门的开源个人AI助手，它的核心价值在于“本地优先”和“主动执行”。当你把它部署在Linux服务器上，就相当于给AI配了一台永不关机的数字员工工作站。相比在个人电脑上运行，Linux服务器环境更稳定、权限更可控、资源分配更合理，特别适合需要7×24小时持续运行的场景。

我第一次在Ubuntu服务器上部署成功后，最直观的感受是：它不像传统AI工具那样需要你打开网页、输入问题、等待回复；而是像一个真正的同事，随时待命，能直接操作文件、执行命令、管理任务。比如让它自动整理每天的邮件摘要并保存到指定目录，或者定时检查系统日志并发送异常提醒——这些操作在Linux环境下实现起来既自然又高效。

不过需要提前说明的是，Clawdbot拥有较高的系统权限，这既是它强大的原因，也是需要注意安全的地方。所以本教程会特别强调安全配置环节，包括如何创建专用用户、限制权限范围、配置防火墙规则等实用技巧。整个过程不需要你成为Linux专家，只要能看懂命令行提示，跟着步骤操作就能完成。

2. 系统环境准备与基础依赖安装

2.1 确认系统版本与硬件要求

在开始安装前，先确认你的Linux系统是否满足基本要求。Clawdbot官方推荐使用Ubuntu 20.04或更高版本，以及CentOS 8+系统。你可以通过以下命令快速查看当前系统信息：

# 查看操作系统版本
cat /etc/os-release

# 查看内核版本
uname -r

# 查看可用内存（确保至少2GB）
free -h

# 查看磁盘空间（确保至少1GB可用）
df -h

如果系统版本较老，建议先升级到受支持的版本。对于硬件要求，Clawdbot对性能要求并不苛刻，即使是入门级的云服务器（如2核2GB内存）也能流畅运行基础功能。但如果你计划同时运行多个技能（Skills）或处理较复杂的任务，建议选择4GB内存以上的配置。

2.2 安装Node.js运行环境

Clawdbot基于Node.js开发，因此第一步是安装合适的Node.js版本。官方明确要求Node.js 22.x或更高版本，低于这个版本可能会出现兼容性问题。

对于Ubuntu/Debian系统：

# 更新包管理器
sudo apt update

# 安装必要的依赖
sudo apt install -y curl gnupg2 software-properties-common

# 添加NodeSource仓库（Node.js 22.x）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装Node.js
sudo apt install -y nodejs

# 验证安装
node --version
npm --version

对于CentOS/RHEL系统：

# 启用Node.js 22.x仓库
sudo dnf module enable nodejs:22

# 安装Node.js
sudo dnf install -y nodejs npm

# 验证安装
node --version
npm --version

安装完成后，建议全局安装pnpm作为包管理器，它比npm更快且更节省磁盘空间：

# 全局安装pnpm
sudo npm install -g pnpm

# 验证安装
pnpm --version

2.3 创建专用运行用户（安全最佳实践）

出于安全考虑，强烈建议不要以root用户身份运行Clawdbot。创建一个专用用户不仅能隔离权限，还能避免意外操作影响系统稳定性。

# 创建名为clawbot的用户
sudo adduser clawbot

# 将clawbot用户添加到sudo组（仅在需要时使用sudo权限）
sudo usermod -aG sudo clawbot

# 切换到clawbot用户
su - clawbot

# 验证当前用户
whoami

创建专用用户后，后续所有安装和配置操作都应在该用户下进行。这样即使Clawdbot被恶意利用，攻击者也只能访问该用户的权限范围，无法直接影响系统核心功能。

3. Clawdbot核心安装与配置

3.1 选择安装方式并执行部署

Clawdbot提供了多种安装方式，根据你的使用场景选择最适合的一种：

• npm/pnpm安装：适合大多数用户，更新方便，官方推荐
• 安装脚本：最快捷的方式，一键完成所有步骤
• Docker安装：适合已有容器化环境的用户，隔离性好

对于Linux新手，我推荐使用官方安装脚本，它会自动处理大部分依赖和路径配置：

# 切换到clawbot用户后执行
curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git

这个命令会从GitHub克隆最新代码，并自动安装所有依赖。安装过程大约需要2-5分钟，具体时间取决于你的网络速度和服务器性能。

如果你更倾向于手动控制安装过程，可以使用pnpm方式：

# 创建项目目录
mkdir ~/clawbot && cd ~/clawbot

# 克隆官方仓库
git clone https://github.com/clawdbot/clawdbot.git .

# 安装依赖
pnpm install

# 构建项目
pnpm build

无论选择哪种方式，安装完成后都会在用户主目录下生成clawbot文件夹，里面包含了所有必要的文件和配置模板。

3.2 配置文件详解与修改要点

安装完成后，需要对几个关键配置文件进行设置。Clawdbot的主要配置文件位于~/.clawbot/config.json，但首次运行时会自动生成默认配置。

最重要的配置项包括：

• gateway.bind：绑定IP地址，默认为127.0.0.1，如果需要远程访问，改为0.0.0.0
• gateway.port：服务端口，默认18789，可根据需要修改
• ai.backend：选择AI后端，如openai、anthropic、ollama等
• ai.apiKey：对应AI服务的API密钥

为了简化配置过程，Clawdbot提供了交互式配置向导：

# 运行配置向导
clawbot onboard

# 或者直接设置关键参数
clawbot config set gateway.bind "0.0.0.0"
clawbot config set gateway.port 18789
clawbot config set ai.backend "ollama"
clawbot config set ai.model "llama3"

特别注意防火墙配置： 如果你将gateway.bind设置为0.0.0.0，必须确保防火墙允许相应端口的访问：

# Ubuntu系统（UFW）
sudo ufw allow 18789

# CentOS系统（firewalld）
sudo firewall-cmd --permanent --add-port=18789/tcp
sudo firewall-cmd --reload

3.3 Ubuntu与CentOS的差异化配置说明

虽然Clawdbot在两种系统上的核心安装流程相似，但在一些细节上存在差异，需要特别注意：

Ubuntu特有配置：

• Ubuntu默认使用systemd-resolved进行DNS解析，有时会导致Clawdbot连接外部API时出现超时。如果遇到网络问题，可以临时禁用：

  sudo systemctl stop systemd-resolved
  sudo systemctl disable systemd-resolved
  

• Ubuntu的apt包管理器更新频率较高，建议在安装前运行sudo apt update && sudo apt upgrade -y确保系统最新。

CentOS特有配置：

• CentOS 8+默认使用dnf而非yum，命令语法略有不同
• CentOS的SELinux安全模块可能阻止Clawdbot正常访问网络或文件系统。如果遇到权限问题，可以临时调整SELinux策略：

  # 临时设置为宽容模式
  sudo setenforce 0
  
  # 永久修改（需重启）
  sudo sed -i 's/SELINUX=enforcing/SELINUX=permissive/g' /etc/selinux/config
  

此外，两个系统在服务管理上也有所不同。Ubuntu使用systemd服务管理，而较老的CentOS版本可能使用init.d脚本。本教程后续的服务启动部分会分别说明两种系统的处理方式。

4. 服务启动与多平台通道配置

4.1 启动Clawdbot服务并验证运行状态

安装和配置完成后，就可以启动Clawdbot服务了。有几种不同的启动方式，适用于不同场景：

前台运行（调试用）：

# 在clawbot用户下直接运行
clawbot start

这种方式会在当前终端显示实时日志，适合初次测试和调试。按Ctrl+C可以停止服务。

后台服务（生产环境推荐）：

# 安装系统服务（Ubuntu/Debian）
sudo cp ~/clawbot/scripts/clawbot.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable clawbot
sudo systemctl start clawbot

# CentOS/RHEL系统
sudo cp ~/clawbot/scripts/clawbot.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable clawbot
sudo systemctl start clawbot

启动服务后，可以通过以下命令验证运行状态：

# 查看服务状态
sudo systemctl status clawbot

# 查看最近日志
sudo journalctl -u clawbot -n 50 -f

# 测试API是否正常响应
curl http://localhost:18789/health

如果一切正常，你应该能看到类似{"status":"ok","timestamp":...}的健康检查响应。

4.2 配置企业微信通道（详细步骤）

企业微信是目前国内最常用的企业协作平台，Clawdbot通过simple-wecom插件可以无缝接入。配置过程分为三个主要步骤：

第一步：安装并启用企业微信插件

# 安装插件
clawbot plugins install @william.qian/simple-wecom

# 启用插件
clawbot plugins enable simple-wecom

第二步：获取企业微信配置参数 你需要向企业微信管理员申请以下四个参数：

• corpid：企业ID，在「我的企业」-「企业信息」中查看
• corpsecret：应用Secret，在「应用管理」-「自建应用」中创建应用后获取
• token：消息验证Token，可自行设置任意字符串
• encodingAESKey：消息加解密Key，点击「生成」按钮获得

第三步：配置Clawdbot企业微信参数

# 设置企业微信配置
clawbot config set channels.simple-wecom.corpid "ww1234567890abcdef"
clawbot config set channels.simple-wecom.corpsecret "your-corp-secret"
clawbot config set channels.simple-wecom.token "your-token"
clawbot config set channels.simple-wecom.encodingAESKey "your-aes-key"
clawbot config set channels.simple-wecom.enabled true

# 配置网关模式（重要！）
clawbot config set gateway.mode "local"
clawbot config set gateway.bind "0.0.0.0"
clawbot config set gateway.port 18789

# 重启网关使配置生效
clawbot gateway restart

配置完成后，登录企业微信管理后台，在「应用管理」-「自建应用」中找到你的应用，将回调URL设置为http://你的服务器IP:18789/wecom/callback，Token和EncodingAESKey填写上面设置的值。

4.3 配置钉钉与QQ通道（简明指南）

除了企业微信，Clawdbot还支持钉钉和QQ等国内主流通讯平台。配置逻辑类似，只是参数获取方式略有不同。

钉钉通道配置要点：

• 在钉钉开放平台创建企业内部应用
• 获取AppKey和AppSecret（对应Clawdbot配置中的appKey和appSecret）
• 需要配置消息卡片模板，Clawdbot支持AI卡片类型
• 回调地址格式：http://你的服务器IP:18789/dingtalk/callback

QQ通道配置要点：

• 在QQ开放平台创建机器人应用
• 获取AppID、BOT TOKEN和BOT SECRET
• 必须配置IP白名单，将服务器公网IP添加到白名单中
• 回调地址格式：http://你的服务器IP:18789/qq/callback

配置完成后，都可以通过以下命令验证通道状态：

# 查看所有已配置通道的状态
clawbot channels status

# 单独检查某个通道
clawbot channels status wecom
clawbot channels status dingtalk

如果看到status: connected，说明通道配置成功，可以开始使用了。

5. 实用技巧与常见问题解决

5.1 提升运行效率的实用技巧

部署完成后，有几个小技巧可以让Clawdbot运行得更顺畅：

内存优化： 如果服务器内存有限，可以通过限制Node.js内存使用来避免OOM（内存溢出）：

# 编辑系统服务文件
sudo nano /etc/systemd/system/clawbot.service

# 在ExecStart行末尾添加内存限制
ExecStart=/usr/bin/node --max-old-space-size=1536 /home/clawbot/clawbot/dist/index.js

日志管理： 默认情况下Clawdbot会产生大量日志，建议配置日志轮转：

# 创建日志轮转配置
sudo tee /etc/logrotate.d/clawbot << 'EOF'
/home/clawbot/.clawbot/logs/*.log {
    daily
    missingok
    rotate 30
    compress
    delaycompress
    notifempty
    create 644 clawbot clawbot
}
EOF

自动更新： 为了让Clawdbot保持最新状态，可以设置定期自动更新：

# 编辑crontab
crontab -e

# 添加每周日凌晨2点自动更新
0 2 * * 0 cd /home/clawbot/clawbot && git pull origin main && pnpm install && pnpm build && sudo systemctl restart clawbot

5.2 新手常见问题及解决方案

在实际部署过程中，新手经常会遇到一些典型问题，这里整理了最常见的几个及其解决方法：

问题1：安装脚本执行失败，提示"command not found"

• 原因：可能是curl命令未安装，或bash版本过低
• 解决：sudo apt install curl（Ubuntu）或sudo dnf install curl（CentOS）

问题2：启动服务后无法访问Web UI

• 原因：防火墙阻止了端口访问，或gateway.bind配置错误
• 解决：检查防火墙设置，确认clawbot config get gateway.bind返回0.0.0.0

问题3：企业微信回调验证失败

• 原因：服务器时间不同步，或Token/EncodingAESKey不匹配
• 解决：同步系统时间sudo timedatectl set-ntp true，重新核对配置参数

问题4：AI响应缓慢或超时

• 原因：网络连接问题，或AI后端API密钥无效
• 解决：测试网络连通性curl -v https://api.openai.com，检查API密钥是否正确

问题5：权限错误，无法写入文件或执行命令

• 原因：Clawdbot以clawbot用户运行，但目标目录属于其他用户
• 解决：sudo chown -R clawbot:clawbot /目标目录

5.3 安全加固建议（必读）

Clawdbot的强大源于其高权限设计，但这也意味着安全配置至关重要。以下是几条关键的安全建议：

最小权限原则： 确保clawbot用户只拥有执行必要任务的权限。例如，如果不需要访问系统日志，就不要将其加入syslog组。

网络隔离： 如果不需要外部访问，将gateway.bind保持为127.0.0.1，并通过反向代理（如Nginx）提供外部访问，这样可以添加额外的身份验证层。

定期备份： Clawdbot的配置和数据存储在~/.clawbot目录下，建议定期备份：

# 创建备份脚本
cat > ~/backup_clawbot.sh << 'EOF'
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
tar -czf /backup/clawbot_backup_$DATE.tar.gz ~/.clawbot
find /backup -name "clawbot_backup_*.tar.gz" -mtime +7 -delete
EOF

chmod +x ~/backup_clawbot.sh

监控告警： 可以简单监控Clawdbot服务状态：

# 检查服务是否运行
if ! systemctl is-active --quiet clawbot; then
    echo "Clawdbot service is down!" | mail -s "Clawdbot Alert" admin@example.com
fi

记住，安全不是一劳永逸的事情，而是需要持续关注和调整的过程。每次添加新技能或配置新通道时，都要重新评估其安全影响。

6. 总结与下一步建议

整个部署过程走下来，你会发现Clawdbot在Linux系统上的安装其实比想象中简单得多。从环境准备到服务运行，核心步骤就是安装Node.js、执行安装脚本、配置关键参数、启动服务这几个环节。真正花时间的往往是网络配置和权限调整这些细节问题，而不是技术本身有多复杂。

我个人觉得最有价值的部分是它带来的工作方式转变——不再需要在不同应用间切换，而是通过熟悉的聊天界面就能完成各种任务。比如在企业微信里发一句“把今天所有的会议纪要整理成Markdown发到共享文档”，Clawdbot就会自动执行，这种体验确实让人眼前一亮。

如果你刚完成部署，建议先从简单的测试开始，比如让它帮你生成一段代码、查询天气、或者整理文件列表。熟悉基本操作后再逐步尝试更复杂的技能，比如自动处理邮件、监控网站变化、或者集成内部业务系统。每个技能的配置都有文档说明，按照指引一步步来基本不会出错。

另外想提醒的是，虽然教程里提到了企业微信、钉钉等多种通道，但不必一开始就全部配置。选择你最常用的1-2个平台先用起来，等熟悉了再扩展。毕竟Clawdbot的魅力不在于它能连接多少平台，而在于它能帮你解决多少实际问题。

最后，如果你在部署过程中遇到了任何问题，或者发现了更好的配置方法，欢迎分享出来。开源项目的进步往往就来自于这些日常使用中的点滴积累。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。