FAQ常见问题
Start with ClawPanel, then choose the runtime you want to manage.先理解 ClawPanel 产品路径，再进入安装、配置、渠道和故障恢复。
常见问题 (FAQ)
安装问题
Q: Windows 安装时提示「Windows 已保护你的电脑」怎么办？
A: 先确认安装包来自本站官方下载页或 GitHub Release，且文件名、版本与下载页一致。确认无误后再点击「更多信息」→「仍要运行」；来源不明的安装包不要继续。
Q: macOS 提示「无法打开 ClawPanel，因为无法验证开发者」？
A: 先确认安装包来自官方发布页。确认后前往「系统设置 → 隐私与安全性」，找到 ClawPanel 并点击「仍要打开」。终端解除 quarantine 只建议在你确认包来源可信时使用。
Q: Linux 安装后找不到 OpenClaw？
A: 确保 Node.js 和 npm 在 PATH 中。如果使用 systemd 部署，需要在 service 文件中设置正确的 PATH 环境变量。
使用问题
Q: 控制台显示 Gateway 或运行时未运行？
A: 先确认 OpenClaw 已安装且命令在 PATH 中，再按控制台给出的操作启动服务。Web 部署场景还需要检查 systemd 服务、Node.js 版本和反向代理配置。
Q: 如何切换模型或渠道？
A: 以当前运行时界面提供的配置项为准。不同版本的字段和入口可能不同，配置后请先做连接测试或查看日志。
Q: API Key 安全吗？
A: 请以你实际部署方式为准。桌面和本地 Web 部署通常将配置保存在本机或服务器本地目录；如果你把 Web 版暴露到公网，务必使用 HTTPS、访问控制和强密码。
Q: 支持哪些模型供应商？
A: ClawPanel 可以配置当前运行时暴露的 OpenAI-compatible 入口。DeepSeek、Kimi、自定义网关等能否稳定使用，取决于你的供应商账号权限、模型名称、接口兼容性和当前 OpenClaw / Hermes 版本；请以连接测试和日志为准。
网络问题
Q: npm install 时出现网络错误？
A: 可以使用国内 npm 镜像：npm config set registry https://registry.npmmirror.com
Q: GitHub 下载太慢？
A: 可以在 下载页面 使用官方下载线路；如果当前线路不可用，也可以切换到 GitHub Releases。
FAQ
Installation
Q: Windows shows SmartScreen. What should I do?
A: Only continue if the file comes from the official download page or GitHub release. Then choose More info and Run anyway.
Q: macOS says the developer cannot be verified.
A: Open System Settings, Privacy & Security, and allow ClawPanel. You can also remove the quarantine attribute if you trust the official package.
Q: Linux cannot find OpenClaw after installation.
A: Confirm Node.js and npm are in PATH. For systemd deployment, set a correct PATH in the service file.
Usage
Q: The console says Gateway or runtime is not running.
A: Confirm OpenClaw is installed and reachable, then follow the action shown in the console. For Web deployment, also check systemd, Node.js and reverse proxy settings.
Q: How do I switch models or channels?
A: Use the configuration options exposed by your installed runtime version. Save the configuration, then check status or logs.
Q: Is my API key safe?
A: It depends on your deployment. Local desktop and self-hosted Web deployments usually store configuration locally. If Web is public-facing, use HTTPS, access control and strong credentials.
Network
Q: GitHub downloads are slow.
A: Use the official download page. Release files are served through the site download service, with R2 as the primary mirror and the site-hosted local mirror as fallback.