以下是 Ubuntu 上从零开始的详细安装步骤：

1. 环境要求

• Ubuntu: 22.04 LTS 或 24.04 LTS（推荐）

• Node.js: 22.0.0 或更高版本

• 内存: 至少 2GB RAM

• 网络: 需要访问 AI 服务（如 Claude、OpenAI 等）的 API Key

2. 安装步骤

步骤 1：系统更新

sudo apt update && sudo apt upgrade -y

步骤 2：安装 Node.js 22+

Ubuntu 默认仓库的 Node.js 版本较旧，需要使用 NodeSource 安装：

# 添加 Node.js 22 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

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

# 验证版本（应显示 v22.x.x）
node --version
npm --version

步骤 3：安装 Clawdbot

有两种推荐方式：

方式 A：一键安装脚本（推荐）

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

安装完成后，执行 exec bash 刷新环境变量，或重新打开终端。

方式 B：通过 NPM 全局安装

sudo npm install -g clawdbot@latest

验证安装：

clawdbot --version
# 应显示版本号，如 2026.1.x

步骤 4：运行配置向导

clawdbot onboard

按照提示完成初始化配置，包括：

• AI 提供商设置（需要准备 Claude 或 OpenAI 的 API Key）

• 消息平台连接（Telegram/WhatsApp 等，可选）

• 安全设置

步骤 5：配置 AI API（关键环节）

编辑配置文件添加 AI 服务：

nano ~/.clawdbot/clawdbot.json

添加或修改 models.providers 部分：

{
  "models": {
    "providers": [
      {
        "name": "anthropic",
        "baseUrl": "https://api.anthropic.com",
        "apiKey": "sk-ant-xxxxx",
        "api": "claude",
        "models": ["claude-3-5-sonnet-20241022"]
      }
    ]
  }
}

注意：

• 必须包含 baseUrl、apiKey、api、models 四个字段

• 修改后必须重启 Gateway

步骤 6：启动 Gateway 服务

# 前台运行（测试用）
clawdbot gateway --bind lan --port 18789

# 或后台运行
clawdbot gateway restart

默认端口为 18789。

步骤 7：访问 Web UI

7.1 本地访问

直接打开浏览器访问：

http://localhost:18789

7.2 远程服务器访问（SSH 隧道）

如果在远程服务器安装，需要建立 SSH 隧道：

# 在本地电脑运行，替换 YOUR_SERVER_IP
ssh -L 18789:127.0.0.1:18789 root@YOUR_SERVER_IP

然后在本地浏览器打开 http://127.0.0.1:18789。

7.3 查看访问 Token

如果忘记 token，运行：

clawdbot dashboard

3. 常用命令速查

# 查看状态
clawdbot channels status

# 重启 Gateway（修改配置后必做）
clawdbot gateway restart

# 查看日志
tail -f ~/.clawdbot/logs/gateway.log

# 连接 Telegram/WhatsApp
clawdbot login

# 发送消息测试
clawdbot send --to +1234567890 --message "Hello"

# 安全审计（生产环境必做）
clawdbot security audit --deep

4. 安全配置建议

4.1 限制访问来源（如果使用防火墙）：

sudo ufw allow from 100.64.0.0/10 to any port 18789 proto tcp

4.2 保护配置文件：

chmod 700 ~/.clawdbot
chmod 600 ~/.clawdbot/credentials

4.3 启用白名单模式：

在配置中设置仅允许特定 Telegram ID 交互，避免被他人滥用。

5. 故障排除

注意：Clawdbot 已更名为 Moltbot，部分旧文档可能仍使用旧名称，但命令保持一致