Mac mini部署OpenClaw接入国产大模型与飞书指南

2026-06-03阅读 0热度 0
其他

一、准备工作

项目说明
一台Mac mini云服务器、旧电脑、树莓派也可以
飞书账号用来创建机器人
国产模型的apiopenclaw的在配置时仅显示国际的大模型,国产模型需要单独配置

二、部署OpenClaw到mac mini

2.1 快速部署

先把安装命令扔进终端。两种选择:稳定版和测试版。稳定版适合日常使用,测试版可能藏着些新功能,但也有可能带点小Bug,想尝鲜的话可以试试。

  1. 稳定版安装:在终端输入以下命令
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 测试版安装(可能包含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 验证飞书接入

  1. 启动OpenClaw网关:openclaw gateway
  2. 打开飞书APP,进入工作台
  3. 找到已发布的OpenClaw应用(比如“傻妞”)
  4. 发送一条消息,如果收到回复,说明接入成功了

五、实用操作命令与技巧

基础部署完成后,掌握下面这些常用命令能让操作效率提升不少。

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助手——既有国产大模型的经济实惠,又有飞书的便捷好用。日常自动化需求基本都能满足。希望这篇内容对你有帮助!

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策