【保姆级教程】手把手教你安装 OpenClaw并配置使用一步API

从 n8n 工作流、MCP、Manus，到 Skill，再到如今的 OpenClaw，AI 时代的迭代速度早已超出想象。

OpenClaw 究竟有多强？想象一个场景：你在外聚会、休闲，只需在日常聊天软件里发几句指令，就有一位 24 小时在线的 AI 员工，随时随地为你处理事务。它能真正接管你的电脑：操作文件、查阅邮件、运行脚本、操控浏览器、边理解边写代码…… 这不是简单的功能叠加，而是一次彻底的人机协作范式革命。

OpenClaw 🦞 是什么？

简单来说，OpenClaw 就是你的贾维斯。你可以通过 Telegram、WhatsApp、飞书等聊天平台，像跟微信好友聊天一样，让 AI 帮你干活。

Github 地址： https://github.com/openclaw/openclaw

历史名称

相关概念区别

OpenClaw 就是你的手机，Skill 是里面的一个应用，而 Prompt 就是你发的一次指令。

安装 OpenClaw 🦞

一、前置准备

• 系统： 推荐 macOS、Linux（Ubuntu/CentOS 等），Windows 必须使用 WSL2（Windows Subsystem for Linux 2）
• 环境： Node.js ≥ 22

• 大模型 Key： 一步 API key，适配所有国内/国外大模型，地址直达：https://yibuapi.com/
  

二、安装步骤

1. 安装 OpenClaw

打开终端，运行如下安装命令：

npm install -g openclaw@latest

2. 运行初始化向导（关键步骤！）

openclaw onboard --install-daemon

你会进入交互式设置界面，请按以下指引操作。

3. QuickStart（重要步骤）

3.1 选择模型（重点！不要选默认！）

当提示 "Model/auth provider" 时，根据你开通的大模型，选择对应的厂商。

3.2 输入 API Key

粘贴你之前复制的 sk-xxxxxx，回车。

3.3 其他选项

• 安装 Skill 的管理器 → npm 安装 Skill 的依赖 → Skip for now
• 是否连接 Telegram/WhatsApp？ → 输入 Skip for now（新手先用网页版）

详细步骤如图所示，以智谱的 GLM 4.7 为例：

4. 交互方式

OpenClaw 提供两种交互方式：

4.1 浏览器控制界面（Control UI）

系统会在终端显示一个 Web 地址，打开后可以在浏览器中控制 OpenClaw。

4.2 终端用户界面（TUI）

终端界面直接展示聊天与设置。

三、修改主配置文件

此时测试可能不通，需要修改主配置文件。

步骤一： 打开路径：C:\Users\Administrator\.openclaw\openclaw.json，记住原配置文件中 workspace 的值，例如：

"workspace": "C:\\Users\\Administrator\\clawd"

步骤二： 将 models 和 auth 部分修改为以下内容（可自行修改想用的大模型），以支持一步API中转站：

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://yibuapi.com/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://yibuapi.com",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://yibuapi.com/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

步骤三： 配置鉴权文件

打开路径：C:\Users\Administrator\.openclaw\agents\main\agent\auth-profiles.json

在此处填入你从中转站获取的真实 API Key：

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-your-unique-gpt-key-here"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-your-unique-claude-key-here"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-your-unique-google-key-here"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

步骤四： 检查并启动

openclaw doctor

步骤五： 启动 Gateway 服务

openclaw gateway

四、测试效果

至此，OpenClaw 安装大功告成。