本文依据2026-11-11核对的官方英文仓库文档整理,未做本地安装实测;命令与界面以对应版本为准。下面以 Linux/macOS 的终端安装路线为例,依次完成安装、配置模型、启动 Gateway 和检查首次对话。

安装前准备什么

先准备终端、可访问的官方安装来源,以及一个可用的模型服务账号。模型服务需要的登录或 API 凭证,应在自己的环境中填写,不出现在公开截图和配置示例里。

检查当前 Node.js 版本:

node --version

将输出与自己准备安装的 OpenClaw 版本要求对照。不同版本、本地化页面可能存在更新时差,因此这里不把某个 Node.js 最低版本写成所有安装方式都通用的要求;具体版本以对应官方文档为准。如果系统还没有 Node.js,先按官方环境准备说明完成安装,再继续。

第一次验证只需要一个模型和一个聊天入口,不必同时配置飞书、Skills 与定时任务。先准备一段公开或虚构文本,后面用来判断回复是否正确。

第一步:安装 OpenClaw 终端命令

官方英文入门文档给出的 Linux/macOS 安装命令为:

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

它会下载并执行安装脚本。可以先打开这个官方链接阅读脚本,再决定执行;遇到失败时保留错误内容,不通过修改未知镜像地址来反复尝试。

安装后按引导配置模型访问。界面选项可能随版本变化,重点是确认所选服务商、可用凭证和模型配置符合自己的账号。不要把网页聊天订阅与 API 凭证默认视为同一种接入方式。

第二步:确认 Gateway 是否已经运行

执行:

openclaw gateway status

预期结果:能检查 Gateway 的运行状态。官方入门文档以监听 18789 端口作为默认流程中的检查点;如果你修改过配置,应检查自己实际设置的地址和端口。

如果安装引导已经配置好后台服务,不必重复安装。需要按官方流程安装并启动服务时,执行:

openclaw gateway install
openclaw gateway start

然后再次运行 openclaw gateway status。把“命令执行结束”和“服务已经能够响应”分开检查,不只看安装器最后一行文字。

若当前仍有手动启动的前台 Gateway,先按该运行方式结束前台进程,再安装服务,避免自己同时混用两套启动方式。本文不提供共享主机上停止其他用户进程的操作。

第三步:打开控制界面

执行:

openclaw dashboard

预期结果:浏览器打开 Control UI。页面能加载,说明这一入口可以访问;它并不单独证明模型调用已经成功。

如果页面打不开,先回到 Gateway 状态检查。若页面能打开但消息没有回复,应继续核对模型配置和请求错误,而不是直接把问题归为安装失败。

第四步:完成一个有验收标准的任务

在控制界面中输入下面的虚构文本:

只根据以下内容整理行动清单。
输出字段:行动、负责人、截止时间。
没有明确的信息写“待确认”。

小林负责整理公开产品资料,周五前完成。
小周负责检查参考链接,没有确定截止时间。

预期结果示意,不是本站实际运行记录:

行动 负责人 截止时间
整理公开产品资料 小林 周五前
检查参考链接 小周 待确认

检查回复是否有原文依据,是否把缺失日期编造成具体时间。再删除一条记录中的负责人,重做一次,确认它明确写出“待确认”。这样既检查了消息往返,也检查了任务结果。

失败时先收集这些信息

官方排错文档提供以下检查命令:

openclaw status
openclaw gateway status
openclaw doctor

需要持续观察时,在单独的终端运行:

openclaw logs --follow

典型场景是控制界面已经打开,却一直没有模型回复。此时记录发出消息的时间,对照日志定位失败位置,再按 模型接入教程 检查服务商与凭证。每次只调整一个已确认的问题,随后重新发送一条简短消息验证。

最终完成标准是:Gateway 状态可检查、控制界面可访问、消息能够返回、测试文本中的缺失信息没有被补造。满足这些后,再逐项增加渠道和 Skills。

继续阅读

参考资料与核对日期

资料核对:2026-11-11。以下为对应的官方文档入口;本文为文档整理,未作本地安装实测。