Mac mini部署OpenClaw接入国产大模型与飞书指南
摘要
一、准备工作 项目说明一台Mac mini云服务器、旧电脑、树莓派也可以飞书账号用来创建机器
一、准备工作
| 项目 | 说明 |
|---|---|
| 一台Mac mini | 云服务器、旧电脑、树莓派也可以 |
| 飞书账号 | 用来创建机器人 |
| 国产模型的api | openclaw的在配置时仅显示国际的大模型,国产模型需要单独配置 |
二、部署OpenClaw到mac mini
2.1 快速部署
先把安装命令扔进终端。两种选择:稳定版和测试版。稳定版适合日常使用,测试版可能藏着些新功能,但也有可能带点小Bug,想尝鲜的话可以试试。
- 稳定版安装:在终端输入以下命令
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理论上支持很多聊天软件,但引导流程里主要展示的是国外应用,比如Telegram、Discord这些。请注意:这里先跳过,后面我们会通过添加channel的方式搞定(详见下文)。

2.6 技能包(Skill)配置
新手先不用管,选No跳过就行。
2.7 Hooks 配置
这里要选“Memory”。启用记忆功能后,对话上下文就会关联起来,下次聊天时不用反复说自己的需求,体验会好很多。

2.8 等待部署完成
确认所有配置后,系统会自动开始部署。整个过程大概30秒到1分钟,不用管它,喝杯水的功夫就好了。

部署完成后,可以用下面这个命令验证一下版本:
openclaw --version

2. 9 汉化版安装(可选)
如果看英文界面觉得不太习惯,可以装个汉化版:
curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh
配置方法和英文版完全一样。
三、接入国产大模型
说到底,OpenClaw挺消耗token的,用国产大模型显然性价比更高。下面就来演示如何接入国内主流AI提供商。
3.1 深度求索(DeepSeek)
首先去 https://platform.deepseek.com/api_keys 获取API key,然后在终端输入以下命令配置:
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 创建飞书企业自建应用
先去飞书开发者平台(https://open.feishu.cn/app?lang=zh-CN)登录,然后点击“创建企业自建应用”。填上应用名称(比如“傻妞”),选个图标,点击“创建”。

在应用管理页左侧导航栏找到“添加应用能力”,选择“机器人”,点击添加。接着点击上方的“创建版本”并发布。


4.2 获取飞书应用凭证
在飞书应用管理页左侧导航栏找到“凭据与基础信息”,进入后复制“App ID”和“App Secret”两个参数,保存到记事本里。别忘了,后面配置权限还要用到这个页面。

4.3 添加飞书channel配置
回到终端,先安装飞书插件:
openclaw plugins install @m1heng-clawd/feishu

然后输入以下命令:
openclaw channels add
选择“Yes”以及“飞书”。


4.4 输入APP id 与 APP Secret
输入刚才复制下来的App ID和App 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 验证飞书接入
- 启动OpenClaw网关:
openclaw gateway - 打开飞书APP,进入工作台
- 找到已发布的OpenClaw应用(比如“傻妞”)
- 发送一条消息,如果收到回复,说明接入成功了

五、实用操作命令与技巧
基础部署完成后,掌握下面这些常用命令能让操作效率提升不少。
5.1 核心管理命令
| 命令 | 功能说明 | 示例 |
|---|---|---|
| openclaw tui | 启动OpenClaw文本用户界面(终端交互模式) | 直接输入即可进入交互界面 |
| openclaw gateway restart | 重启网关服务(配置生效/故障恢复) | 修改配置后常用此命令 |
| /new | 在对话中开启新会话线程 | 在TUI或飞书对话中输入 |
5.2 模型管理命令
# 添加备用模型(主模型不可用时自动切换) openclaw models fallbacks add [提供商代号/模型名称] # 示例:添加OpenAI Codex作为备用 openclaw models fallbacks add openai-codex/gpt-5.2-codex # 设置默认模型 openclaw models set [提供商代号/模型名称] # 示例:将Kimi设为默认编程模型 openclaw models set kimi-code/kimi-for-coding
六、总结
这篇教程从头到尾带你走了一遍在Mac mini上部署OpenClaw的全过程,包括基础安装、国产大模型接入以及飞书机器人集成。按步骤操作下来,就能轻松搭建起一个性价比不错的AI助手——既有国产大模型的经济实惠,又有飞书的便捷好用。日常自动化需求基本都能满足。希望这篇内容对你有帮助!
来源:互联网
本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。