从n8n工作流、MCP到Manus、Skill,各类智能工具不断刷新着人机协作的边界,而OpenClaw的出现,更是掀起了一场全新的人机协作范式革命,有很多人已经将OpenClaw小龙虾应用到自媒体创作,比如创建微信公众号文章自动发布流,可以参考这篇文章:如何使用OpenClaw实现公众号创作,实现三步打造自动化创作发布流。如果你还不会部署,那就跟着优创社一起来看看吧!
这款被称作「私人贾维斯」的AI工具,能真正接管你的电脑,实现跨平台指令操控,堪称24小时在线的AI专属员工。今天这篇保姆级教程,就手把手教你完成OpenClaw的安装部署,以及一步API的适配配置,让它真正为我们的文章文案和视频创作带来实打实的用处。
一、OpenClaw是什么?到底强在哪?
简单来说,OpenClaw就是你的专属AI私人助理,支持Windows、macOS、Linux多系统运行,你可以通过Telegram、WhatsApp、飞书等常用聊天平台,像和好友聊天一样发送自然语言指令,就能让它帮你处理各类电脑事务:操作本地文件、查阅邮件、运行脚本代码、操控浏览器完成网页操作,甚至能边理解需求边编写代码,真正实现「一句话搞定电脑操作」。
这款工具的前身先后为Clawdbot、Moltbot,因命名相似、辨识度低等问题完成更名,最终定名为OpenClaw,凭借强大的功能和灵活的交互方式,在GitHub上收获了243k星标、47k分叉,成为当下最热门的开源AI助理工具之一。这里放上他的github地址:
https://github.com/openclaw/openclaw
这里给大家理清一个核心概念:把OpenClaw比作你的智能手机,Skill就是手机里的各类应用,而你发送的每一条指令,就是一次Prompt调用,三者配合,就能实现各类功能的灵活触发。
二、安装前置准备
在开始安装前,需先确认系统、环境和密钥准备到位,避免安装过程中出现报错,重点注意Windows系统的特殊要求:
- 系统要求:优先推荐macOS、Linux(Ubuntu/CentOS等主流发行版);Windows系统不支持直接安装,必须先配置WSL2(Windows Subsystem for Linux 2)环境
- 环境要求:本地需安装Node.js,版本要求≥22
- 密钥准备:获取一步API key,该API可适配国内外所有主流大模型,是OpenClaw实现模型调用的核心,自己可以网上去找,有很多~
三、OpenClaw安装步骤
整个安装过程分为终端命令安装、初始化配置、快速启动设置三个核心步骤,其中交互式设置和模型选择是关键,新手务必仔细看:
步骤1:终端执行安装命令
打开电脑终端(macOS/Linux直接打开终端,Windows打开WSL2终端),输入以下命令并回车,全局安装最新版OpenClaw:
npm install -g openclaw@latest
步骤2:运行初始化向导(核心步骤)
安装完成后,继续在终端输入初始化命令,该命令会自动安装守护进程,为后续运行提供支持:
openclaw onboard --install-daemon
回车后会进入交互式设置界面,按照后续指引完成配置即可。
步骤3:QuickStart快速启动配置(重点避坑)
这一步是模型调用的关键,切记不要选择默认配置,跟着以下步骤操作:
- 当终端提示「Model/auth provider」时,根据你在一步API开通的大模型,选择对应的厂商(示例以智谱GLM 4.7为例);
- 接下来会提示输入API Key,将从一步API复制的
sk-xxxxxx格式密钥粘贴进去,回车确认; - 后续依次出现「安装Skill的管理器」「安装Skill依赖」,均选择「Skip for now」;
- 当提示「是否连接Telegram/WhatsApp?」,新手建议输入「Skip for now」,先通过网页版完成基础使用,后续再配置社交平台连接。
配置完成后,终端会提示模型配置成功,默认模型将设置为你选择的大模型(如zai/glm-4.7)。
步骤4:两种交互方式,新手优先选网页版
OpenClaw提供浏览器控制界面(Control UI)和终端用户界面(TUI)两种交互方式,适配不同使用场景:
- 浏览器控制界面(推荐新手):配置完成后,终端会自动生成一个Web地址(示例:127.0.0.1:18789/chat?session=main),复制该地址在浏览器中打开,即可进入可视化操作界面,包含聊天、控制、技能、设置等功能模块,直接在聊天框发送指令即可使用;
- 终端用户界面(TUI):适合有终端使用习惯的用户,无需打开浏览器,直接在终端中完成指令发送、功能设置等操作。
四、配置文件修改
完成基础安装后,直接测试可能出现模型调用不通的问题,核心原因是需要修改配置文件,适配一步API中转站,实现国内外大模型的灵活调用,分为主配置文件修改和鉴权文件配置两步,以下以Windows系统为例(macOS/Linux路径可参考对应目录):
步骤1:修改主配置文件openclaw.json
- 打开文件路径:
C:\Users\Administrator\.openclaw\openclaw.json; - 先记住文件中
workspace的原始值(示例:"workspace": "C:\\Users\\Administrator\\clawd"),后续需保留; - 将文件中的
models和auth部分替换为以下内容,可根据自身需求修改想要调用的大模型(示例包含GPT-4o、Claude Sonnet 4.5、Gemini 3 Pro),务必保留原始workspace值:
{
"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 }
]
}
}
}
}
步骤2:配置鉴权文件auth-profiles.json
- 打开文件路径:
C:\Users\Administrator\.openclaw\agents\main\agent\auth-profiles.json; - 将从一步API获取的真实API Key,对应填入各模型的
key字段中,替换示例中的sk-your-unique-xxx-key-here:
{
"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"
}
}
步骤3:检查环境并启动Gateway服务
- 配置完成后,返回终端,输入以下命令检查OpenClaw运行环境,排查配置错误:
openclaw doctor
- 环境检查无误后,输入启动命令,开启Gateway服务,完成最终配置:
openclaw gateway
五、测试运行效果
完成以上所有步骤后,打开OpenClaw的浏览器控制界面,在聊天框中发送指令「我的模型是什么?」,若界面返回模型相关信息(如「我的模型是zai/glm-4.7 (GLM-4.7,由zai提供)」),则说明OpenClaw安装和一步API配置全部完成,此时你就可以发送各类指令,随意玩起来了。
至此,这款能24小时为你处理电脑事务的OpenClaw就正式上手了,你可以拿他去给你一站式创作微信公众号文章、小红书种草文案、抖音解说文案及视频素材、配音等等,如果你还不会就赶紧去试试吧!
微信扫一扫
支付宝扫一扫