❓ 常见问题
遇到问题？这里可能有答案
🔰 基础问题
Q: OpenClaw / Moltbot / Clawdbot 是什么关系？
它们是同一个项目的不同名称：
- Clawdbot - 最初的名字
- Moltbot - 因商标问题改名
- OpenClaw - 最新名称（2026年1月30日）
代码和功能完全一样，CLI 命令仍然是 moltbot 或 clawdbot。
Q: OpenClaw 和 ChatGPT 有什么区别？
| OpenClaw | ChatGPT | |
|---|---|---|
| 运行位置 | 你自己的设备 | 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@latestQ: 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"' >> ~/.bashrcQ: Gateway 启动失败？
检查步骤：
- 查看日志：
moltbot gateway（前台运行看错误） - 检查端口占用：
lsof -i :18789 - 检查配置文件：
moltbot doctor
⚙️ 配置问题
Q: 飞书/钉钉收不到消息？
常见原因：
- 应用未发布上线（还在草稿状态）
- 事件订阅未选择「长连接」模式
- 权限未开通
- 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 说：「记住我的邮箱是 xxx@example.com」
之后问：「我的邮箱是什么？」它会记得。