资料核对日期:2026-11-16。本文适用于 OpenClaw,未做本地安装实测。以下采用交互式首次配置这一条最小路线,不展开 Ollama、WhatsApp 或其他可选渠道。

准备条件

开始前确认运行环境满足官方要求:Node.js 为 24.16.0 以上的 24.x,或 26.1.0 以上;官方推荐 Node 26,并提示安全修复版本应使用 24.22.1+/26.12.1+。先检查版本:

node --version

模型访问还需要现有 Claude Code 或 Codex CLI 登录,或者模型提供商签发的真实 API key。示例占位符不能作为实际凭据,也不要把密钥写入本文命令。具体提供商、模型 ID 和认证方式需按你的账号确定;尚未确定时记为“待确认”。

运行首次配置向导

执行:

openclaw onboard

需要逐项确认模型和工作区时选择 Custom setup;已有可用 AI 访问并接受自动发现时可选择 Quick start。向导会尝试复用检测到的登录或 API key;没有可用路线时会进入手动提供商设置。输入真实有效的认证信息,并选择当前账号实际可用的模型,不要仅填写模型名称而跳过认证。

工作区采用配置字段 agents.defaults.workspace。本路线将其设为 ~/.openclaw/workspace;如果当前向导没有显示该字段,具体交互入口待确认,可在完成后运行以下只读命令核对保存值:

openclaw config get agents.defaults.workspace

命令返回路径只表示配置可读取,不代表目录权限、模型调用或会话运行已经正常。需要重新进入配置向导时使用:

openclaw configure

启动 Gateway 并打开本机入口

如果首次向导已接受后台运行选项,无需重复安装服务。否则,若当前终端仍在运行前台 Gateway,先按 Ctrl+C 停止它,再安装并启动后台服务;避免让前台进程与服务争用同一运行环境:

openclaw gateway install
openclaw gateway start

随后检查状态:

openclaw gateway status

预期看到 Gateway 正在监听 18789 端口。再打开本机 Dashboard:

openclaw dashboard

该命令会在浏览器中打开 Control UI。这里的访问入口是本机 Dashboard,不需要先配置聊天渠道或公网入口。

成功验收

首先确认 Dashboard 能加载;然后在 Control UI 聊天中发送一条普通消息,预期获得 AI 回复。模型认证可另外检查:

openclaw models status

完整验收应同时满足:工作区路径符合预期、Gateway 状态正常、Dashboard 可打开,并且真实消息能够得到模型回复。仅看到配置值或模型条目不足以证明调用成功。

失败检查:Dashboard 打开但没有回复

先运行 openclaw models status,检查是否缺少或过期的模型凭据。若显示没有凭据,重新运行 openclaw onboard,进入手动提供商设置并提交真实 API key,或使用主机上已有的受支持登录。

如果 Gateway 也无法启动,再运行:

openclaw doctor

该命令用于查看具体配置问题。需要应用配置修复时,再按诊断结果考虑 openclaw doctor --fix。它还可能迁移旧配置键或恢复已知可用配置,会写入配置,不能把它当作纯只读校验;操作前先备份并核对修复建议。仍无法定位时可运行官方只读诊断入口 openclaw triage。

官方参考资料

继续阅读