FAQ
常见问题
下面是当前最常见、最有实操价值的一组 FAQ。它们主要围绕安装方式、运行时选择、Dashboard、日志、部署位置与 provider 认证策略。
高频问题
推荐的安装和设置方式是什么？
对绝大多数用户，推荐路径是：用官方安装脚本安装 CLI，然后执行 openclaw onboard --install-daemon。这样能一次性配置认证、Gateway、渠道、服务与基础 Skills。
新手引导后如何打开 Dashboard？
最快方式是执行 openclaw dashboard。如果 Gateway 正在本机运行，也可以直接访问 http://127.0.0.1:18789/。
OpenClaw 需要什么运行时？
推荐 Node 22 或更新版本。Bun 目前不建议用于 Gateway，尤其当你要接 WhatsApp / Telegram 时更应避免。
可以运行在 VPS 或 Raspberry Pi 上吗？
VPS 是很常见的部署位置，适合常驻 Gateway 和远程访问。至于 Raspberry Pi，要看你准备承担的负载与模型策略；文档中仍然建议把稳定运行放在更可靠的 Node 主机上。
必须购买 Mac mini 才能安装吗？
不需要。macOS 只是其中一条常见路径，Linux 主机和 WSL2 也都是有效部署方式。只有当你明确要接入 Apple 生态能力时，macOS 才会更有优势。
能不能在 npm 安装和 git 安装之间切换？
可以。文档里明确支持在两种安装方式之间切换；切换后执行 openclaw doctor，让 Gateway 服务入口点更新到当前安装方式即可。
日志在哪里？
优先用 openclaw logs --follow。如果你要找文件日志，常见位置是 /tmp/openclaw/，macOS LaunchAgent 与 Linux systemd 也会各自保留服务侧日志。
应该在笔记本电脑还是 VPS 上运行 Gateway？
如果你主要本地调试、偶尔使用，笔记本足够；如果你要 24/7 在线、多渠道接入或远程访问，VPS 更适合。关键不是“云更高级”，而是是否需要稳定常驻与远程可达。
OpenClaw 需要 Claude 或 OpenAI 订阅吗？
不强制，但你至少需要一种可用的模型认证路径。它可以是 OpenAI / Codex OAuth、Anthropic API Key、setup-token，或其他 provider 的 API Key。
配置文件和工作区在哪里？
常见位置是 ~/.openclaw/openclaw.json 与 ~/.openclaw/workspace。如果你使用 --dev 或 --profile，这些路径会切换到对应的隔离状态目录。