常见问题 FAQ
OpenClaw 常见问题解答 — 安装、配置、AI 模型、渠道和故障排除。
常规
什么是 OpenClaw？
OpenClaw 是一个开源的、自托管的 AI Agent 框架。它让你通过统一的 Gateway 将 AI 模型（OpenAI、Claude、Ollama 等）连接到消息渠道（WhatsApp、Telegram、Discord 等）。
OpenClaw 免费吗？
是的。OpenClaw 采用 MIT 许可证，完全免费使用。但云端 AI 模型提供商（OpenAI、Anthropic、Google 等）会收取 API 使用费。你可以使用 Ollama 在本地免费运行模型。
系统要求是什么？
- Node.js 22+
- 支持 Windows、macOS 或 Linux
- 至少 2 GB 内存（通过 Ollama 运行本地模型需要更多）
安装
如何安装 OpenClaw？
最快的方式：
npm install -g openclaw@latest
openclaw onboard --install-daemon详见 快速开始指南。
可以在 Docker 中运行吗？
可以。详见 Docker 安装指南 中的 docker run 和 docker compose 示例。
如何更新 OpenClaw？
npm install -g openclaw@latest
openclaw service restart配置
配置文件在哪里？
主配置文件位于 ~/.openclaw/openclaw.json。你也可以通过控制面板修改设置。
如何更换 AI 模型？
编辑配置中的 agents 部分：
{
"agents": {
"default": {
"provider": "anthropic",
"model": "claude-sonnet-4-20250514"
}
}
}可以同时使用多个 AI 模型吗？
可以。配置多个使用不同提供商的 Agent。详见 多 Agent 路由。
渠道
支持哪些消息平台？
OpenClaw 支持 20+ 个渠道，包括 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、IRC、Microsoft Teams、LINE、Matrix 等。完整列表见 官方文档。
每个渠道都需要单独的账号吗？
是的。每个渠道需要自己的凭证：
- Telegram — 从 BotFather 获取 Bot token
- WhatsApp — 用手机扫描二维码配对
- Discord — 从 Discord 开发者门户获取 Bot token
如何限制谁可以给机器人发消息？
使用白名单或配对机制。详见 安全最佳实践。
故障排除
Gateway 无法启动
- 检查端口是否被占用：
openclaw gateway --port 18790 - 验证 Node.js 版本：
node --version（需要 22+） - 运行诊断：
openclaw doctor --fix
机器人没有响应
- 检查 Gateway 状态：
openclaw gateway status - 验证 API 密钥设置是否正确
- 检查渠道配置和凭证
- 查看日志：
openclaw logs --follow
如何重置所有设置？
rm -rf ~/.openclaw
openclaw onboard --install-daemon