Mac 本地安装 OpenClaw 详细指南（Qwen／Minimax + 飞书）

OpenClaw 是一款真正会动手的个人 AI 助手：它不只会聊天，还能帮你清邮箱、发邮件、管日历、查航班、跑脚本、控智能设备……而你只需要在飞书、WhatsApp、Telegram、Discord 等日常用的聊天应用里跟它说话。你的上下文和技能都跑在你自己的电脑上，数据不必交给云端，开源可折腾，被很多人称为「第一次觉得活在 ChatGPT 之后真正的未来」「Siri 本该成为的样子」。

它之所以最近特别火，一方面是因为多通道 + 本地优先：一个助手同时出现在飞书、Telegram、Slack 里，用你习惯的 IM 就能办事；另一方面是可扩展、可自进化：通过技能（Skills）和插件接入 Gmail、日历、浏览器、Obsidian、智能家居等 50+ 集成，甚至能通过对话让它自己写新技能。再加上持久记忆（长期记住你的偏好与上下文）、主动触达（心跳、定时任务、提醒），让很多人觉得「像多了一个 24 小时在线的同事」。

• 跑在你自己的机器上：Mac / Windows / Linux 均可，数据默认留在本机，可选沙箱控制权限。
• 任意聊天应用即入口：飞书、WhatsApp、Telegram、Discord、Slack、iMessage 等，私聊、群聊都行。
• 持久记忆与人格：记住你是谁、你的习惯，越用越像「你的」助手。
• 浏览器与系统能力：可浏览网页、填表、抓数据；可读写信件、执行 shell、跑脚本（也可沙箱限制）。
• 技能与插件生态：用社区技能扩展能力，或自己写；助手甚至能根据你的描述自己写新技能。
• 主动与自动化：心跳检查、定时任务、提醒、后台跑批，真正「替你盯着」事情。

本文则介绍在 macOS 上本地安装 OpenClaw，并配置 通义千问（Qwen） OAuth、MiniMax 作为主模型，以及 飞书 作为对话渠道的完整步骤。

1. 环境要求
2. 安装 OpenClaw
3. 配置 Qwen 大模型
4. 飞书开发者后台配置应用
5. 在 OpenClaw 中配置飞书渠道
6. 启动与验证
7. 常见问题
8. 常用 OpenClaw 命令

• 操作系统：macOS 10.15+
• Node.js：18.x 或 22.x（推荐 22+）
• npm 或 yarn
• 可选：Homebrew（便于安装 Node）

检查 Node 版本：

node -v # 建议 >= 18.0.0 npm -v

若未安装 Node，可使用 Homebrew：

brew install node@22

在终端执行：

npm install -g openclaw@latest

安装完成后可用 openclaw -v 验证版本。

图：npm 安装 OpenClaw 及版本验证（若出现 deprecated 警告可忽略，不影响使用）

curl -fsSL https://clawd.bot/install.sh | bash

注意：使用脚本安装后，可能出现终端里输入 openclaw 提示「command not found」的情况，通常是因为安装路径未加入当前 shell 的 PATH。可尝试：

1. 新开一个终端窗口再执行 openclaw -v（若脚本写入了 ~/.zshrc / ~/.bash_profile，需重新加载）。
2. 手动加载配置：执行 source ~/.zshrc 或 source ~/.bash_profile 后重试。
3. 若仍找不到，可改用 方式一 用 npm install -g openclaw@latest 安装，一般能直接使用 openclaw 命令。

首次安装后执行设置向导，生成 ~/.openclaw/ 目录及默认配置：

openclaw setup

按提示选择或填写：

• 工作区目录（默认 ~/.openclaw/workspace 即可）
• 其他默认项可直接回车

图：setup 成功后会写入 openclaw.json、创建 workspace 与 sessions 目录

如需交互式完成「模型 + 渠道 + 技能」等全部配置，可再执行：

openclaw onboard

图：onboard 会提示安全须知，选择「Yes」继续；若已有配置会检测到现有 workspace

本指南推荐在 onboard 中依次完成：选择模型（Qwen）→ 选择渠道（飞书）→ 安装飞书插件 → 填写飞书凭证。也可只执行 openclaw setup，再按下面章节手动编辑 openclaw.json。

通义千问通过阿里云 DashScope 提供服务，并提供 OpenAI 兼容接口，OpenClaw 可直接使用。

重要：在 OpenClaw 中，Qwen 模型仅支持通过 OAuth 授权（即「Qwen Portal」方式），不支持使用阿里云 DashScope 的 API Key 配置。因此请通过 openclaw onboard 或 openclaw configure 在「Model/auth provider」步骤选择 Qwen (OAuth)，按提示在浏览器中完成登录与授权即可，无需也不要在 openclaw.json 里填写 Qwen 的 API Key。

图：onboard 中选择 Qwen (OAuth) 后，按提示完成授权即可。

图：Qwen OAuth 完成后，默认模型会设为 qwen-portal/coder-model。

若尚未配置，在终端执行 openclaw onboard 或 openclaw configure，在模型步骤选择 Qwen (OAuth) 并完成浏览器授权即可。

要在飞书中与 OpenClaw 对话，需要先在飞书开放平台创建企业自建应用，并完成应用能力（机器人）、权限openclaw 安装、事件接收方式等配置。以下按步骤说明，并配有后台截图。

1. 打开 飞书开放平台，使用飞书账号登录（需具备企业管理员或应用管理权限）。
2. 在应用列表中，选择 「企业自建应用」 标签（与「商店应用」并列）。
3. 点击页面中央的 「创建企业自建应用」 按钮。

图：飞书开放平台 — 选择「企业自建应用」后点击「创建企业自建应用」。个人版用户需注意：应用仅供本企业使用，发布需企业管理员审核。

4. 在弹窗或后续页面中填写：应用名称：如「OpenClaw 助手」或「My AI assistant」应用描述：可选应用图标：可选
5. 创建完成后会自动进入该应用的管理后台。

应用创建后，需要为应用添加机器人能力，才能以「机器人」身份在群聊和单聊中收发消息。

1. 在应用管理后台左侧，进入 「应用能力」 → 「添加应用能力」。
2. 在「按能力添加」下找到 「机器人」 卡片（带机器人图标、描述为与用户在聊天中交互的应用）。
3. 点击该卡片上的 「配置」 按钮（不要点「+ 添加」），进入机器人配置。

图：在「添加应用能力」页面，找到「机器人」能力并点击「配置」。

4. 按需填写机器人名称、描述等（可与应用名称一致），保存。保存后该应用即具备「机器人」能力，可在飞书中被添加到群聊或发起单聊。

在 OpenClaw 中配置飞书渠道时，必须填写该应用的 App ID 和 App Secret。

1. 在应用后台左侧进入 「凭证与基础信息」（或在「开发配置」相关入口）。
2. 在页面上可看到：App ID：直接显示，复制保存。App Secret：默认脱敏，点击「显示」或「重置」后复制，妥善保存，勿泄露。

后续在 openclaw configure 或手动编辑 openclaw.json 的
channels.feishu.accounts.main 时，会用到这两个值。

机器人要能接收消息、发送回复、读取群信息与用户信息，以及使用飞书文档等能力，必须在飞书后台开通对应系统权限。所需权限以 OpenClaw 官网 为准，以下为推荐配置（来源：OpenClaw 官网）。

1. 在应用后台左侧进入 「开发配置」 → 「权限管理」。
2. 在「权限配置」中按下面列表搜索并开通权限。飞书将权限分为 租户级（tenant） 与 用户级（user），请确保两类中的项都已勾选并申请。

租户级权限（tenant）：

用户级权限（user）：

完整权限结构（便于在飞书后台对照或批量配置）如下，可直接在权限管理中按这些标识搜索并开通：

{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "contact:user.employee_id:readonly", "corehr:file:download", "event:ip_list", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } } 

1. 开通后，在权限页顶部点击 「批量申请权限」 或 「申请权限」，提交后等待管理员审批。企业自建应用通常由本企业管理员审批，通过后权限即生效。

务必使用国内版飞书（开发者后台 – 飞书开放平台）。本步骤依赖在 「事件与回调」→「事件配置」 中选择 「使用 长连接 接收事件」，该能力仅在国内版飞书开放平台提供。国际版飞书（Lark 开放平台）不支持「使用长连接 接收事件」，仅支持 「将事件发送至 开发者服务器」 的订阅方式，即 Webhook：需要提供一个公网可访问的回调地址。对于本地安装的 OpenClaw 而言，将本机或内网服务暴露到公网以接收飞书回调会带来安全隐患，因此本指南以国内版飞书 + 长连接为准，不推荐在本地部署场景下使用国际版飞书或 Webhook 方式。

OpenClaw 与飞书对接时，使用 长连接（WebSocket） 接收事件，无需公网域名、无需配置 HTTP 回调 URL。

1. 登录 国内版飞书开放平台 open.feishu.cn，在应用后台左侧进入 「开发配置」 → 「事件与回调」。
2. 切换到 「事件配置」 标签。
3. 在「订阅方式」中选择 「使用 长连接 接收事件」（带「推荐」标识）。
4. 阅读说明：无需注册公网域名或配置加密策略，仅需使用官方 SDK 启动长连接客户端即可。
5. 点击 「保存」。

图：在「事件配置」中选择「使用长连接接收事件」并保存。

若使用国际版飞书（open.larksuite.com），则只能选择 「将事件发送至 开发者服务器」（Webhook），需在「回调配置」中填写公网请求地址，并在 OpenClaw 侧配置 connectionMode: “webhook” 及对应校验信息；如前所述，本地安装 OpenClaw 时暴露公网 endpoint 存在安全风险，本指南不推荐该方式。

1. 在应用后台左侧进入 「应用发布」 → 「版本管理与发布」。
2. 创建新版本，填写版本说明，提交审核。
3. 企业自建应用由本企业管理员审核，通过后即可在飞书内使用。
4. 发布后，在飞书客户端中可搜索应用名称，将机器人添加到群聊或发起单聊。

• 群聊：打开目标群 → 群设置 → 群机器人 → 添加机器人 → 搜索你的应用名称并添加。
• 单聊：在飞书顶栏或通讯录中搜索应用名称，发起与机器人的私聊。

完成以上步骤后，飞书侧配置即告完成；接下来在 OpenClaw 中配置飞书渠道（App ID、App Secret、域名、群聊策略等）。

从本节起，主模型选用 MiniMax；Qwen 已在第 3 节通过 OAuth 完成认证，可作为备选模型。请在配置飞书渠道的同时，将 MiniMax 设为主模型（在 configure 中选择 MiniMax 并完成认证，或在 openclaw.json 的
agents.defaults.model.primary 中设为 minimax/xxx）。

可通过 openclaw configure 向导配置，或直接编辑 openclaw.json。

在终端执行 openclaw configure，按提示：

1. 选用主模型（若尚未设置）：若在「Model/auth provider」步骤出现，选择 MiniMax（OAuth 或 API Key 按向导提示完成认证），将主模型设为 MiniMax；Qwen 已在前文通过 OAuth 配置，会作为备选存在。
2. Select a channel → 选择 Feishu/Lark (飞书)。
3. Install Feishu plugin? → 若为 OpenClaw 2026.2.6 及以上，飞书插件已内置，无需下载，可选 Skip for now；若向导仍提示下载且安装失败，见 7. 常见问题 中的「飞书插件」。
4. Feishu credentials：按提示打开 飞书开放平台，创建自建应用并获取 App ID、App Secret，在向导中粘贴。
5. Which Feishu domain? → 国内选 Feishu (feishu.cn) – China。
6. Group chat policy：选 Open – respond in all groups (requires mention) 或 Allowlist 按需。
7. Feishu DM policy：选 Open (public inbound DMs) 或 Allowlist 按需。

图：在 configure/onboard 中选择 Feishu/Lark 渠道。

图：选择从 npm 下载 @openclaw/feishu 插件。

填写 App ID、App Secret，选择飞书域名与群聊/私聊策略。

配置完成后会更新 openclaw.json，并给出 Web UI 与 Gateway 地址。

在 channels 中增加或修改 feishu 配置，填入飞书后台的 App ID 与 App Secret：

{ "channels": { "feishu": { "domain": "lark", "enabled": true, "dmPolicy": "open", "allowFrom": ["*"], "connectionMode": "websocket", "accounts": { "main": { "appId": "你的飞书AppID", "appSecret": "你的飞书AppSecret", "domain": "feishu", "enabled": true, "botName": "OpenClaw Bot" } } } } } 

说明：

• connectionMode: “websocket”：使用 WebSocket，无需公网 Webhook URL
• dmPolicy: “open”：允许任何人私聊机器人（可按需改为 allowlist 等）
• allowFrom: [“*”]：允许所有来源（可按需限制）
• botName：在飞书中显示的名称，可自定义

将 MiniMax 设为主模型（手动编辑时）：在 openclaw.json 的 agents.defaults.model 中设置 “primary”: “minimax/MiniMax-M2.1″（或你已配置的 MiniMax 模型 ID），fallbacks 可包含 “qwen-portal/coder-model” 等。保存后重启网关使主模型生效。

在 plugins → entries 中确保飞书插件已开启：

{ "plugins": { "entries": { "feishu": { "enabled": true } } } } 

保存 openclaw.json 后，飞书渠道即与主模型（本指南为 MiniMax）一起生效。请确保
agents.defaults.model.primary 为 MiniMax（如 minimax/MiniMax-M2.1），fallbacks 可包含 qwen-portal/coder-model 等已配置的 Qwen 模型。

方式一：安装为后台服务（推荐，开机自启）

openclaw gateway install openclaw gateway start

图：daemon install 会安装 LaunchAgent，日志位于
~/.openclaw/logs/gateway.log。

方式二：前台运行（便于看日志）

openclaw gateway

配置完成后，若提示「How do you want to hatch your bot?」，可选择 Open the Web UI 打开控制台。

图：可选择在 TUI 中操作或打开 Web UI。

浏览器访问 http://127.0.0.1:18789/ 可打开 OpenClaw Gateway Dashboard，查看通道、会话、配置等。

图：Dashboard 中可进行快捷对话、查看 Channels / Sessions 等。

新开一个终端：

openclaw doctor

可检查网关、渠道、模型等是否正常。

1. 在飞书中打开已添加机器人的群聊，或与机器人发起单聊。
2. 发送一条消息（如「你好」或「@OpenClaw-bot 你能干什么」）。
3. 若配置正确，OpenClaw 会使用已配置的主模型（本指南为 MiniMax）回复。

图：在飞书中与 OpenClaw-bot 对话，验证配置是否生效。

若未回复，可查看网关日志：

openclaw logs # 或 tail -f ~/.openclaw/logs/gateway.log

自 OpenClaw 2026.2.6 起，飞书插件已内置，无需再执行 openclaw plugins install @openclaw/feishu 或从 npm 下载。插件随 OpenClaw 一起安装，位于 OpenClaw 的安装目录内（例如通过 nvm 安装 Node 时，路径类似
~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw 下的 extensions/feishu）。只要在 openclaw.json 的 plugins.entries 中启用 “feishu”: { “enabled”: true } 即可使用，
不用单独下载。

若你使用 早于 2026.2.6 的版本，或 configure 时仍提示「Install Feishu plugin?」并选择了「Download from npm」，可能出现「Installing plugin dependencies… npm install failed」（多为插件包内 devDependencies 使用 workspace:* 导致）。建议：升级到 2026.2.6 及以上后使用内置插件；若暂不升级，可按以下方式处理已下载到
~/.openclaw/extensions/feishu 的插件：

图：旧版本或从 npm 安装时可能出现的依赖错误与安全提示。

1. 进入插件目录：cd ~/.openclaw/extensions/feishu。
2. 用编辑器打开 package.json，删除 devDependencies 中的 “openclaw”: “workspace:*” 一行（或整段 devDependencies 若仅此项）。
3. 在该目录执行：npm install。
4. 在 openclaw.json 的 plugins.entries 中确保 “feishu”: { “enabled”: true }，重启网关。

安装时的「dangerous code patterns」为静态安全提示，官方飞书插件会访问环境与网络，若来源可信可忽略。

• 确认 channels.feishu.enabled 为 true，且 accounts.main 的 appId、appSecret 与开放平台一致
• 确认应用已发布且机器人已加入对应群或已发起单聊
• 确认权限已开通并生效（含「以应用身份发消息」等）
• 查看 gateway.log 是否有鉴权或网络错误

• 若主模型为 MiniMax：检查 MiniMax 的 API Key 或 OAuth 凭证是否正确、未过期；确认 agents.defaults.model.primary 为已配置的 MiniMax 模型（如 minimax/MiniMax-M2.1）。
• 若使用 Qwen 作为主模型或备选：确认 Qwen 已通过 OAuth 配置（qwen-portal），且 primary 或 fallbacks 为 qwen-portal/coder-model 等有效 provider/model-id。
• 确认对应提供商的 baseUrl（若有）与地域一致。

在 openclaw.json 的 agents.defaults.model 中修改 primary 与 fallbacks，例如：

• 主模型用 MiniMax：”primary”: “minimax/MiniMax-M2.1″，备选可写 “fallbacks”: [“qwen-portal/coder-model”, “qwen-portal/vision-model”]。
• 主模型用 Qwen：”primary”: “qwen-portal/coder-model”，备选可写 “fallbacks”: [“minimax/MiniMax-M2.1”]。

• 主配置：~/.openclaw/openclaw.json
• 工作区（技能、AGENTS.md 等）：默认 ~/.openclaw/workspace

在飞书后台配置事件订阅 URL，并在 OpenClaw 的 feishu 配置中设置 connectionMode: “webhook” 及对应 URL 与校验参数（具体以当前版本文档为准）。

日常使用与排错时常用命令如下（在终端执行，openclaw 需已安装并在 PATH 中）。

更多子命令与参数可执行 openclaw –help 或 openclaw <子命令> –help 查看。

• OpenClaw 官网 / 文档]: OpenClaw — Personal AI Assistant
• 飞书开放平台: 飞书开放平台
• MiniMax 开放平台(国内版): 概览 – MiniMax 开放平台文档中心
• 阿里云百炼 / DashScope（Qwen）（OAuth 备选模型）: 阿里云登录 – 欢迎登录阿里云，安全稳定的云计算服务平台