常见问题

本页汇总安装、配置与使用中的常见问题。更完整的问题列表与详细说明请参考 英文 FAQ。

出问题时的前 60 秒

若出现异常，先按顺序执行：

moltbot status
moltbot status --all
moltbot gateway probe
moltbot logs --follow
moltbot doctor

快速开始与首次设置

• 推荐安装方式： 使用官方安装脚本，再运行 moltbot onboard 完成向导。
• 安装后打开控制台： 运行 moltbot dashboard。
• 所需环境： Node.js 22+，macOS / Linux / Windows (WSL2)。

安装与更新

• 如何安装： 安装概览、安装器说明、Docker 部署。
• 如何更新： 使用安装脚本重新安装，或 npm update -g moltbot（取决于你的安装方式）。
• 稳定版与 Beta： 稳定版适合日常使用；Beta 可提前体验新功能，安装时加 --beta。

模型与认证

• 是否需要 Claude/OpenAI 订阅： 需要可用的 API 或 OAuth 配置。详见 OAuth / 认证。
• 本地模型： 支持，适合轻量对话。见 模型。

网关与频道

• 网关应放在本机还是 VPS： 视需求而定；本机适合个人使用，VPS 适合 7×24 或远程访问。
• 频道配置： 见 频道 下各平台说明（WhatsApp、Telegram、Discord 等）。

技能与自动化

• 技能与定时任务： 见 技能、Cron。
• 自定义技能目录： 可在配置中指定自定义技能目录，详见 技能配置。

更多问题

完整问题列表（含英文原文）请查看 FAQ (English)。