OpenClaw本地部署指南：在闲置Mac上运行AI助手并集成飞书插件

近日，OpenClaw 在技术社区中备受关注，它本质上是一个能帮你自动操作电脑的 AI Agent。这意味着，只要是你能在电脑上完成的任务，它都有潜力帮你自动化执行。OpenClaw 有几个非常吸引人的特点：

• 本地执行，拒绝云端依赖：它能直接调用 Shell 命令、操作本地文件、控制浏览器。你一句话，它就能帮你整理杂乱的下载文件夹，或是完成一些重复性的办公操作。
• 全渠道交互：你无需在本地安装额外的 App，通过 Telegram、WhatsApp、Slack，甚至是国内常用的飞书，就能随时随地给家里的电脑下达指令。

恰好我手头有一台闲置的旧 Mac，正好可以用来尝试在本地部署 OpenClaw。整个过程主要分为三个步骤：

1. 准备安装环境（安装 Docker、Git、Node.js）
2. 安装与配置 OpenClaw 核心服务
3. 安装并配置飞书插件，实现移动端交互

下面，我们就按这个流程一步步来操作。

准备安装环境

首先，请务必确认你的 macOS 版本。因为我的 Mac 型号较老，所以对版本兼容性会特别注意。

1. 安装 Node.js：通过官方安装包安装是最直接简单的方式。访问 Node.js 官网的下载页面：https://nodejs.org/en/download/，点击页面中 macOS 对应的 .pkg 安装包。推荐选择 “LTS 稳定版”，适合大多数生产场景。

2. 安装 Git：访问 Git 官网下载页面：https://git-scm.com/download/mac，下载适用于 macOS 的安装包（通常是 .dmg 文件）。
3. 安装 Docker：这里需要特别注意，务必选择与你的 macOS 版本相匹配的 Docker Desktop 版本，否则版本过低可能导致后续操作失败。Docker 的安装对于后续的容器化部署至关重要。

你可以在 Docker 官网的发布日志中找到各个版本的下载地址。上图展示的是我当时使用的 Docker Desktop 版本 (4.26.0)，可供参考。

安装与配置 OpenClaw

环境准备好后，我们就可以开始部署 OpenClaw 了。首先，将项目仓库克隆到本地，并进入项目目录。

git clone https://github.com/openclaw/openclaw
cd openclaw

接着，执行项目提供的 Docker 初始化设置脚本。

./docker-setup.sh

脚本执行完毕后，如果终端出现类似下图的界面，就说明 OpenClaw 的核心服务已经成功安装并启动。

接下来是初始化配置向导。首先，我们选择 QuickStart 快速启动模式。

然后是选择大模型提供商。这里我选择了 MiniMax，如果你是首次使用，通常可以获得免费的 API 调用额度。

最后，向导会提示你选择一个即时通讯工具来连接 AI 助手。由于我们的目标是配置飞书，所以这里直接选择跳过 (Skip for now)，我们后续会手动添加飞书频道。

配置完成后，理论上可以通过控制台 UI 进行交互了。但此时如果直接打开 UI 界面，可能会遇到如下报错：

disconnected (1008): unauthorized: gateway token missing (set gateway.remote.token to match gateway.auth.token)

我在查阅了相关的 GitHub Issues 后，发现需要在配置文件中和 UI 界面上同步设置 gateway token。

解决方法如下。首先，创建一个本地的配置文件 openclaw.json，请将以下命令中的 your-actual-token 替换为你自己的 gateway token。

cat > /Users/mac/openclaw/openclaw.json << 'EOF'
{
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "agents": {
    "defaults": {
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "compaction": {
        "mode": "safeguard"
      },
      "workspace": "/home/node/.openclaw/workspace",
      "models": {
        "minimax/MiniMax-M2.1": {
          "alias": "Minimax"
        }
      },
      "model": {
        "primary": "minimax/MiniMax-M2.1"
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "your-actual-token"
    },
    "controlUi": {
      "dangerouslyDisableDeviceAuth": true
    },
    "port": 18789,
    "bind": "loopback",
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "auth": {
    "profiles": {
      "minimax:default": {
        "provider": "minimax",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.io/anthropic",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 15,
              "output": 60,
              "cacheRead": 2,
              "cacheWrite": 10
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "wizard": {
    "lastRunAt": "2026-02-01T21:57:50.734Z",
    "lastRunVersion": "2026.1.30",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "meta": {
    "lastTouchedVersion": "2026.1.30",
    "lastTouchedAt": "2026-02-01T21:57:50.747Z"
  }
}
EOF

然后，将这个配置文件复制到正在运行的 Docker 容器中，并重启网关服务。

docker cp /Users/mac/openclaw/openclaw.json openclaw-openclaw-gateway-1:/home/node/.openclaw/openclaw.json
docker-compose restart openclaw-gateway

同时，在控制台 UI 的 Gateway Access 设置页面，也需要填入相同的 token。

完成以上步骤后，通过以下 URL 访问控制台（请替换 your-token），应该就能正常进入了。

http://127.0.0.1:18789/?token=your-token

在聊天界面尝试发送一条消息，如果收到 AI 助手的回复，就证明 OpenClaw 核心服务已部署成功！

安装与配置飞书插件

为了让 AI 助手能通过飞书与我们交互，我们需要为其安装飞书插件。一个重要前提是：你需要一个飞书企业版账号（非个人版）。注册时填写的信息可以不是真实公司信息，关键在于你的账号信息里需要显示一个“公司名称”。

为什么选择飞书？对于国内网络环境来说，飞书访问顺畅。更重要的是，你可以在飞书群里直接 @机器人来指挥 OpenClaw 干活，无需一直盯着电脑终端，用手机也能随时随地发号施令。

第一步：创建飞书自建应用

1. 登录 飞书开放平台，进入开发者后台。
2. 点击创建企业自建应用。

3. 填写应用的基本信息，如应用名称、描述，并上传图标。

第二步：为应用添加机器人能力与权限

1. 在应用管理的“应用能力”页面，点击添加能力，选择机器人。

2. 在“开发配置” -> “权限管理”页面，点击批量导入/导出权限。

3. 在导入界面，将以下 JSON 配置粘贴进去，然后点击“下一步，确认新增权限”。

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ]
  }
}

4. 最后，点击“申请开通”这些权限。

第三步：获取应用凭证

权限申请开通后，进入“凭证与基础信息”页面，记下你的 App ID 和 App Secret。这两个信息在下一步配置飞书插件时会用到。

第四步：在 OpenClaw 中安装并配置飞书插件

1. 回到 Mac 的终端，在 OpenClaw 项目目录下，运行以下命令安装飞书插件。

docker compose run --rm openclaw-cli plugins install @m1heng-clawd/feishu

2. 安装完成后，需要修改 OpenClaw 的配置文件。配置文件通常位于 ~/.openclaw/openclaw.json。使用文本编辑器打开它，在 channels 配置段中添加飞书的配置。请将 your-appId 和 your-appSecret 替换为你刚刚记下的凭证。

"channels": {
  "feishu": {
    "appId": "your-appId",
    "appSecret": "your-appSecret",
    "domain": "feishu",
    "connectionMode": "websocket",
    "dmPolicy": "pairing",
    "groupPolicy": "open",
    "requireMention": true,
    "enabled": true,
    "mediaMaxMb": 30,
    "renderMode": "auto"
  }
},

3. 保存配置文件后，重启 OpenClaw 的网关服务以使配置生效。

docker compose restart openclaw-gateway

第五步：在飞书后台配置事件订阅

为了让飞书机器人能接收到用户消息并转发给 OpenClaw，我们需要配置事件订阅。

1. 在飞书开放平台的应用管理页面，进入“事件与回调” -> “事件配置”。

2. “订阅方式”选择使用长连接接收事件（推荐），然后点击保存。

3. 点击添加事件，在事件列表中找到并选择“接收消息 v2.0 (im.message.receive_v1)”。

4. 完成所有配置后，页面会提示创建版本。请务必创建并发布一个版本，所有修改的配置只有在版本发布后才会生效。

第六步：测试飞书机器人

版本发布成功后，你的飞书（手机端或PC端）通常会收到一条“应用发布成功”的通知。点击“打开应用”，就可以开始与你的 OpenClaw 机器人对话了。

尝试在飞书聊天窗口中 @机器人 或直接给它发消息。如果配置一切正确，你不仅能在飞书中收到回复，在 OpenClaw 的本地控制台界面也能同步看到对话记录。

至此，你已经成功在闲置的 Mac 上部署了 OpenClaw 这个强大的 AI Agent，并集成了飞书插件，实现了通过手机随时随地指挥“电脑助手”的能力。这个组合为自动化办公、智能文件管理、信息查询等场景提供了极大的想象空间。如果你在部署过程中遇到其他问题，可以到 云栈社区 的 开源实战 或 人工智能 板块与更多开发者交流探讨。