【FAQ】OpenClaw安装常见问题

安装OpenClaw过程中会有一些奇怪的问题，很多是因为网络，有一些则是因为你没有耐心等待，所以我在这里做一些自测安装过程中产生的问题。

openclaw目前版本是2G+的大小，所以安装的过程，大家需要自己进行网络情况查看，而且要有一定耐心

【非常重要】

初始化

shared/multi-user use requires lock-down. Continue?
请选择Yes，配置全局环境变量

# 选择No则如下
openclaw: command not found
是因为权限/路径没配置好
# 重新运行
curl -fsSL https://openclaw.ai/install.sh | bash
重新坐等安装完成

所有的询问： Y / Yes

【1】手动安装部分组件，防止自动安装无法完成

红框一至红框二输入两次openclaw --version后发现第二次已经显示版本信息，说明已经差不多安装完成，可能有卡住的情况，但并不影响我们启动。
下图是安装过程中，直接启动gateway，出现需要手动执行openclaw setup的情况，执行后发现可以启动openclaw。

访问页面

当时无法访问的，因此，就这个情况看来，还是需要等待官方的命令最终执行完成后，输出

✅ OpenClaw installed successfully!

【2】中断安装，重新执行安装命令

如果终端长时间无输出（超过 10 分钟）：按 Ctrl + C 中断，重新执行安装命令

curl -fsSL https://openclaw.ai/install.sh | bash

重新执行以上命令出现的情况

openclaw gateway

出现下图，说明正在重新安装（务必注意自己的网络的情况）

• 输入openclaw或openclaw --version检测是否安装完成
  

测试安装情况

这个是假象，因此最终是需要等待安装完成的。

【3】再次测试安装是否在进行

重新执行

openclaw gateway

【4】安装过程重启gateway

其实没有什么用，但需要知道这是无用功，至少不会被虚假安装欺骗，还是需要等待安装完成方可使用。

openclaw gateway start

【5】查看当前网络情况

sudo apt-get install -y nload
nload

【6】清理过期 / 残留配对状态（此处为飞书）——手动清理

如果之前的配对请求已过期，需手动清理缓存。

# 1. 停止网关服务
openclaw gateway stop

# 2. 删除本地配对缓存（强制重置）
rm -rf ~/.openclaw/credentials/feishu-pairing.json

# 3. 重启网关
openclaw gateway restart

【7】检查插件冲突（2026.x 版本高频问题）

该版本内置了飞书插件，若手动安装过旧版插件会导致重复加载，进而配对状态失效。

• 检查插件：

openclaw plugins list

• 清理重复插件：
  删除本地扩展目录：rm -rf ~/.openclaw/extensions/feishu
  重启网关：openclaw gateway restart

如何联系我

• 给我发邮件：code_captain@163.com，并说明来意；
• 评论区留言；