跳到主要内容在本地 Mac 上从零部署 OpenClaw AI Agent 教程 | 极客日志JavaScriptNode.jsAI
在本地 Mac 上从零部署 OpenClaw AI Agent 教程
详细记录了在 Mac 本地部署 OpenClaw AI Agent 的全过程。首先配置 Node.js、Git 及 Docker 环境；其次克隆仓库并运行初始化脚本，选择 MiniMax 大模型进行配置；针对 Gateway Token 报错问题提供了解决方案，通过同步配置文件中的 token 与 UI 界面设置来修复连接；最后演示了如何注册飞书企业应用并安装 OpenClaw 飞书插件，实现通过飞书群聊机器人远程控制本地电脑执行任务。
字节跳动15K 浏览 前言
OpenClaw 是一个可以帮你自动操作电脑的 AI Agent，你能用电脑干什么他就能帮你做什么。OpenClaw 有以下的特点：
- 本地执行，拒绝云端依赖：它能直接调用 Shell 命令、操作本地文件、控制浏览器。你一句话，它就能帮你整理下载文件夹，或者自动化办公。
- 全渠道交互：无需额外安装 App，通过 Telegram、WhatsApp、Slack，甚至国内常用的飞书，就能随时随地给家里的电脑下达指令。
正好家里面有一台闲置的旧 Mac，刚好能尝试在本地部署一下。大致来讲需要的步骤有：
- 准备安装环境（docker、git、nodejs）
- 安装与配置 OpenClaw
- 安装与配置飞书插件
准备安装环境
这里需要注意一下自己的 macOS 版本！因为我的闲置 Mac 比较老，所以需要注意。
-
安装 nodejs：官方安装包安装是最简单直接的方式。打开 nodejs 官网：https://nodejs.org/en/download/，点击页面中 macOS 对应的 .pkg 安装包。推荐选'LTS 稳定版'，适合大多数场景。
-
安装 git：访问 git 官网下载页面：https://git-scm.com/download/mac，下载适用于 macOS 的安装包（.dmg 文件）。
-
安装 docker：注意 macOS 版本对应的 docker，否则版本太低后续的有些操作会失败。
Docker Desktop 下载地址与我用的 Docker Desktop 版本如上，可以参考一下。
https://www.docker.com/products/docker-desktop/
安装与配置 OpenClaw
先把 git 仓库 clone 到本地，完成后进入 openclaw 文件夹。
微信扫一扫，关注极客日志
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
- Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
- Escape 与 Native 编解码
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
- JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
- JavaScript 压缩与混淆
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
git clone https://github.com/openclaw/openclaw
cd openclaw
继续执行以下命令来启动脚本完成 docker 初始化设置：
出现以下的界面后，就说明是安装完成了：
之后就是配置的选择了。首先选择 QuickStart：
大模型的配置可以按照需求实际来选择。这里我选择 MiniMax，如果是首次使用可以获得免费的 token 额度。
最后需要你选择一个聊天工具，因为我们例子使用的是飞书，所以直接跳过。
但是现在如果打开控制的 UI 界面，可能会有报错：
disconnected (1008): unauthorized: gateway token missing (set gateway.remote.token to match gateway.auth.token)
需要修改配置文件，将上面的 token 换成自己的 gateway token 就行。
cat > ~/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-gateway-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 cp ~/openclaw/openclaw.json openclaw-openclaw-gateway-1:/home/node/.openclaw/openclaw.json
docker-compose restart openclaw-gateway
在 Gateway Access 处也需要填写 token：
http://127.0.0.1:18789/?token=your-token
进入页面之后，尝试给模型发一条消息，如果有回复就说明是成功了：
安装与配置飞书插件
注意！这里需要先注册飞书企业版，而不是个人版，注册时填的信息不是准确的也没关系。
可以怎么判断呢？看一看自己的账号信息是不是有公司名称就可以，如上图所示。
为什么要用飞书呢？首先用的是国内网络环境，其次在飞书群里 @机器人，可以直接指挥 OpenClaw 干活；同时不需要开着电脑盯着终端，手机也能可以发指令。
{
"scopes": {
"tenant": [
"im:message",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:message:send_as_bot",
"im:resource"
]
}
}
docker compose run --rm openclaw-cli plugins install @m1heng-clawd/feishu
- 然后需要将之前App ID、App Secret放在配置文件中。首先需要编辑配置文件：
vim ~/.openclaw/openclaw.json
"channels": {
"feishu": {
"appId": "your-appId",
"appSecret": "your-appSecret",
"domain": "feishu",
"connectionMode": "websocket",
"dmPolicy": "pairing",
"groupPolicy": "open",
"requireMention": true,
"enabled": true,
"mediaMaxMb": 30,
"renderMode": "auto"
}
},
docker compose restart openclaw-gateway
最后的完整配置如下，会有创建版本的提示，不要忘记发布版本：
- 保存成功后，手机端的飞书会给你发一个消息。点击打开应用：
之后如果可以给机器人发消息，而且电脑端也有显示，就说明是成功了。
