OpenClaw（大龙虾） 系列教程
安装教程

• OpenClaw 云服务器/虚拟机部署安装教程+常见报错与解决方案（2026最新版，保姆级教程）
• OpenClaw 云服务器30秒快速部署（无需远程连接）
• OpenClaw（大龙虾）新手摸透这几个命令，就能解决90%的日常使用问题（干货满满）

---

OpenClaw 接入QQ-Bot + Feishu（飞书）

• OpenClaw 接入QQ-Bot + 接入Feishu（飞书）

---

OpenClaw 切换大模型

• Ubuntu 系统安装 Ollama 教程
• 正在写…

---

OpenClaw 目录详解

• OpenClaw 目录结构详细介绍（出自阿程）
• ~/.openclaw — OpenClaw 的“家目录（出自阿程）“

---

常见报错与解决方案

• OpenClaw 常见报错与解决方案

一、常用指令

1. 启动安装向导（安装网关服务）。 彻底重置全量配置，安装配置出错、想换模型或聊天渠道，输入后可重新走完整初始化流程。一般第一次运行时带 --install-daemon 参数， 安装网关服务，让 openclaw 可以在后台运行，即使你关闭了前台窗口， openclaw 依旧正常运行。

   openclaw onboard --install-daemon
   

   

2. 启动安装向导。 网关服务安装过了，就不需要再次安装了，省略参数，直接启动安装向导。

   openclaw onboard
   

3. 在前台启动 openclaw 。适用于临时调试， 关闭当前窗口，openclaw 立即关闭。 如果 openclaw 已经在后台运行，将会报错。

   openclaw gateway
   

4. 关闭服务。 关闭 openclaw 的后台服务。

   openclaw gateway stop
   

5. 安装服务。 如果想让 openclaw 以后台的形式运行（ 日常推荐后台常驻 ），执行以下指令：

   openclaw gateway install
   

6. 启动服务。 已经安装了 openclaw 的服务（可以在后台运行），使用以下指令启动 openclaw。

   openclaw gateway start
   

7. 重启OpenClaw。 在修改了大模型/修改channels/修改api-key 之后，需要重启网关服务，配置才能生效。

   openclaw gateway restart
   

8. 查看网关状态。 故障排查第一步，网页打不开、发消息没反应就输它，看Gateway项，显示unreachable就是网关没运行，看不懂的报错直接复制给AI解读。

   openclaw status
   

9. 打开仪表盘（并启动浏览器）。 适用于 Windows/有图形化界面的系统中，一键打开控制面板，不用记带token的复杂地址，输入后自动获取有效地址，直接唤起浏览器打开。

   openclaw dashboard
   

10. 打开仪表盘（云服务器）。 在一般使用的云服务器都是没有图形化界面的，加上参数 --no-open ， 不打开浏览器。

    openclaw dashboard --no-open
    

11. 更新。 一键更新软件，项目更新频率高，定期执行自动升最新版、修bug补漏洞，更完自动重启服务。

    openclaw update
    

12. 查看日志。 核心排错命令，AI不回复、报401等错误必用，实时滚动看日志，红字就是错误，能快速定位API Key无效、认证失败问题，注意部分模型的API调用Key和订阅Key是分开的，别填错。

    openclaw logs --follow
    

13. 查看帮助文档。 如果有不懂的指令，直接在指令后面加上 -h/--help 即可查询。

    openclaw dashboard --help
    

    

二、配置指令（model, channels, skills 等）

1. 轻量改单项配置，不用全量重置，换模型、对接飞书/微信等渠道，输入后进菜单单独调整即可。

   openclaw config
   

   

End

你好，少年，未来可期~