跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 在 Mac 上本地化部署及接入飞书教程

介绍如何在 Mac 系统上通过 npm 方式本地化部署开源个人 AI 助手平台 OpenClaw。内容包括环境准备(Node.js)、安装配置、连接大模型 API(如 Kimi)以及集成飞书机器人实现自动化交互。教程涵盖插件安装、权限配置及常用命令,旨在帮助用户构建专属 AI 工作流。

灵魂伴侣发布于 2026/4/6更新于 2026/10/24106 浏览
OpenClaw 在 Mac 上本地化部署及接入飞书教程

OpenClaw 简介

OpenClaw 是 Moltbot/Clawdbot 的最新正式名称。核心定位是通过自然语言指令,替代人工完成流程化、重复性工作,无需用户掌握编程技能,适配多场景自动化需求。

OpenClaw 是一个开源的个人 AI 助手平台。简单来说,它是一个可以将你自己的 AI 助手接入你已经在用的即时通讯工具(Telegram、WhatsApp、飞书等)的系统。你可以自己挑选 AI 模型进行连接,添加各种工具和技能,构建专属工作流。

OpenClaw

注意:OpenClaw 需要访问不少本地权限和文件。建议找一台没有数据的 Mac 来试水,避免自己的隐私数据泄露。

准备工作

在开始之前,请确认你的 Mac 满足以下条件:

  • macOS Sonoma 或更新版本(推荐使用 Apple Silicon M1 及以上芯片,性能会更好)。
  • 流畅的网络环境,必要时可能需要配置网络代理(部分依赖库需要从 GitHub 下载)。

官方网站:https://openclaw.ai/

安装方式选择

官网提供四种安装方式:

  1. **One-liner:**一键脚本安装,最简单、官方推荐。适合个人用户快速体验。缺点是侵入性较强,不方便后期维护。
  2. **npm:**全局安装方式,需要依赖 Node.js 包管理器。适合前端开发者或熟悉 Node.js 的用户。版本控制方便,更新更容易,本文选用此安装方式。
  3. **Hackable:**源码安装方式,可任意魔改。适合想要修改核心逻辑的人。
  4. **macOS:**GUI 界面应用,提供原生体验,但通常配合 CLI 使用。

如果想长期稳定使用,建议选择 npm 安装。

环境配置(npm 安装)

OpenClaw 依赖于 Node.js 环境。

  1. 复制官网链接到浏览器打开,下载安装包:https://nodejs.org/zh-cn/download
  2. 按照安装包提示正常安装即可。
  3. 打开「终端」。
  4. 在终端内输入以下命令安装 OpenClaw:
sudo npm i -g openclaw

然后回车,输入开机密码后再回车。

  1. 如果出现 Git 下载协议错误,修改 Git 下载协议(强制使用 HTTPS),执行以下代码:
git config --global url."https://github.com/".insteadOf ssh://[email protected]/
  1. 重新输入安装命令,出现成功界面表示安装完成。
  2. 启动 OpenClaw 的初始化向导:
openclaw onboard
  1. 按向左方向键 ←,选择 Yes,按 Enter 回车确认风险提示。
  2. 选择 QuickStart(快速开始模式),回车。
  3. 配置 AI 模型 API Key。OpenClaw 需要连接到大语言模型才能工作。新版本支持 Kimi K2.5 等模型。
  4. 如果没有 API Key,可前往官方地址注册账号获取:https://platform.moonshot.cn/console/api-keys
  5. 复制 API key,在终端对应位置粘贴并回车。
  6. 选择 Kimi API key (.cn),回车。
  7. 输入你的 API Key,回车。
  8. 选择保持当前(moonshot/kimi-k2.5),回车。
  9. 聊天工具选项建议先「暂时跳过」,先在终端里把 OpenClaw 跑起来,确认 AI 大脑、文件读写权限都正常工作。
  10. 选择是否配置备用 API,不想配置选「No」。
  11. 等待服务配置完成,选择「Open the web UI」,打开可视化页面。

把 OpenClaw 接入飞书机器人

  1. 进入飞书开放平台。登录成功后,点击创建企业自建应用。
  2. 填写应用名称、描述,选择图标,点击「创建应用」。
  3. 在添加应用能力中选择「机器人」→ 点击「添加」。
  4. 在开发配置中点击「权限管理」→「开通权限」。
  5. 搜索「im:」勾选全部相关权限名称,点击「确认开通权限」。
  6. 点击左侧「云文档」勾选全部相关权限名称,点击「确认开通权限」。
  7. 点击顶部「创建版本」按钮,填写相关内容后保存。
  8. 点击「确认发布」。
  9. 为了防止与自带的飞书文件夹冲突,删除之前的扩展:
sudo rm -rf ~/.openclaw/extensions/feishu
  1. 下载飞书插件:
openclaw plugins install @m1heng-clawd/feishu
  1. 配置 OpenClaw:
openclaw config
  1. 依次选择「Local (this machine)」→「Channels(渠道)」→「Configure/link(配置链接)」→「Feishu/Lark(飞书)」。
  2. 打开飞书开放平台,在「应用凭证」里,复制 AppID 和 AppSecret。
  3. 在终端对应位置分别输入飞书的 AppID 和 AppSecret。
  4. 选择「Feishu(feishu.cn)- China」。
  5. 选择「Open - respond in all groups(requires mention)」。
  6. 选择「Finished」,回车。
  7. 选择「Yes」,回车。
  8. 选择「Open...」,回车。
  9. 选择「Continue」,回车。
  10. 配置完成后关闭终端。
  11. 重启配置:
openclaw gateway
  1. 打开飞书开放平台,选择「事件与回调」→「订阅方式」→「使用长连接接收事件」→「保存」。
  2. 点击同一页面内的「添加事件」,搜索并添加「接收消息」、「消息已读」、「机器人进群」、「机器人被移出群」。
  3. 点击「权限管理」→搜索「通讯录」→选中「获取通讯录基本信息」→「确认开通权限」。
  4. 配置完成后重新发布新版本。
  5. 打开手机端「飞书」,搜索机器人的名字,给机器人发消息,如果机器人以 AI 的方式进行回复,则配置成功。

OpenClaw 常用命令

openclaw onboard      # 重新进入配置向导
openclaw status       # 查看运行状态
openclaw health       # 健康检查
openclaw gateway start # 启动服务
openclaw gateway stop  # 停止服务
openclaw update       # 更新到最新版本
openclaw doctor       # 诊断问题
openclaw uninstall    # 卸载 OpenClaw

OpenClaw 技能库

OpenClaw 技能库是给 AI 装上「技能插件」,让它从'动嘴皮子'变成'真能干活'。

  1. 宝藏仓库地址 GitHub 地址: https://github.com/VoltAgent/awesome-openclaw-skills 里面包含内容众多,可根据自身需求进行安装。
  2. ClawHub,精英特工的技能平台。 官方网站:https://clawhub.ai/

目录

  1. OpenClaw 简介
  2. 准备工作
  3. 安装方式选择
  4. 环境配置(npm 安装)
  5. 把 OpenClaw 接入飞书机器人
  6. OpenClaw 常用命令
  7. OpenClaw 技能库

更多推荐文章

查看全部
  • Cursor IDE 配置 Java SpringBoot 开发环境
  • uv 虚拟环境管理:创建、激活与 Python 版本指定
  • 人工智能发展历程与现状分析
  • OpenClaw 安装及飞书机器人配置流程指南
  • LangChain 大模型对话记忆模块实战与 Web 应用
  • DeepSeek-OCR-WEBUI 本地部署与 OCR 自动化集成
  • IDEA 集成通义千问插件的 Java 开发实战
  • Ollama 本地大模型部署与 WebAPI 调用实战指南
  • Text2SQL 跨数据库 SQL 转换实战代码
  • BeyondMimic 人形机器人运动模仿与 rl_sar 部署实践
  • Windows家用电脑也能玩转Gemma3大模型?手把手教你用Ollama+Open WebUI搭建AI聊天室
  • Ollama下载模型太慢?试试国内HuggingFace镜像+LLama-Factory组合
  • whisper.cpp 模型部署与性能实测:从 tiny 到 large-v3-turbo
  • NASA 火星任务软件测试:AIGC 模拟外星环境攻击
  • VS Code 安装 GitHub Copilot 及 AI 编程使用指南
  • LLaMA 大模型本地化稳定部署指南:基于 Ollama 与 NextChat
  • C++ string 模拟实现与底层细节深度解析
  • OpenWebUI联网搜索实战:如何用SearXNG让本地大模型获取实时信息(附百度/360配置)
  • [特殊字符] 终极解决方案:彻底攻克llama.cpp动态链接库加载失败难题
  • Midjourney sref编码进阶玩法:2026 AI图像风格统一秘籍

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online