跳到主要内容Mac mini 部署 OpenClaw 接入国产大模型与飞书指南 | 极客日志Shell / BashAI
Mac mini 部署 OpenClaw 接入国产大模型与飞书指南
OpenClaw 部署于 Mac mini 环境,支持接入国产大模型及飞书机器人。教程涵盖基础安装、国内模型(如 DeepSeek)配置、飞书应用凭证获取与权限设置,以及常用管理命令。通过本地化部署实现低成本 AI 助手集成,提供终端交互与即时通讯双通道支持。
Elasticer18 浏览 一、准备工作
| 项目 | 说明 |
|---|
| Mac mini | 云服务器、旧电脑、树莓派也可以 |
| 飞书账号 | 用来创建机器人 |
| 国产模型的 api | openclaw 的在配置时仅显示国际的大模型,国产模型需要单独配置 |
二、部署 OpenClaw 到 mac mini
2.1 快速部署
- 稳定版安装:在终端输入以下命令
curl -fsSL https://openclaw.ai/install.sh | bash
- 测试版安装(可能包含 Bug)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta

2.2 同意免责声明
安装好后,将会出现一个问题:是否知晓风险,选择 Yes 就行。

2.3 配置模式选择
选择'QuickStart'快速入门模式

2.4 模型配置
- 国际模型支持:OpenClaw 默认支持多平台国际大模型
配置选择:如需接入国内大模型,请选择跳过此步骤

国产模型注意:该配置页面的 Kimi、MiniMax、GLM 需使用国际版接口

2.5 聊天软件(Channel)配置
OpenClaw 已支持很多软件,但是引导流程中显示多为国外应用
请跳过此步骤!后续通过增加 channel 的方式添加。
2.6 技能包(Skill)配置
新手暂时无需添加额外技能包,选中'No'跳过,按回车键确认;
2.7 Hooks 配置
选中'Memory'(启用记忆功能,支持多轮对话上下文关联,避免每次聊天都需要重复说明需求),按回车键确认;
2.8 等待部署完成
部署完成后,通过命令 openclaw --version 验证版本:
配置确认后,系统将自动完成部署,耗时约 30 秒 - 1 分钟,无需操作。
2.9 汉化版安装(可选)
curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh
三、接入国产大模型
使用国产大模型是性价比比较高的方案。接下来,演示如何接入国内主流 AI 提供商。
3.1 深度求索(DeepSeek)
openclaw config set'models.providers.deepseek' --json '{ "baseUrl": "https://api.deepseek.com/v1", "apiKey": "", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat" }, { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" } ] }'
openclaw config set models.mode merge
设置默认模型(以 deepseek-chat 为例)
openclaw models set deepseek/deepseek-chat
3.2 通用配置模板
如果想要使用其他模型,可以使用以下通用模板接入任何兼容 OpenAI 协议的模型:
openclaw config set'models.providers.{provider_name}' --json '{ "baseUrl": "https://{baseurl}", "apiKey": "", "api": "openai-completions", "models": [ { "id": "{model_id}", "name": "{model_name}" } ] }'
openclaw config set models.mode merge
openclaw models set{provider_name}/{model_id}
四、接入飞书
4.1 创建飞书企业自建应用
添加机器人能力:在应用管理页左侧导航栏,找到并点击'添加应用能力',在弹出的列表中选择'机器人',点击'添加'。
填写应用基础信息:应用名称(如'傻妞'),选择应用图标,点击'创建'按钮,进入应用管理页面。
4.2 获取飞书应用凭证
- 在飞书应用管理页,左侧导航栏找到'凭据与基础信息'栏目,点击进入;
- 保存完成后,不要关闭飞书开发者平台页面,后续配置权限还需使用。
在页面中找到'App ID'和'App Secret'两个参数,分别点击右侧'复制'按钮,将其保存到记事本或备忘录中;
4.3 添加飞书 channel 配置
openclaw plugins install @m1heng-clawd/feishu
4.4 输入 APP id 与 APP Secret
输入上一步获取到的 id 与 secret,回车确认;
4.5 完成添加流程
完成 ID 与 Secret 配置后,选择 Finish 即可;
openclaw gateway --port 18789 --verbose
4.6 飞书机器人配置
飞书应用权限与事件配置
此步骤分为「事件配置」「权限配置」「应用发布」三部分,全程在飞书开发者平台操作,按顺序执行:
4.6.1 事件配置
- 在飞书应用管理页,左侧导航栏找到'事件与回调'栏目,点击进入;
回调配置:订阅方式选择'使用长连接',无需填写其他地址,配置自动生效。
添加事件:点击页面中的'添加事件',在弹出的事件列表中,选择'消息与群组'分类,勾选'接收消息',点击'确定',完成事件订阅。
如果提示'未建立长连接',请检查自己的 APP ID 和 APP Secret 是否已正确配置。
4.6.2 权限配置
- 在飞书应用管理页,左侧导航栏找到'权限管理'栏目,点击进入;
- 粘贴以下 JSON 代码并导入,等待权限导入完成:
点击页面中的'批量导入权限'按钮,弹出权限导入窗口;
{"scopes":{"tenant":["contact:user.base:readonly", "im:chat", "im:chat:read", "im:chat:update", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:send_as_bot", "im:resource"], "user":[]}}
- 导入验证:页面显示'导入成功',且权限列表中出现上述导入的权限,即为配置完成。
4.6.3 发布应用
4.6.4 验证飞书接入
- 打开飞书 APP,进入工作台
- 找到已发布的 OpenClaw 应用(如'傻妞'),
五、实用操作命令与技巧
完成基础部署后,掌握以下常用命令将显著提升您的使用效率:
5.1 核心管理命令
| 命令 | 功能说明 | 示例 |
|---|
openclaw tui | 启动 OpenClaw 文本用户界面(终端交互模式) | 直接输入即可进入交互界面 |
openclaw gateway restart | 重启网关服务(配置生效/故障恢复) | 修改配置后常用此命令 |
/new | 在对话中开启新会话线程 | 在 TUI 或飞书对话中输入 |
5.2 模型管理命令
openclaw models fallbacks add[提供商代号/模型名称]
openclaw models fallbacks add openai-codex/gpt-5.2-codex
openclaw models set[提供商代号/模型名称]
openclaw models set kimi-code/kimi-for-coding
六、总结
本教程详细介绍了在 Mac mini 上部署 OpenClaw 的全过程,包括基础安装、国产大模型接入以及飞书机器人集成。通过本教程,您可以搭建一个性价比较高的 AI 助手解决方案,结合国产大模型的经济性和飞书的便捷性,满足日常自动化需求。
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- 随机西班牙地址生成器
随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online