1. 安装 Node.js
先装 Node.js LTS 版。
安装完成后,在终端检查:
node -v
npm -v
2. 安装 OpenClaw
执行:
npm install -g openclaw
安装后检查:
openclaw --help
3. 查看是否安装成功
执行:
openclaw status
如果能看到状态信息,说明 CLI 已可用。
4. 启动 Gateway
执行:
openclaw gateway start
再检查:
openclaw gateway status
5. 打开控制台
浏览器访问:
http://127.0.0.1:18789/
如果提示未授权,执行:
openclaw dashboard
它会给你正确的访问链接。
6. 模型配置
OpenClaw 本身是代理框架,真正回答问题的是你接入的模型。
所以装完后,模型配置是重点。
方式一:在聊天里直接切模型
进入会话后可用:
/model
/model list
/model 具体模型名
比如:
/model gpt-5.4
方式二:在配置里设置默认模型
如果你想固定默认模型,就在 OpenClaw 配置里设置。
常见思路是:
- 配好模型提供商 API Key
- 设默认模型
- 重启 Gateway 生效
配置完成后再执行:
openclaw gateway restart
7. 模型配置时要准备什么
通常需要这几项:
- API Key
- 模型名称
- 提供商接口地址(如果是自定义中转/兼容接口)
- 默认模型(可选)
8. 常用命令
openclaw status
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status
openclaw dashboard
聊天里常用:
/model
/status
/new
9. 常见问题
Q1:openclaw 不是命令
- 终端重开一次
- 检查 npm 全局安装路径是否进了 PATH
Q2:网页打不开
先执行:
openclaw gateway status
Q3:网页显示未授权
执行:
openclaw dashboard
Q4:能进界面但不能聊天
优先检查:
- 模型 API Key
- 默认模型名
- 提供商接口地址是否填对
10. 最短使用流程
npm install -g openclaw
openclaw gateway start
openclaw dashboard
然后:
- 进控制台
- 配模型
- 开始用
夜雨聆风