保姆级教程:在 Mac 上安装 OpenClaw 并配置 Kimi 大模型

想拥有一个 24 小时在线的私人 AI 助理，能通过 Telegram、WhatsApp 跟你对话，帮你搜资料、读文件、管日程？OpenClaw 就是这样一个开源项目——把 AI 模型变成你真正的个人助理，运行在你自己的电脑上，数据完全由你掌控。

本文以 macOS 为例，从零开始手把手教你完成安装，并配置国产的 Kimi（Moonshot） 大模型作为 AI 引擎。

一、你需要准备什么

在动手之前，先确认以下几项：

硬件要求：

• 一台 Mac 电脑（Intel 或 Apple Silicon 均可）
• 能正常上网

软件要求：

• macOS 系统（推荐 macOS 13 及以上）
• 终端（Terminal.app，系统自带）

账号准备：

• 一个 Moonshot 开放平台账号（用于获取 Kimi API Key）

💡 不用担心，下面每一步都会详细说明，跟着做就行。

二、安装 Node.js 环境

OpenClaw 基于 Node.js 运行，需要 Node 22 或更高版本。

方法一：使用 Homebrew 安装（推荐）

如果你的 Mac 已经安装了 Homebrew，直接一条命令搞定：

brew install node

🤔 什么是 Homebrew？它是 macOS 上最流行的包管理工具。如果没装过，先执行下面这条命令安装 Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装过程中按提示操作即可，可能需要输入你的 Mac 登录密码。

方法二：从官网下载安装

访问 nodejs.org^[1]，下载 macOS 安装包（选 LTS 版本），双击 .pkg 文件，一路点「继续」即可。

验证安装

安装完成后，打开终端（按 Cmd + 空格，输入 Terminal 回车），输入：

node -v

如果看到类似 v22.x.x 或更高版本号，说明安装成功 ✅

如果提示 command not found，请关闭终端重新打开再试一次。

三、一键安装 OpenClaw

Node.js 准备好后，安装 OpenClaw 只需要一条命令。在终端中输入：

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

这条命令会自动完成以下事情：

1. 检测你的 Node.js 版本是否满足要求
2. 通过 npm 全局安装 OpenClaw CLI 工具
3. 自动启动配置向导（Onboarding Wizard）

⏱ 安装过程大约需要 1-3 分钟，取决于网络速度。

如果安装过程中没有自动启动配置向导，你可以手动运行：

openclaw onboard --install-daemon

⚠️ 如果提示 openclaw: command not found，说明 npm 全局路径没加到 PATH。执行以下命令修复：
export PATH="$(npm prefix -g)/bin:$PATH"
然后把这行也添加到 ~/.zshrc 文件中，这样每次打开终端都能生效：
echo &#x27;export PATH="$(npm prefix -g)/bin:$PATH"&#x27; >> ~/.zshrc

四、获取 Kimi API Key

在配置向导中需要用到 Kimi 的 API Key，我们先去申请一个。

第 1 步：注册 Moonshot 开放平台

访问 Moonshot 开放平台：

👉 https://platform.moonshot.cn

点击右上角「注册 / 登录」，用手机号完成注册。

第 2 步：创建 API Key

登录后，进入控制台：

1. 在左侧菜单找到 「API Key 管理」
2. 点击 「新建 API Key」
3. 给 Key 起个名字，比如 openclaw
4. 点击「创建」

⚠️ 重要：创建后会显示完整的 API Key（以 sk- 开头），请立即复制保存！关闭弹窗后就看不到了。

API Key 格式类似：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

第 3 步：确认额度

Moonshot 新用户通常有免费额度可以试用。你可以在控制台的「用量统计」页面查看剩余额度。

五、配置 OpenClaw（Onboarding 向导）

安装脚本执行完毕后，向导会自动启动。如果没有，手动运行：

openclaw onboard --install-daemon

向导会一步步引导你完成配置，下面是详细说明：

第 1 步：选择模式

向导首先问你选择 QuickStart（快速） 还是 Advanced（高级）。

👉 选 QuickStart，适合新手，大部分配置用默认值即可。

第 2 步：配置 AI 模型

这是最关键的一步。向导会让你选择 AI 模型提供商。

选择 Moonshot：

向导中找到并选择 Moonshot 作为模型提供商。

或者你也可以直接用命令行指定：

openclaw onboard --auth-choice moonshot-api-key

输入 API Key：

向导会提示你输入 Moonshot API Key，把第四步复制的 Key 粘贴进去即可。

选择默认模型：

推荐选择 kimi-k2.5，这是 Kimi 最新的旗舰模型，效果好，支持 256K 超长上下文。

可用的 Kimi 模型列表：

• kimi-k2.5 — 旗舰模型，综合能力最强（推荐）
• kimi-k2-turbo-preview — 速度更快的版本
• kimi-k2-thinking — 带深度思考能力
• kimi-k2-thinking-turbo — 思考版的加速版

第 3 步：设置工作区

向导会问工作区路径，直接回车用默认值即可：

~/.openclaw/workspace

这个目录是 AI 助理存放记忆、文件和工作内容的地方。

第 4 步：配置 Gateway

Gateway 是 OpenClaw 的核心服务引擎，向导会配置：

• 端口号：默认 18789，直接回车
• 认证模式：默认 Token 认证，自动生成，直接回车
• 绑定地址：默认本地回环（loopback），只有本机能访问，直接回车

💡 这些默认值对个人使用完全够用，不需要修改。

第 5 步：连接消息渠道（可选）

向导会问你要不要连接消息渠道。这里你可以选择：

• Telegram — 通过 BotFather 创建一个 Bot
• WhatsApp — 扫码连接你的 WhatsApp
• 暂时跳过 — 先用浏览器控制台聊天

💡 建议新手先跳过，安装完成后用浏览器控制台测试，后面再慢慢配置消息渠道。

第 6 步：安装守护进程

向导会问是否安装守护进程（daemon），选择「是」。

在 macOS 上，这会安装一个 LaunchAgent 用户级服务，让 OpenClaw 在后台持续运行，并且开机自动启动。

第 7 步：安装推荐技能

向导会推荐安装一些实用技能（Skills），可以全部安装。技能就像插件，给 AI 助理增加新能力。

六、验证安装成功

配置向导完成后，来确认一切正常。

检查配置

openclaw doctor

这个命令会检查你的配置是否有问题，全部绿色 ✅ 就是没问题。

查看 Gateway 状态

openclaw gateway status

应该显示 Gateway 正在运行（running）。

如果显示未运行，手动启动：

openclaw gateway start

打开浏览器控制台

openclaw dashboard

这会自动打开浏览器，进入 OpenClaw 的控制台界面。你也可以手动访问：

👉 http://127.0.0.1:18789/

在控制台的聊天框里输入一句话试试，比如「你好，介绍一下你自己」。如果 AI 回复了，恭喜你，安装成功！🎉

七、手动配置 Kimi 模型（备选方案）

如果你在向导中没有选择 Moonshot，或者想要手动修改配置，可以这样做：

方法一：用命令行重新配置

openclaw configure

在交互式菜单中选择模型配置，重新选择 Moonshot 并输入 API Key。

方法二：直接编辑配置文件

OpenClaw 的配置文件位于 ~/.openclaw/config.json5，你可以用任意编辑器打开：

open ~/.openclaw/config.json5

找到（或添加）以下配置：

{  // 设置环境变量  env: {    MOONSHOT_API_KEY: "sk-你的API Key"  },  // 设置默认模型  agents: {    defaults: {      model: {        primary: "moonshot/kimi-k2.5"      }    }  }}

保存后重启 Gateway：

openclaw gateway restart

八、日常使用小技巧

安装完成后，这里是一些常用命令速查：

Gateway 管理：

openclaw gateway status    # 查看状态openclaw gateway start     # 启动openclaw gateway stop      # 停止openclaw gateway restart   # 重启

打开控制台：

openclaw dashboard         # 浏览器聊天界面

健康检查：

openclaw doctor            # 检查配置问题openclaw status            # 查看整体状态

更新 OpenClaw：

npm install -g openclaw@latest

九、常见问题 FAQ

Q：`openclaw: command not found` 怎么办？

这是最常见的问题，通常是 PATH 没配好。执行：

echo &#x27;export PATH="$(npm prefix -g)/bin:$PATH"&#x27; >> ~/.zshrcsource ~/.zshrc

Q：安装时 `sharp` 报错怎么办？

在 macOS 上如果你装过 Homebrew 的 libvips，可能会冲突。解决：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Q：Kimi API Key 在哪里获取？

访问 👉 https://platform.moonshot.cn ，登录后在「API Key 管理」页面创建。

Q：免费额度用完了怎么办？

可以在 Moonshot 平台充值，或者换用其他模型提供商（OpenClaw 支持几十种）。

Q：能同时用多个模型吗？

可以！OpenClaw 支持配置多个模型，随时切换。在聊天中用 /model 命令切换。

Q：如何连接 Telegram？

运行 openclaw configure，在渠道配置中选择 Telegram，按照提示通过 @BotFather 创建 Bot 并填入 Token 即可。

十、了解更多

• 📖 官方文档：docs.openclaw.ai^[2]
• 💻 GitHub 仓库：github.com/openclaw/openclaw^[3]
• 💬 Discord 社区：discord.com/invite/clawd^[4]
• 🔌 技能商店：clawhub.com^[5]

OpenClaw 是一个开源项目，你的数据完全由你掌控。觉得好用的话，去 GitHub 给个 ⭐ 吧！

引用链接

[1] nodejs.org: https://nodejs.org/[2] docs.openclaw.ai: https://docs.openclaw.ai[3] github.com/openclaw/openclaw: https://github.com/openclaw/openclaw[4] discord.com/invite/clawd: https://discord.com/invite/clawd[5] clawhub.com: https://clawhub.com