OpenClaw 超详细安装教程|用一步API,手把手打造专属AI员工

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

OpenClaw 究竟有多强？想象一个场景：你在外聚会、休闲，只需在日常聊天软件里发几句指令，就有一位 24 小时在线的 AI 员工，随时随地为你处理事务。

它能真正接管你的电脑：操作文件、查阅邮件、运行脚本、操控浏览器、边理解边写代码…… 这不是简单的功能叠加，而是一次彻底的人机协作范式革命。

今天就给大家带来超详细的 OpenClaw 安装教程，全程手把手，新手也能轻松上手 ✅

🦞 OpenClaw 是什么？

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

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

一、历史名称小科普

OpenClaw 并非一开始就叫这个名字，中间经历过两次更名，大家了解即可：

阶段	名称	更名原因
初期	Clawdbot	与 Claude 名称过于相似，被迫更名
中期	Moltbot	名称不够清晰，容易产生混淆
最终	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 核心程序

打开电脑终端（macOS/Linux 直接打开终端，Windows 打开 WSL2 终端），复制以下命令，回车运行：

bashnpm install -g openclaw@latest

等待安装完成，期间不要关闭终端。

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

安装完成后，继续在终端输入以下命令，启动初始化向导：

bashopenclaw onboard --install-daemon

回车后会进入交互式设置界面，按下面的指引一步步操作即可，不用自己瞎摸索～

3. QuickStart 配置（重点中的重点！）

这一步直接决定后续能否正常使用，一定要仔细看！

3.1选择模型（别选默认！）

当终端提示 "Model/auth provider" 时，根据你开通的大模型，选择对应的厂商（比如智谱、OpenAI等），不要直接按回车选默认！

3.2输入 API Key

粘贴你之前从一步 API 中转站获取的 `sk-xxxxxx` 密钥，粘贴完成后回车即可。

3.3其他选项（新手必看）

•安装 Skill 的管理器 → npm 安装 Skill 的依赖 → 输入Skip for now（先不安装，后续需要再配置）。

•是否连接 Telegram/WhatsApp？ → 输入Skip for now（新手先使用网页版，更简单）。

4. 两种交互方式（新手推荐第一种）

配置完成后，OpenClaw 会提供两种交互方式，大家根据自己的习惯选择即可：

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

终端会自动生成一个 Web 地址，复制地址在浏览器中打开，就能在网页上直接控制 OpenClaw，操作更直观，新手首选。

4.2终端用户界面（TUI）

直接在终端界面展示聊天与设置，适合熟悉终端操作的用户。

三、修改主配置文件（解决连接失败问题）

很多新手到这一步会遇到测试不通的情况，核心原因是配置文件未修改，按下面步骤操作即可解决：

步骤一：找到配置文件路径

打开路径：C:\Users\Administrator\.openclaw\openclaw.json（Windows 路径，macOS/Linux 路径类似，可自行查找），先记住原配置文件中 `workspace` 的值（比如："C:\\Users\\Administrator\\clawd"），后续要用到。

步骤二：修改 models 和 auth 部分

将配置文件中的 `models` 和 `auth` 部分，替换为以下内容（可根据自己的需求，修改想要使用的大模型），适配一步 API 中转站：

json{"agents": {"defaults": {"workspace": "C:\\Users\\Administrator\\clawd", // 这里替换成你刚才记住的 workspace 值"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 }]}}} }

步骤三：配置鉴权文件（填入 API Key）

打开路径：C:\Users\Administrator\.openclaw\agents\main\agent\auth-profiles.json，在此处填入你从中转站获取的真实 API Key，替换下面的占位内容：

json{"version": 1,"profiles": {"api-proxy-gpt:default": {"type": "api_key","provider": "api-proxy-gpt","key": "sk-your-unique-gpt-key-here" // 替换为你的 GPT 对应 API Key},"api-proxy-claude:default": {"type": "api_key","provider": "api-proxy-claude","key": "sk-your-unique-claude-key-here" // 替换为你的 Claude 对应 API Key},"api-proxy-google:default": {"type": "api_key","provider": "api-proxy-google","key": "sk-your-unique-google-key-here" // 替换为你的 Gemini 对应 API Key}},"lastGood": {"api-proxy-gpt": "api-proxy-gpt:default","api-proxy-claude": "api-proxy-claude:default","api-proxy-google": "api-proxy-google:default"} }

步骤四：检查并启动服务

1. 先在终端运行以下命令，检查配置是否正确：

powershellopenclaw doctor

2. 检查无报错后，启动 Gateway 服务：

powershellopenclaw gateway

四、测试效果

启动服务后，打开浏览器控制界面，发送指令测试是否能正常响应，比如让 AI 帮你新建一个文件、查询天气等。

到这里，OpenClaw 就安装完成啦！🎉

💡 新手常见问题提醒

•如果安装时提示 Node.js 版本过低，先升级 Node.js 到 22 及以上版本。

•配置文件修改后，一定要保存，否则修改无效。

•如果启动服务报错，大概率是 API Key 填写错误，重新检查鉴权文件中的 Key 是否正确。

按照教程一步步操作，基本不会踩坑～安装完成后，就可以解锁 AI 帮你干活的快乐啦！