本文依据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。
继续阅读
- OpenClaw 模型接入教程:以 DeepSeek 配置与验证为例
- Hermes Agent 入门教程:安装、模型配置与第一个任务
- OpenClaw Skill 编写教程:完整 SKILL.md 示例与加载验证
参考资料与核对日期
资料核对:2026-11-11。以下为对应的官方文档入口;本文为文档整理,未作本地安装实测。