OpenClaw 常见问题 FAQ

1. 安装类问题

Q1：执行安装脚本后提示命令不存在？

A：先检查 Node.js 是否为 >=22，再重新打开终端执行安装。
可用命令：

node -v
openclaw --version

Q2：127.0.0.1:18789 打不开？

A：优先检查 Gateway 状态与端口冲突：

openclaw gateway status
openclaw gateway --port 18789 --verbose

2. 模型配置问题

Q3：模型配置后仍无法对话？

A：重点检查 3 个字段：

• baseUrl
• apiKey
• agents.defaults.model.primary

改完后执行：

openclaw config validate
openclaw gateway restart

Q4：为什么建议配置 fallback？

A：避免主模型超限、余额不足或故障导致任务失败。
建议至少 1 个 fallback，最好跨提供商。

3. 飞书接入问题

Q5：飞书机器人不回消息？

A：按顺序排查：

1. 是否先发布过应用版本
2. 事件订阅是否为长连接
3. 是否订阅 im.message.receive_v1
4. OpenClaw 里 channels.feishu.enabled 是否为 true

Q6：总是收到配对提示？

A：执行配对审批命令：

openclaw pairing approve feishu 配对码

若仍失败，检查是否复制了当前会话的正确配对码。

4. 运维与安全问题

Q7：修改配置后为什么没生效？

A：配置写入后通常需要重启 Gateway：

openclaw gateway restart

Q8：如何做最低限度安全加固？

A：建议至少做到：

• dmPolicy 使用 pairing
• API Key 不写进公开仓库
• 定期执行 openclaw doctor 与 openclaw config validate

5. 常用排错命令

openclaw status
openclaw health
openclaw doctor
openclaw logs
openclaw channels status
openclaw config validate

进阶专题入口：

• OpenClaw 进阶配置
• 身份设定指南
• 安全加固指南
• Skills 管理指南

如果你是第一次部署，建议按 教程导航 顺序完成整站流程。