乐于分享
好东西不私藏

Mac 上装 OpenClaw保姆级教程(连接飞书/微信)

Mac 上装 OpenClaw保姆级教程(连接飞书/微信)

全新 Mac 上装 OpenClaw:让飞书变成你的私人 AI 助手

TLDR:三条命令装好 OpenClaw,再一条命令连上飞书,你的 Mac Mini 就变成了 24 小时在线的 AI 助手。 

OpenClaw 是一个开源工具,装在你自己的电脑上,让你直接在微信、飞书这些聊天软件里跟 AI 对话。不需要打开网页,不需要切换 App,发条消息就能用。

我在一台全新 Mac Mini 上从零安装了一遍,跟着做就行。


Step 1:安装 Homebrew

Homebrew 是 macOS 的包管理器。全新 Mac 第一步就是装它。

# 安装 Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完之后,配置环境变量:

# 配置环境变量 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc  # 验证安装 brew --version

看到版本号就说明装好了。


Step 2:安装 Node.js

OpenClaw 是 Node.js 写的,需要 Node 22+。

# 安装 Node.js brew install node  # 验证 node --version npm --version

两个都有版本号输出就 OK。


Step 3:安装 OpenClaw

一条命令:

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

脚本会自动检测环境、安装 OpenClaw、跑配置向导:

 ——— 安全确认 → 选 QuickStart ——— 

安装过程中会弹安全提示,选 Yes。然后选 QuickStart 快速完成配置。

 ——— 选择 AI 模型 ——— 

选你的 AI 模型提供商,支持非常多:

我选了 Google Gemini(之前有三个月 500 刀的免费额度),粘贴 API Key:

用其他模型的同理,去相应平台获取 API Key 就行,各平台都有自己的教程。

 ——— 选择聊天渠道 ——— 

选你要连接的聊天平台:

支持 WhatsApp、Discord、Slack、飞书、iMessage 等。这一步也可以先跳过,飞书和微信有更简单的连接方式(见下面)。

 ——— Web Search — 先跳过 ——— 

接下来会问你选搜索引擎,让 AI 能联网搜索。先选 Skip for now,后面再配。

 ——— Skills & Hooks — 也跳过 ——— 

Skills(技能)和 Hooks(自动化钩子)都可以先跳过,不影响基本使用。

 ——— Gateway 服务 ——— 

Gateway 已经自动安装好了,选 Restart 重启一下:

 ——— 启动方式 ——— 

最后一步问你怎么启动,选 Open the Web UI,会自动在浏览器打开后台:

看到这个界面就说明全部搞定了!AI 已经在运行了。

 ——— 验证安装 ——— 

# 确认安装成功 openclaw --versionOpenClaw 2026.3.24 (61d171a)

Step 4:连接飞书

不需要去飞书开放平台手动建应用,一条命令搞定:

npx -y @larksuite/openclaw-lark install

运行后会自动安装飞书插件、注册工具(日历、任务、文档等),然后显示一个二维码:

用飞书扫码后,会跳转到飞书管理后台。你需要进入管理控制台,找到机器人的申请批准:

点击「批准」发布机器人:

批准后,在飞书里给机器人发消息,AI 就会回复了。


Step 5:连接微信

微信也能连。首先确保你的微信是最新版本,然后:

打开微信 → Settings(设置):

往下滑到 Features 区域,找到 Plus(插件)入口:

等待插件列表加载,你会看到 WeixinClawBot 插件,点进去:

页面会显示安装命令,在 Mac 终端运行:

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

然后点 Start Scan,用微信扫终端里的二维码,就连上了。


日常使用

命令
作用
openclaw status
查看整体状态
openclaw dashboard
打开后台管理面板
openclaw gateway start
启动网关
openclaw gateway stop
关闭网关
openclaw gateway restart
重启网关
openclaw configure
重新配置
openclaw logs --follow
实时看日志
openclaw doctor
自动诊断问题

OpenClaw 装好后会注册为 macOS LaunchAgent,开机自动启动。想看后台面板,终端跑一下 openclaw dashboard 就会自动在浏览器打开。


常见问题

 ——— Gateway 连不上? ——— 

# 自动诊断 openclaw doctor  # 或者直接重启 openclaw gateway restart

 ——— 能同时连多个渠道吗? ——— 

能。飞书、微信、Discord 可以同时在线,消息隔离,AI 记忆共享。

 ——— 换 AI 模型? ——— 

openclaw configure # 选 Model,换完后重启 openclaw gateway restart

 ——— 彻底卸载? ——— 

launchctl remove ai.openclaw.gateway rm -rf ~/.openclaw npm uninstall -g openclaw

整个过程 10 分钟。装好之后你的 Mac Mini 就是一个 24 小时在线的 AI 助手,在飞书和微信里随时能找它。

如果你也有一台吃灰的 Mac Mini,不妨试试。