小龙虾常见问题

安装与使用常见问题解答

以下汇总 OpenClaw（小龙虾）安装与使用过程中的常见问题。

Q：执行安装命令后没有反应？

确认已以管理员身份运行 PowerShell
确认网络可正常访问 openclaw.ai
脚本安装会先检测并安装 Node.js 等依赖，请耐心等待

Q：提示密钥无效？

确认密钥前后没有多余空格
确认选择的模型厂商与密钥所属厂商一致
确认密钥有可用额度，未被厂商禁用

Q：如何更换模型厂商？

执行 openclaw config 打开配置文件，修改模型厂商与对应密钥后重启 OpenClaw 即可。

Q：如何重启小龙虾？

修改配置或遇到偶发异常时，建议重启服务使配置生效：

# 一键重启（推荐）
openclaw restart

# 或手动重启网关服务
openclaw gateway restart

# 重启后确认服务状态；仍有问题可运行健康检查
openclaw status
openclaw doctor

Q：运行 openclaw 命令提示「无法加载 openclaw.ps1，因为在此系统上禁止运行脚本」？

这是 Windows 的执行策略限制：部分电脑默认禁止运行 PowerShell 脚本，而 npm 安装的 openclaw 命令正是以 .ps1 脚本形式提供的，因此被系统拦截。该问题与安装本身无关，执行下方命令允许运行本地脚本即可解决（仅对当前用户生效，无需管理员权限）：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

请以该命令为主，执行一次后长期有效：后续所有 openclaw 命令、网关启动以及开机自启（自启任务会在系统启动时新开 PowerShell 会话）都依赖此设置——OpenClaw 的网关启动脚本内部同样会调用 .ps1 脚本，即使通过 gateway.cmd 启动也会被策略拦截。

以下两种方式仅适用于当前会话或手动执行命令，不能覆盖网关启动与开机自启：① 直接输入 openclaw.cmd 运行（npm 同时生成了 cmd 版本命令，可绕过 npm 生成的 openclaw.ps1 拦截，适合手动执行 openclaw config、openclaw dashboard 等命令）；② 在当前窗口临时放行：Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process（窗口关闭即失效，重新打开后需再次执行）。