跳到主要内容

OpenClaw 安装配置指南

前置准备​

检查 Node.js 环境​

打开命令提示符或 PowerShell，运行以下命令验证安装：

node --version
npm --version

未安装的请参考 Node.js 安装指南 完成安装。

安装 OpenClaw​

macOS / Linux​

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）​

iwr -useb https://openclaw.ai/install.ps1 | iex

运行入职向导​

安装完成后，运行以下命令启动入职向导：

openclaw onboard --install-daemon

向导共 14 步，按提示依次填写：

  1. I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? — yes 001
  2. Onboarding mode — QuickStart 002
  3. Model/auth provider — Custom Provider 003
  4. API Base URL — 填写请求地址（见下方说明） 004
  5. How do you want to provide this API key? — Paste API key now 005
  6. API Key — 填写官网控制台创建的 key 006
  • 填写sk-开头的密钥 007
  1. Endpoint compatibility — Claude 选 Anthropic，Codex 选 OpenAI
  2. 填写模型 id — 在官网模型广场查看可用模型，如 claude-opus-4-6、gpt-5.2 008
  3. Endpoint ID — 按你喜欢的名称随意填写
  4. Model alias — 不用管，直接跳过
  5. Select channel — Skip for now 009
  6. Configure skills now? — no
  7. Enable hooks? — 空格全选 010
  8. How do you want to hatch your bot? — Open the Web UI
请求地址说明
  • 首选（推荐）： https://bytecat.lamclod.cn — CDN 加速，建议直连使用
  • 备选地址 1： https://codecdn.bytecatcode.org — 国内可直连
  • 备选地址 2： https://www.bytecatcode.org — 优选CF，可直连，也可挂代理访问
  • 备选地址 3： https://code.bytecatcode.org — 需挂代理访问

注意： 如果使用 Codex，需要加上 /v1 后缀，例如：https://bytecat.lamclod.cn/v1

常见问题​

配置出错怎么办？

运行以下命令重置，然后重新开始向导：

openclaw reset

如何修改已有配置？

安装 CC-Switch（v3.11.1 以上版本），通过可视化界面修改 API 配置，无需手动编辑配置文件。

浏览器访问 Dashboard

openclaw dashboard

访问返回的地址即可进入webui

遇到 403 Your request was blocked

在供应商配置中添加 headers 字段：

"headers": {
  "User-Agent": "claude-cli/2.0.76 (external, cli)",
}

openclaw高阶文档