🔰 基础问题

Q: OpenClaw / Moltbot / Clawdbot 是什么关系?

它们是同一个项目的不同名称:

  • Clawdbot - 最初的名字
  • Moltbot - 因商标问题改名
  • OpenClaw - 最新名称(2026年1月30日)

代码和功能完全一样,CLI 命令仍然是 moltbotclawdbot

Q: OpenClaw 和 ChatGPT 有什么区别?

OpenClawChatGPT
运行位置你自己的设备OpenAI 服务器
数据隐私完全本地上传到云端
功能Agent(可执行任务)主要是对话
消息渠道飞书/钉钉/Telegram等网页/App
价格按 API 调用付费订阅制 20美元/月

Q: 需要什么技术基础?

最低要求:

  • 会复制粘贴命令
  • 会用 SSH 连接服务器
  • 会编辑文本文件

不会命令行?试试 AI 编程工具:

  • 使用 Cursor、Windsurf 等 AI 编程工具
  • 通过 SSH 连接服务器后,让 AI 帮你执行命令
  • 遇到问题直接问 AI,它会帮你排查和修复

这比找技术朋友更方便,AI 24 小时在线,有问必答。

💻 安装问题

Q: npm install 报错怎么办?

常见解决方法:

# 清除 npm 缓存
npm cache clean --force

# 使用国内镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g moltbot@latest

Q: moltbot 命令找不到?

可能是 PATH 配置问题:

# 检查 npm 全局路径
npm config get prefix

# 确保该路径在 PATH 中
export PATH="$PATH:$(npm config get prefix)/bin"

# 添加到 ~/.bashrc 永久生效
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc

Q: Gateway 启动失败?

检查步骤:

  1. 查看日志:moltbot gateway(前台运行看错误)
  2. 检查端口占用:lsof -i :18789
  3. 检查配置文件:moltbot doctor

⚙️ 配置问题

Q: 飞书/钉钉收不到消息?

常见原因:

  1. 应用未发布上线(还在草稿状态)
  2. 事件订阅未选择「长连接」模式
  3. 权限未开通
  4. Gateway 未启动或已崩溃

检查 Gateway 日志是否显示成功登录:

tail -f /tmp/gateway.log | grep "logged in"

Q: 模型 API 调用失败?

检查:

  • API Key 是否正确
  • baseUrl 格式是否正确(有些需要 /v1,有些不需要)
  • 账户余额是否充足
  • 网络是否能访问 API 地址

Q: 如何查看当前配置?

# 查看完整配置
cat ~/.clawdbot/clawdbot.json

# 使用 doctor 诊断
moltbot doctor

💬 使用问题

Q: AI 回复很慢怎么办?

可能的原因和解决方法:

  • 模型服务慢:换一个更快的模型,如 deepseek-chat
  • 服务器配置低:升级服务器配置
  • 网络问题:检查服务器到 API 的网络延迟

Q: 群聊中机器人不回复?

群聊默认只在以下情况回复:

  • 被 @ 时
  • 消息以问号结尾
  • 消息包含求助词(帮、请、怎么...)

尝试 @机器人 或在消息末尾加问号。

Q: 如何让 AI 记住信息?

OpenClaw 支持记忆功能,可以配置 remember skill:

对 AI 说:「记住我的邮箱是 [email protected]

之后问:「我的邮箱是什么?」它会记得。

🆘 还有问题?