安装nodejs
安装官方推荐的NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
代替重启shell
\. "$HOME/.nvm/nvm.sh"
下载并安装 Node.js
nvm install 24
推荐一定要装偶数版本的,比如24,22,20
验证 Node.js 版本
node -v
验证 npm 版本
npm -v
安装openclaw
安装cli
curl -fsSL https://openclaw.ai/install.sh | bash
运行引导程序(并安装服务)
openclaw onboard --install-daemon
步骤 1:安全确认

方向键←,选yes回车
步骤2:选择模式

推荐直接回车,后面可以自己修改
步骤 3:选择 AI 后端和认证方式

这里选择智谱的API KEY方式

我选择4.7-flash 因为免费 = =!
步骤4:选择消息平台

这里我就跳过了,我没打算配置消息平台,因为后面我想接入QQ之类的
步骤5:完成配置

远程浏览器访问
本机
如果是本机127.0.0.1访问的话,那可直接跳到配对环节
远程访问
如果各位想远程访问,需要配置网关,这里推荐不要随便改动,直接安装一个nginx,将80/443反向代理到web端口
配置ssl
openclaw主页要求https才能使用大部分功能,各位可以自行在nginx中配置域名的ssl,或者直接在服务器自签名一个ip证书,测试不被信任的证书也可以
配对
配置远程访问后主页会提示disconnected (1008): pairing required
这是要求咱们必须进行设备配对
在服务器中执行:
openclaw devices list

会看到一个新的配对请求(一定要浏览器先访问,否则不会有配对请求)
执行命令批准:
openclaw devices approve <requestId>
此时即可使用openclaw的对话功能

部分疑难杂症解决方案
disconnected (1008): unauthorized: gateway token missing
方案1 在UI中手动配置令牌(推荐)
- 获取令牌
在终端执行以下命令,获取网关令牌:
openclaw config get gateway.auth.token
或者直接查看配置文件:
grep -A1 '"token"' ~/.openclaw/openclaw.json
2.在UI中粘贴令牌
- 打开左侧菜单,进入 Control -> Overview 页面
- 找到 Gateway Access Panel(网关访问面板)区域。
- 将上一步获取的令牌粘贴到对应的输入框中,保存设置。
- 刷新页面,连接应该会恢复正常。
方案2 使用带令牌的URL直接访问
在终端执行以下命令,它会自动生成并打开一个包含认证令牌的URL:
openclaw dashboard
这个URL会自动完成认证,无需手动输入令牌。
评论 (0)