OpenClaw 常见问题解答，涵盖基础概念、设置、使用和故障排除。
基础概念
什么是 OpenClaw？
OpenClaw 是一个开源的 AI 代理网关，可以将各种聊天平台（WhatsApp、Telegram、Discord、iMessage 等）连接到 AI 模型。它让你能够构建一个永不离线的个人 AI 助手。
OpenClaw 和 Claude Code 有什么区别？
Claude Code 是 Anthropic 的官方 CLI 工具，专注于编程辅助。OpenClaw 是一个消息网关，专注于通过各种聊天平台与 AI 代理交互。它们可以配合使用，但服务于不同目的。
Gateway 是什么？
Gateway 是 OpenClaw 的核心组件，负责处理消息路由、会话管理、认证和工具调用。它作为后台服务运行，接收来自各个聊天平台的消息并将它们转发给 AI 模型。
安装与设置
OpenClaw 支持哪些操作系统？
macOS、Linux 和 Windows（通过 WSL2）。对于 Windows，强烈建议使用 WSL2 而非原生 Windows。
需要什么版本的 Node.js？
Node.js 22 或更高版本。
如何更新 OpenClaw？
openclaw update或者重新运行安装脚本。详见 更新指南。
认证与模型
支持哪些 AI 模型提供商？
OpenAI、Anthropic、Amazon Bedrock、Moonshot AI、MiniMax、OpenRouter、Vercel AI Gateway 等。详见 模型提供商。
如何配置 API 密钥？
使用引导向导：
openclaw onboard或手动配置：
openclaw configure支持 OAuth 认证吗？
是的，支持 Anthropic OAuth（Claude Pro/Max）。详见 OAuth。
聊天平台
支持哪些聊天平台？
WhatsApp、Telegram、Discord、iMessage、Slack、Mattermost、Signal、Microsoft Teams、LINE、Matrix 等。详见 聊天频道。
可以同时连接多个平台吗？
是的，OpenClaw 支持同时连接多个聊天平台，消息会根据配置路由到相应的代理。
iMessage 支持需要什么？
iMessage 支持需要 macOS 设备。详见 iMessage。
安全
OpenClaw 安全吗？
OpenClaw 提供多层安全机制，包括配对审批、白名单、沙箱执行等。但请记住，AI 代理可能会执行命令和读写文件，请谨慎配置。详见 安全。
什么是配对审批？
配对审批是 OpenClaw 的安全机制，未知发送者必须通过审批才能与代理交互。详见 配对。
如何限制谁可以与代理交互？
使用 allowFrom 白名单配置：
{
"channels": {
"whatsapp": {
"allowFrom": ["+15555550123"]
}
}
}故障排除
openclaw: command not found
这通常是 Node/npm PATH 问题。详见 安装指南。
Gateway 无法连接
检查端口是否正确（默认 18789），确保服务正在运行：
openclaw gateway status
openclaw health如何查看日志？
openclaw logs --follow日志默认位于 /tmp/openclaw/。
如何运行诊断？
openclaw doctor这会自动检测和修复常见问题。