保姆级OpenClaw安装配置完整指南

作者： 智源笔记
发布时间： 2026-03-27 08:53
官方文档： https://docs.openclaw.ai

---

📖 目录

1. OpenClaw 是什么？
2. 能配置哪些大模型？
3. 安装前准备
4. macOS/Linux安装
5. Windows 安装
6. 首次配置
7. 模型配置
8. 费用对比
9. 常见问题
10. 技能介绍

---

01 · OpenClaw 是什么？

OpenClaw 是一个 AI 智能助手运行平台，一个永不休息的 AI 秘书，帮你在电脑上完成各种任务。

能做什么？

• 💬 聊天对话 — 回答问题，写文章、翻译、编程
• 🌐 联网搜索 — 查资料、读网页、总结内容
• 🤖 执行任务 — 操作电脑，写代码、发消息
• ⏰ 定时提醒 — 设置定时任务，主动推送通知
• 📱 接入平台 — 微信、Telegram、Discord 等
• 🧩 安装技能 — 像装 App 一样扩展 AI 能力（50+ 技能）

核心概念

关键词	说明
Gateway	后台服务，像服务器一样持续运行
Agent	AI 助理本身，可配置不同角色
Skill	技能包，像手机 App
Model	AI 大脑，不同模型擅长不同领域
Channel	聊天通道（网页/微信/Telegram）

OpenClaw vs 普通 AI

对比项	普通 AI	OpenClaw
运行方式	在别人服务器	在自己电脑/服务器
数据安全	数据上传第三方	数据留在本地
定制能力	只能对话	可装技能、接平台
接入微信	❌ 不支持	✅ 支持
定时任务	❌ 不支持	✅ 支持
费用	固定月费	用多少付多少

---

02 · 能配置哪些大模型？

OpenClaw 支持配置多个模型提供商：

品牌	代表模型	费用	推荐度
MiniMax	MiniMax-M2.7	0.3 元/M	⭐⭐⭐⭐⭐
DeepSeek	DeepSeek V3/R1	1-16 元/M	⭐⭐⭐⭐⭐
Claude	Claude Opus 4.6	110-550 元/M	⭐⭐⭐⭐⭐
GPT	GPT-4.5/4o	75-300 元/M	⭐⭐⭐⭐
Kimi	Kimi K2.5	12 元/M	⭐⭐⭐⭐
Qwen	Qwen Coder	每天 2000 次免费	⭐⭐⭐
Groq	Llama 3.3	有限免费	⭐⭐⭐⭐
Ollama	本地部署	完全免费	⭐⭐⭐

什么是 Provider？
Provider = 模型提供商（OpenAI、Anthropic、DeepSeek 等）。需要去对应官网申请 API Key 才能使用。

---

03 · 安装前准备

需要准备什么？

• ✅ 一台电脑（macOS / Windows / Linux 都可以）
• ✅ 网络连接
• ✅ 一个模型 API Key

申请 MiniMax API Key（新手推荐）

步骤 1： 打开 MiniMax 开放平台

浏览器访问：https://platform.minimaxi.com，注册并登录。

步骤 2： 进入「开发者中心」→「API Key」

左侧菜单找「开发者中心」→「API Key」→「创建新的 API Key」。

步骤 3： 复制并保存 API Key

创建后显示 sk-xxxxxxxx 格式密钥，立即复制保存，关闭页面后无法再次查看！

⚠️ 安全提醒
API Key = 会员卡密码，不要告诉任何人。泄露后立即删除并重新生成。

其他 API Key 申请地址

模型	申请地址	新用户优惠
OpenAI（GPT）	platform.openai.com	$5 免费额度
Anthropic（Claude）	console.anthropic.com	$5 免费额度
DeepSeek	platform.deepseek.com	110 元免费额度
Moonshot（Kimi）	platform.moonshot.cn	10 元免费额度
Groq	console.groq.com	免费额度

---

04 · macOS/Linux 安装

方法一：一键安装（推荐）

# macOS / Linux / WSL2 通用安装命令
curl -fsSL https://openclaw.ai/install.sh | bash

如何打开终端？

• macOS：按 Command + 空格 → 搜索「终端」
• Linux：按 Ctrl + Alt + T
• Windows WSL2：在 PowerShell 输入 wsl 回车

方法二：npm 安装（已有 Node.js）

# 如果你已经有 Node.js（建议 v22 或 v24）
npm install -g openclaw@latest

# 安装完成后运行配置向导
openclaw onboard --install-daemon

验证安装成功

# 检查版本，看到版本号即安装成功
openclaw --version
# 输出类似：OpenClaw 2026.3.23-2

---

05 · Windows 安装

方法一：PowerShell 一键安装

# 打开 PowerShell（右键开始菜单 - Windows PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex

方法二：npm 安装

# 先确保已安装 Node.js（v22 或 v24）
npm install -g openclaw@latest
openclaw onboard --install-daemon

打开控制台

安装完成后，浏览器打开：http://localhost:18789

---

06 · 首次配置向导

运行配置向导

# 在终端输入这条命令，一步一步回答问题
openclaw onboard

向导步骤

1. 选择认证方式

选择你申请了 API Key 的 Provider。例如 MiniMax，就选 minimax-api-key。

2. 输入 API Key

粘贴复制的 sk-xxxxxxxx 格式密钥。

3. 选择默认模型

输入模型名称，例如：minimax/MiniMax-M2.7

4. 完成！

看到 Configuration saved! 即配置成功。

非交互式配置（跳过向导）

# 跳过向导，一条命令完成配置
openclaw onboard --auth-choice minimax-api-key --minimax-api-key "你的 API Key" --model minimax/MiniMax-M2.7

---

07 · 配置大模型

配置文件位置

~/.openclaw/openclaw.json

这是 OpenClaw 的主配置文件，修改后需要重启 Gateway 生效：

# 重启 Gateway（修改配置后必须执行）
openclaw gateway restart

完整配置示例（MiniMax）

{
  "env": { "MINIMAX_API_KEY": "sk-xxxxxxxxxxxxxxxx" },
  "agents": { "defaults": { "model": { "primary": "minimax/MiniMax-M2.7" }}}}
}

配置 Anthropic Claude

{
  "env": { "ANTHROPIC_API_KEY": "sk-ant-xxxxxxxx" },
  "agents": { "defaults": { "model": { "primary": "anthropic/claude-opus-4-6" }}}}
}

配置 DeepSeek（性价比最高）

{
  "env": { "DEEPSEEK_API_KEY": "sk-xxxxxxxxxxxxxxxx" },
  "agents": { "defaults": { "model": { "primary": "deepseek/deepseek-chat" }}}}
}

配置多个模型（主备切换）

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxx",
    "MINIMAX_API_KEY": "sk-xxxx"
  },
  "agents": { "defaults": { "model": {
    "primary": "anthropic/claude-opus-4-6",
    "fallbacks": ["minimax/MiniMax-M2.7"]
  }}}}
}

常用命令

# 查看所有可用模型
openclaw models list

# 切换默认模型
openclaw models set minimax/MiniMax-M2.7

# 交互式配置，无需手动编辑 JSON
openclaw configure

---

08 · 费用明细

主流模型费用对比（2026 年最新）

模型	输入价格	输出价格	上下文	特点	推荐
MiniMax-M2.7	0.30 元/M	1.20 元/M	200K	速度快，中文优化	⭐⭐⭐⭐⭐
Claude Opus 4.6	110 元/M	550 元/M	200K	编程最强	⭐⭐⭐⭐⭐
GPT-4.5	75 元/M	300 元/M	128K	综合能力强	⭐⭐⭐⭐
DeepSeek V3	1 元/M	2 元/M	128K	性价比极高	⭐⭐⭐⭐⭐
DeepSeek R1	4 元/M	16 元/M	128K	推理超强	⭐⭐⭐⭐
Kimi K2.5	12 元/M	12 元/M	128K	长上下文优秀	⭐⭐⭐⭐
Gemini 2.0	10 元/M	40 元/M	1M	超长上下文	⭐⭐⭐
Groq Llama 3.3	免费	免费	128K	速度极快	⭐⭐⭐⭐
Qwen Coder	免费	免费	32K	编程专用	⭐⭐⭐
本地 Ollama	免费	免费	视配置	完全免费	⭐⭐⭐

费用说明：表格价格为 2026 年 3 月各平台公开数据，实际以官网最新定价为准。

省钱组合建议

• 💰 日常对话 - MiniMax-M2.7 或 DeepSeek V3（便宜又快）
• 💻 编程写代码 - Claude Opus 4.6 或 Qwen Coder（免费）
• 📄 长文分析 - Claude Opus 4.6（200K 上下文最强）
• 🎯 追求极致便宜 - DeepSeek V3（百万 Token 仅 3 元）

---

09 · 常见问题

安装问题

Q: 终端报错 command not found: openclaw

Node.js 没装好。重新运行：curl -fsSL https://openclaw.ai/install.sh | bash

Q: 浏览器打不开 localhost:18789

运行 openclaw gateway start 启动，用 openclaw gateway status 查看状态。

Q: npm 安装报 sharp build error

运行：SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

配置问题

Q: API Key 总提示不对？

确认格式是 sk- 开头，检查复制时没有多余空格。建议删除旧 Key，重新在官网生成一个新的。

Q: 怎么切换到其他模型？

openclaw models set anthropic/claude-opus-4-6 即可切换。

Q: 配置文件在哪？怎么打开？

• macOS: ~/.openclaw/openclaw.json
• Windows: 用户目录下 .openclaw 文件夹
• 用记事本或 VS Code 打开编辑即可。

使用问题

Q: AI 回复很慢？

切换速度更快的模型：openclaw models set minimax/MiniMax-M2.7

Q: 怎么接入微信？

运行 openclaw plugins list 查看支持的插件，需要安装 WeChat 插件后配置。

Q: 怎么更新 OpenClaw？

npm install -g openclaw@latest
openclaw gateway restart

---

10 · 技能介绍

OpenClaw 支持安装技能（Skills），像给 AI 装 App 一样扩展能力。目前已内置 50+ 技能：

类别	代表性技能
编程开发	coding、vibe-coding、frontend-design
内容写作	copywriting、blog-writer、seo-content-writer
调研分析	market-research、in-depth-research
思维效率	brainstorming、self-improving
UI/UX 设计	ui-ux-pro-max、frontend-design
平台集成	feishu-doc、obsidian-ontology-sync
联网能力	autoglm-websearch、deep-research-pro
图片生成	autoglm-generate-image
视频处理	video-frames、ffmpeg-video-editor
安全审计	security-auditor、clawdefender

安装新技能

# 搜索技能
openclaw skills search "关键词"

# 安装技能
openclaw skills install skill-name

# 查看已安装技能
openclaw skills list

💡 小提示
技能市场（ClawHub）：https://clawhub.com

---

附录：常用命令速查

命令	说明
openclaw --version	版本
openclaw gateway restart	重启
openclaw configure	配置
openclaw models list	模型列表
openclaw models set xxx	切换模型
openclaw plugins list	插件列表
openclaw --help	帮助

---

AiTimes 智能时代 © 2026 | www.AiTimes.net