Moltbot/Clawdbot从零搭建部署实战攻略

6.7 消息发送

moltbot message send --target +15555550123 --message "Hello!"
moltbot message send --target +15555550123 --file /path/to/file.txt

6.8 袋里 (Agents)

moltbot agents list             # 查看袋里列表
moltbot agents add work --workspace ~/clawd-work  # 添加新袋里
moltbot agents status work      # 查看袋里状态

6.9 会话管理

moltbot sessions list              # 查看活跃会话
moltbot sessions history   # 查看会话历史
moltbot sessions reset     # 重置会话

6.10 技能管理

moltbot skills list              # 列出已安装技能
moltbot skills install skill-name # 安装技能
moltbot skills config skill-name  # 查看技能配置
moltbot skills update skill-name  # 更新技能

6.11 日志和诊断

moltbot logs --follow        # 实时查看日志
moltbot logs --limit 100     # 查看最近 100 行
moltbot health               # 健康检查
moltbot doctor               # 诊断
moltbot doctor --fix         # 诊断并修复

6.12 目录和工作区

moltbot dashboard       # 打开控制面板
moltbot tui             # 打开控制 UI
moltbot directory       # 查看工作区目录
ls -la ~/clawd/         # 查看文件

6.13 更新和升级

moltbot --version                         # 检查当前版本
curl -fsSL https://molt.bot/install.sh | bash  # 更新 CLI（安装脚本）
# 从源码更新：
git pull origin main
pnpm install
pnpm build
moltbot doctor
moltbot gateway restart

6.14 安全相关

moltbot security audit       # 安全审计
moltbot security audit --deep # 深度审计

7. 日常维护

7.1 定期检查命令

# 每日检查
moltbot status
moltbot health

# 每周检查
moltbot status --all
moltbot logs --limit 500 | grep -i error
moltbot doctor

7.2 日志管理

# 查看实时日志
moltbot logs --follow

# 查找错误
moltbot logs --limit 1000 | grep -i "error|failed"

# 按日期查看
ls -lt /tmp/moltbot/moltbot-*.log | head -5
tail -f /tmp/moltbot/moltbot-$(date +%Y-%m-%d).log

7.3 备份配置

# 备份配置文件
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.backup.$(date +%Y%m%d)

# 备份认证文件
cp ~/.clawdbot/agents/main/agent/auth-profiles.json ~/backups/auth-profiles.json.$(date +%Y%m%d)

# 备份工作区
tar -czvf ~/backups/clawd-backup.$(date +%Y%m%d).tar.gz ~/clawd/

7.4 更新流程

# 1. 检查当前版本
moltbot --version

# 2. 停止 Gateway
moltbot gateway stop

# 3. 更新 CLI
curl -fsSL https://molt.bot/install.sh | bash

# 4. 运行健康检查
moltbot doctor

# 5. 重新启动
moltbot gateway start

# 6. 验证状态
moltbot status

7.5 监控告警（可选）

创建一个监控脚本 ~/clawd/monitor.sh：

#!/bin/bash
echo "=== $(date) ==="
moltbot status
moltbot health
moltbot logs --limit 100 | grep -i error | tail -5

# 检查 Gateway 是否运行
if ! moltbot gateway status | grep -q "running"; then
    echo "⚠️ Gateway 未运行，尝试重启..."
    moltbot gateway restart
fi

添加执行权限并设置 cron：

chmod +x ~/clawd/monitor.sh
crontab -e
# 添加：0 * * * * ~/clawd/monitor.sh >> ~/clawd/monitor.log 2>&1

7.6 清理和维护

# 清理旧日志（保留最近7天）
find /tmp/moltbot -name "moltbot-*.log" -mtime +7 -delete

# 清理临时文件
rm -rf ~/.clawdbot/tmp/*

# 清理会话缓存
moltbot sessions list | awk '{print $1}' | xargs -I {} moltbot sessions reset {}

8. 故障排除

8.1 快速诊断流程

# 1. 运行完整诊断
moltbot status --all

# 2. 查看实时日志
moltbot logs --follow

# 3. 运行医生检查
moltbot doctor
moltbot doctor --fix

8.2 常见问题

问题 1：命令找不到

症状：zsh: command not found: moltbot

解决方案：

# 检查是否安装
npm list -g --depth=0 | grep moltbot

# 查找安装位置
find /usr -name moltbot -type f 2>/dev/null
find ~/.npm -name moltbot -type f 2>/dev/null

# 手动添加 PATH
echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc
source ~/.zshrc

问题 2：Gateway 无法启动

解决方案：

# 查看详细错误
moltbot gateway --verbose

# 检查端口占用
lsof -i :18789

# 检查配置
moltbot doctor

# 查看日志
moltbot logs --follow | tail -50

问题 3：无 API Key

症状：No API key found for provider 'anthropic'

解决方案：

# 重新配置
moltbot configure

# 或手动设置
export ANTHROPIC_API_KEY="sk-ant-api03-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-..."' >> ~/.clawdbot/.env

# 验证
moltbot models status

问题 4：频道无响应

解决方案：

# 1. 检查频道状态
moltbot channels status --probe

# 2. 检查配对状态
moltbot pairing list 

# 3. 查看日志
moltbot logs --follow | grep -i "channel|pairing"

# 4. 如果是 WhatsApp，尝试重新登录
moltbot channels logout
moltbot channels login

问题 5：OAuth 失败

解决方案：

# 切换到 API key
moltbot configure
# 选择 Anthropic API key

# 或使用 setup-token
moltbot models auth setup-token --provider anthropic

问题 6：模型不可用

症状：Unknown model: anthropic/claude-haiku-3-5

解决方案：

# 查看可用模型
moltbot models list

# 设置已知模型
moltbot models set anthropic/claude-sonnet-4-0

# 扫描新模型
moltbot models scan

问题 7：内存不足

解决方案：

# 检查内存使用
top -o memory

# 限制历史记录
moltbot config set 'session.historyLimit' 50

# 重启 Gateway 释放内存
moltbot gateway restart

8.3 紧急恢复

# 1. 停止 Gateway
moltbot gateway stop

# 2. 备份当前配置
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.emergency

# 3. 重置配置（保留工作区）
moltbot setup --reset config

# 4. 重新配置
moltbot onboard

# 5. 如果仍有问题，恢复配置
cp ~/.clawdbot/clawdbot.json.emergency ~/.clawdbot/clawdbot.json
moltbot gateway start

9. 进阶配置

9.1 多袋里配置

{
  "agents": {
    "list": [
      {
        "id": "main",
        "name": "主助手",
        "workspace": "~/clawd",
        "default": true,
        "model": {
          "primary": "minimax/MiniMax-M2.1",
          "fallbacks": ["glm-4"]
        }
      },
      {
        "id": "work",
        "name": "工作助手",
        "workspace": "~/clawd-work",
        "model": {
          "primary": "anthropic/claude-sonnet-4-0"
        }
      }
    ],
    "bindings": [
      {
        "agentId": "main",
        "match": { "channel": "whatsapp", "accountId": "personal" }
      },
      {
        "agentId": "work",
        "match": { "channel": "whatsapp", "accountId": "biz" }
      }
    ]
  }
}

9.2 模型主备配置

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax/MiniMax-M2.1",
        "fallbacks": [
          "anthropic/claude-sonnet-4-0",
          "glm-4",
          "openai/gpt-4o"
        ]
      }
    }
  }
}

9.3 频道配置示例

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "telegram": {
      "botToken": "your-bot-token",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

9.4 沙箱配置

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "all",
        "scope": "agent",
        "workspaceAccess": "rw"
      }
    }
  }
}

9.5 日志配置

{
  "logging": {
    "level": "info",
    "file": "/tmp/moltbot/moltbot.log",
    "consoleLevel": "info",
    "consoleStyle": "pretty",
    "redactSensitive": "tools"
  }
}

9.6 自定义工具配置

{
  "tools": {
    "allow": ["read", "write", "edit", "exec", "browser"],
    "deny": ["process", "gateway"]
  }
}

10. 常见问题

Q1: 需要多少内存？

A: 最低 2GB，推荐 4GB+。如果运行多个袋里或大量并发，需要更多。

Q2: 支持哪些模型？

A: 支持 Anthropic (Claude)、OpenAI (GPT)、MiniMax、GLM、Moonshot 等。具体运行 moltbot models list 查看。

Q3: 如何更改默认模型？

A: 运行 moltbot models set minimax/MiniMax-M2.1 或者 moltbot configure 重新跑一遍向导。

Q4: 支持多平台吗？

A: 支持 WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、iMessage 等。

Q5: 如何备份和恢复？

A:

# 备份
cp ~/.clawdbot/clawdbot.json backup/
cp -r ~/clawd backup/

# 恢复
cp backup/clawdbot.json ~/.clawdbot/
cp -r backup/clawd ~/

Q6: 更新后需要重新配置吗？

A: 一般不需要，配置会保留。但如果涉及重大变更，可能需要运行 moltbot doctor 修复。

Q7: Gateway 端口可以更改吗？

A: 可以：moltbot config set gateway.port 18889，然后重启 Gateway。

Q8: 如何实现负载均衡？

A: Moltbot 支持多 Gateway 部署，通过配置 gateway.remote.url 实现，具体参考高级配置文档。

Q9: 是否支持 Docker 部署？

A: 支持，Gateway 可以运行在 Docker 容器中。

Q10: 如何获取帮助？

A: 查看官方文档 docs.clawd.bot/，或者运行 moltbot --help / moltbot --help。也可以去 GitHub Issues 或 Discord 社区提问。

资源链接

• 官方文档：docs.clawd.bot/
• GitHub：github.com/moltbot/molt…
• Discord 社区：discord.com/invite/molt…
• 问题反馈：GitHub Issues
• 更新日志：github.com/moltbot/molt…

快速参考卡

# 日常使用
moltbot status             # 检查状态
moltbot health             # 健康检查
moltbot logs --follow      # 查看日志

# 配置
moltbot configure          # 交互配置
moltbot config get         # 查看配置
moltbot config set    # 设置配置

# 模型
moltbot models list        # 列出模型
moltbot models set  # 切换模型
moltbot models status      # 模型状态

# Gateway
moltbot gateway start      # 启动
moltbot gateway stop       # 停止
moltbot gateway restart    # 重启

# 故障排除
moltbot doctor             # 诊断
moltbot doctor --fix       # 自动修复
moltbot status --all       # 完整诊断

最后更新：2026年1月

版本：1.0