在云服务器上部署Moltbot

Moltbot（原Clawdbot） 是一款开源的个人AI助手和智能代理系统，旨在帮助用户通过日常消息平台（如 Telegram、WhatsApp、Slack、Discord 等）与AI进行交互，并自动执行任务、自动化工作流程、管理文件等操作。在云服务器上自托管部署，既保证数据和AI调用密钥的隐私安全，又支持24/7稳定运行与远程访问。同时可按需弹性扩展计算资源，满足多用户、多平台并发使用，运维升级便捷，是企业或个人高效使用 AI 助手的理想方案。

准备部署环境

配置Moltbot

配置信息总览

具体步骤

1、在金山云星流模型API服务平台，前往API Key管理，新建API Key。

请妥善保管API Key，一旦泄露，第三方可能冒用您的身份执行操作，导致意外的API调用费用。

2、根据建议配置创建一台云服务器并登录，输入命令clawdbot onboard进入配置页面。

3、阅读安全须知后，选择Yes即可。

4、Onboarding模式选择QuickStart（快速开始）。

5、在Model/auth provider中选择Skip for now，后续进行配置。

6、在Filter models by provider中选择All providers。

7、在Default model中选择默认配置。

8、在Select channel中选择skip for now，后续进行配置。

9、在Configure skills now中选择No，后续进行配置。

10、在Enable hooks中使用空格键选中command-logger与session-memory，按回车进入下一步。

查看并修改配置信息

1、输入命令vim ~/.clawdbot/clawdbot.json修改配置文件，配置信息如下：

复制粘贴配置到Clawdbot时，请去掉示例中的 // 注释 或 /* */ 提示，只保留纯 JSON 内容。

{
  /* ========= 元信息 ========= */
  "meta": {
    "lastTouchedVersion": "2026.1.24-3",          // 最后修改配置的 Clawdbot 版本
    "lastTouchedAt": "2026-01-28T12:13:19.590Z"   // 最后修改时间（UTC）
  },

  /* ========= 初始化向导执行记录 ========= */
  "wizard": {
    "lastRunAt": "2026-01-28T11:17:00.330Z",      // 上一次运行向导时间
    "lastRunVersion": "2026.1.24-3",              // 向导对应版本
    "lastRunCommand": "onboard",                  // 执行的向导命令
    "lastRunMode": "local"                        // 本地模式
  },

  /* ========= 模型相关配置 ========= */
  "models": {
    "providers": {
      "starflow": {
        "baseUrl": "https://kspmas.ksyun.com/v1", // 金山云星流API服务Base URL
        "apiKey": "${STARFLOW_API_KEY}",           // API Key，建议环境变量
        "api": "openai-completions",               // OpenAI兼容接口
        "authHeader": false,                       // 是否在header中传auth
        "models": [
          {
            "id": "deepseek-v3-0324",             // 模型ID
            "name": "deepseek-v3-0324",           // 模型展示名称
            "api": "openai-completions",          // 调用API类型
            "reasoning": false,                    // 是否启用深度思考
            "input": ["text"],                     // 支持输入类型
            "contextWindow": 200000,               // 上下文窗口大小
            "maxTokens": 8192                      // 最大输出 token
          }
        ]
      }
    }
  },

  /* ========= Agent 默认行为配置 ========= */
  "agents": {
    "defaults": {
      "model": {
        "primary": "starflow/deepseek-v3-0324"   // 默认使用模型
      },
      "workspace": "/root/clawd",                // 工作目录
      "maxConcurrent": 4,                        // 主 agent 并发数
      "subagents": {
        "maxConcurrent": 8                        // 子 agent 并发数
      }
    }
  },

  /* ========= 消息配置 ========= */
  "messages": {
    "ackReactionScope": "group-mentions"         // 仅在群聊 @ 时回应
  },

  /* ========= 命令与技能 ========= */
  "commands": {
    "native": "auto",                             // 原生命令自动启用
    "nativeSkills": "auto"                        // 原生技能自动启用
  },

  /* ========= 内部 Hook ========= */
  "hooks": {
    "internal": {
      "enabled": true,                            // 启用内部 hook
      "entries": {
        "command-logger": {
          "enabled": true                         // 命令日志
        },
        "session-memory": {
          "enabled": true                         // 会话记忆
        }
      }
    }
  },

  /* ========= 本地 Gateway ========= */
  "gateway": {
    "port": 18789,                                // 本地端口
    "mode": "local",                              // 本地模式
    "bind": "loopback",                           // 仅本地
    "auth": {
      "mode": "token",                            // Token 认证
      "token": "${CLAWDBOT_GATEWAY_TOKEN}"        // 建议使用环境变量
    },
    "tailscale": {
      "mode": "off",                              // Tailscale 未启用
      "resetOnExit": false                         // 退出时不重置
    },
    "http": {
      "endpoints": {
        "responses": {
          "enabled": false                        // 是否暴露 responses API
        }
      }
    }
  }
}

2、保存配置后，输入命令clawdbot gateway restart重启gateway服务。

3、输入命令clawdbot models list检查已注册的模型列表。

若模型已成功注册，显示如下：

连接WebUI进行配置与对话（可选）

Clawdbot提供一个基于浏览器的WebUI（Dashboard），用于可视化管理和配置agent、模型、命令和hooks。

WebUI 是可选功能，适合想通过浏览器直观管理Clawdbot的用户，也可以与纯配置文件方式结合使用。

1、通过SSH隧道安全访问Clawdbot Dashboard
使用SSH隧道将远程服务器上的Gateway端口映射到本地端口，实现本地浏览器访问远程Clawdbot。示例命令：

ssh -i "<SSH密钥文件路径>" -N -L 18789:127.0.0.1:18789 ubuntu@<服务器公网IP>

• -i "<SSH密钥文件路径>"：指定 SSH 私钥文件

• -N：不执行远程命令，仅建立隧道

• -L 18789:127.0.0.1:18789：将远程服务器 18789 端口映射到本地 18789

• ubuntu@<服务器公网IP>：远程服务器用户名和公网 IP

2、在本地浏览器访问 Dashboard
打开以下URL（替换YOUR_TOKEN为你在Clawdbot配置中设置的Gateway Token）：

http://localhost:18789/?token=YOUR_TOKEN

3、注意事项

• 确保本地端口18789未被占用，否则可以修改隧道本地端口，例如-L 8888:127.0.0.1:18789，然后访问http://localhost:8888/?token=YOUR_TOKEN。

• 隧道建立期间保持终端窗口打开，关闭窗口隧道即断开。