OpenClaw 零基础安装指南Mac 本地部署并集成飞书全流程OpenClaw 是什么你要准备什么Step1: 安装Homebrew作用步骤Step2: 安装node.js作用步骤Step3: 安装OpenClaw作用步骤Step4配置OpenClaw作用步骤Step5: 打开OpenClaw Dashboard作用步骤集成飞书在飞书开放平台创建应用配置应用权限配置事件订阅发布应用在 OpenClaw 中配置飞书测试OpenClaw 是什么OpenClaw 是一个开源的 AI 私人助理平台。你可以把它理解为一个跑在你自己电脑上的 AI 管家。它能连接 WhatsApp、Telegram、微信、Discord飞书 等聊天软件让你通过日常聊天就能操控 AI 帮你完成各种任务——管日历、发邮件、浏览网页、执行脚本等。和 ChatGPT 这类在线工具不同OpenClaw 运行在你自己的机器上数据由你自己掌控。你要准备什么在开始之前确认以下几项一台 Mac 电脑Intel 或 Apple Silicon。至少 4GB 内存推荐 8GB一个 AI 模型的 API Key比如 AnthropicClaude、OpenAI, Google Gemini, MinMax或者Kimi的密钥。如果你还没有可以在对应平台的官网注册获取。也可以用免费的本地模型通过 Ollama。Step1: 安装Homebrew作用Homebrew 是 Mac 上的软件安装助手。很多开发工具不在 App Store 里需要通过 Homebrew 来安装。如果已经安装可以跳过这一步。确认是否安装:brew--version步骤/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)安装完成后终端会提示你运行两行命令。复制执行它们或者直接运行echoeval $(/opt/homebrew/bin/brew shellenv)~/.zprofileeval$(/opt/homebrew/bin/brew shellenv)这两行命令是把 Homebrew 加到系统的搜索路径里这样电脑以后才能找到通过 Homebrew 安装的软件。Step2: 安装node.js作用Node.js 是一个 JavaScript 运行环境。OpenClaw 是用 JavaScript 编写的需要 Node.js 才能运行。可以把 Node.js 理解为 OpenClaw 的引擎——没有它OpenClaw 就跑不起来。步骤直接用brew install 或者直接下载安装包, node-v24.14.0.pkg如果是brew installbrewinstallnode22确认安装成功node --versionStep3: 安装OpenClaw作用这一步是把 OpenClaw 的运行程序下载到你的电脑上。步骤# 配置npm的代理如果你可以科学上网可以skip这部分npmconfigsetregistry https://registry.npmmirror.com# 安装openclawsudonpminstall-gopenclawlatest如果安装不成功试试下面的步骤。会安装所有需要的依赖。sudocurl-fsSLhttps://openclaw.ai/install.sh|sudobash-s----registryhttps://registry.npmmirror.com确认安装成功openclaw--versionStep4配置OpenClaw作用这是 OpenClaw 的初始化配置过程。向导会一步步引导你设置以下内容身份验证生成一个安全令牌防止别人控制你的 AI 助手网关设置配置 OpenClaw 的核心服务端口、绑定地址等AI 模型选择选择你想用的大语言模型如 Claude、GPT 等并输入 API Key安装后台服务–install-daemon 参数会把 OpenClaw 注册为 Mac 的后台服务这样每次开机它都会自动启动不需要你手动运行步骤操作openclaw onboard --install-daemon然后会用交互式问答的方式引导你跟着提示一步步选择即可。我的个人选择如下到这里要开始配置你的model provider我选择的是MinMax毕竟便宜。访问https://platform.minimaxi.com/账户管理- 接口秘钥 - 创建新的API Key把这个api key copy 过来就可以了。Step5: 打开OpenClaw Dashboard作用控制面板是 OpenClaw 的网页管理界面你可以在浏览器里和 AI 助手对话、管理设置、查看连接状态。步骤先确保openclaw能正常运行openclaw gateway status打开dashboard:openclaw dashboard然后就可以跳转到http://127.0.0.1:18789/然后恭喜你你可以让他操控你的Mac了。集成飞书OpenClaw 的强大之处在于你可以通过日常用的聊天 App 直接和它对话。我们以飞书为例看下如何让 AI 助手住进飞书。连接飞书使用的是 WebSocket 长连接模式——这意味着不需要公网服务器、不需要域名、不需要 ngrok你的 Mac 直接和飞书云端通信。在飞书开放平台创建应用作用你需要在飞书那边注册一个机器人身份。飞书会给你一组身份证App ID 和 App SecretOpenClaw 拿着这组身份证就能以机器人的身份收发消息。打开浏览器访问 飞书开放平台用你的飞书账号登录点击 创建企业自建应用填写应用名称比如家庭助理和描述然后创建进入应用后在左侧菜单点击 添加应用能力 → 勾选 机器人进入 凭证与基础信息 页面记下 App ID以 cli_ 开头和 App Secret——后面要用配置应用权限作用告诉飞书这个机器人被允许做哪些事情比如接收消息、发送消息等。在飞书开放平台开发者后天进入你的应用 → 左侧菜单点击 权限管理搜索im可以开通所有带有im的权限。im:message — 获取与发送消息im:message:send_as_bot — 以机器人身份发送消息im:chat — 获取群组信息im:resource — 获取消息中的资源文件图片等点击 批量开通配置事件订阅作用让飞书知道当有人给机器人发消息时应该通知你的 OpenClaw。在飞书开放平台左侧菜单点击 事件与回调订阅方式选择 使用长连接接收事件这是关键——长连接不需要公网地址添加事件搜索并添加 im.message.receive_v1接收消息事件发布应用左侧菜单点击 版本管理与发布创建一个版本并提交审核在 OpenClaw 中配置飞书操作回到 Mac 终端运行以下命令把 cli_你的AppID 和 你的AppSecret 替换为真实值openclaw config set channels.feishu.enabled true --jsonopenclaw config set channels.feishu.appId “cli_你的AppID”openclaw config set channels.feishu.appSecret “你的AppSecret”openclaw gateway restart作用第一行开启飞书渠道第二、三行把飞书给的身份证告诉 OpenClaw第四行重启网关让配置生效你也可以把AppID 和 AppSecret直接告诉OpenClaw让它帮你配置。测试手机上安装飞书app然后搜索你的机器人名字就会看到了这样你的7*24小时个人助理就创建完成了。