v2.1.0 · 最近更新时间:2026年3月13日

OpenClaw 安装
从未如此简单

AI 实时诊断安装报错,分步引导完成部署。
无论你是新手还是开发者,3分钟完成安装。

🪟
Windows
Win 10 / 11
🍎
macOS
12+ Monterey
🐧
Linux
Ubuntu / Debian
安装指南
选择安装方式

一键安装脚本为你自动处理所有步骤,或者选择手动安装来深入控制每一步。

1
在 Oasis API 网站注册登录

访问以下链接进行注册和登录:

2
创建 API 令牌(Token)

登录后,在账户设置或API管理页面创建新的API令牌。复制并安全保存生成的令牌密钥。

3
在模型广场挑选一个模型

浏览模型广场,选择适合您需求的AI模型。记下模型的名称或ID,稍后在OpenClaw配置时需要用到。

4
OpenClaw 配置时

运行 openclaw onboard 或相关配置命令时,按照以下步骤操作:

  1. Q: I understand this is personal-by-default ..., continue?
    → 选 Yes
  2. Q: Model/auth provider
    → 选 Custom Provider
  3. Q: API Base URL
    → 国际版填:https://chatbot.unreachablecity.club/v1
    → 国内版填:https://chatbot.cn.unreachablecity.club/v1
  4. Q: How do you want to provide this API key?
    → 选 Paste API key now
  5. Q: API Key
    → 填刚刚创建的 API 令牌密钥
  6. Q: Endpoint compatibility
    → 选 OpenAI-compatible
  7. Q: Model ID
    → 复制模型广场挑选的模型名称
  8. 等待 Verification successful 后
  9. Q: Endpoint ID
    → 默认,直接回车
  10. Q: Model alias(optional)
    → 默认,直接回车
其他配置与常规 OpenClaw 配置无异。
一键安装脚本
自动检测环境、安装依赖、配置一切。适合快速上手。
推荐首选 →
🔧
手动安装
逐步执行命令,了解每个安装环节。适合学习与自定义。
进阶用户 →
一键安装脚本
自动检测环境、安装依赖、完成配置。无需手动操作每个步骤。
AI 报错诊断
提交报错,AI 自动分析

粘贴终端错误信息,选择当前安装步骤,AI 给出具体修复方案。

📁
点击上传日志文件或截图
.log .txt .png .jpg 均支持
🧠 AI 诊断结果
🔎
提交报错信息后,
AI 将在这里给出诊断报告
常见问题
快速解答

收录最常见的安装问题,点击展开查看解决方案。

安装 OpenClaw 需要什么系统要求?
OpenClaw 需要 Node.js 22 或更高版本。Windows 需要 Win 10 (1903) 或以上,macOS 需要 12 + ,Linux 推荐 Ubuntu 20.04+。内存建议 2GB 以上,磁盘空间需要至少 500MB。
提示 "EACCES permission denied" 怎么办?
这是权限问题。macOS/Linux 用户请在命令前加 sudo,或配置 npm 使用用户目录:运行 npm config set prefix ~/.npm-global,然后将 ~/.npm-global/bin 添加到 PATH。Windows 用户请以管理员身份运行在powershell终端。
npm install 卡住了没有反应?
可能是网络问题。尝试切换 npm 镜像源:npm config set registry https://registry.npmmirror.com,然后重新运行安装命令。如果仍然卡住,可以尝试清除缓存:npm cache clean --force
如何验证 OpenClaw 是否安装成功?
在终端运行 openclaw --version,如果看到版本号(如 openclaw/2.1.0)则说明安装成功。也可以运行 openclaw doctor 进行完整的环境检查。
API Key 在哪里获取?
登录 OpenClaw 官网,进入控制台 → API Keys → 创建新的 Key。免费账户提供每月 1,000 次调用额度。企业账户可联系我们获取更高配额。请妥善保管 API Key,不要提交到公共代码仓库。
可以同时在多台机器上安装吗?
是的,同一个账号可以在多台设备上安装使用。API Key 可以在多台机器上共享,但调用额度是共享的。如果需要独立配额,可以为不同机器创建不同的 API Key。