官方网站:http://openclaw.ai/ · 本站基于官网内容整理更适合新手的安装、部署与排障指南

FastOpenClaw OpenClaw 快速安装与部署指南

文档

GitHub 快速安装(FastOpenClaw)

从仓库到可运行实例的最短路径,含复制即用命令

继续查看

安装、排障和深入阅读最常用的入口都在这里。

官方与仓库入口

本站定位:基于官网,提供更快更易落地的中文部署教程。

0) 安装前检查

node --version
npm --version
git --version

建议:Node.js >= 22。

1) 一行安装(推荐)

curl -fsSL https://raw.githubusercontent.com/upgiorgio/FastOpenClaw/main/install.sh | bash

适合:首次体验、单机快速部署、演示环境。

2) 启动与状态检查

openclaw onboard --install-daemon
openclaw status
openclaw health

目标:Gateway: running 且 health 无阻塞错误。

3) 常用管理命令

openclaw models list
openclaw channels list
openclaw gateway restart
openclaw logs --tail 100

4) 常见失败与修复

A. openclaw: command not found

  1. 重新打开终端
  2. 再执行 npm i -g openclaw@latest
  3. 验证 openclaw --version

B. API 返回 401

  1. 确认填的是模型平台 API Key,不是云账号 AK/SK
  2. 确认模型名拼写正确
  3. 确认当前账号额度未耗尽

C. 机器人没有回复

  1. openclaw status 看网关是否运行
  2. 检查 Bot Token、allowed users
  3. 修改配置后执行 openclaw gateway restart

5) 下一步建议

  1. 三种安装方案对比
  2. 模型 API 双线路配置
  3. 机器人通道配置
  4. 生产环境上线清单