手把手教你本地部署 OpenClaw + 接入飞书机器人（全平台适配）
OpenClaw 是一款功能强大的终端式 AI 助手，支持多模型适配、多渠道接入，可本地部署也支持云端一键安装。折腾了两天，终于把本地部署 + 飞书机器人跑通了，写篇文章记录一下完整流程，希望能帮到有同样需求的朋友。
相关链接：
- 官网：openclaw.ai
- GitHub：http://github.com/openclaw/op...
- 部署方式：本地部署（本文重点）、云端一键安装（阿里云/火山引擎/MiniMax 均支持）、Docker 镜像
本文适配 macOS / Linux / Windows 三端，内容涵盖从环境搭建到飞书机器人上线的全流程。
留个入口，ChatGPT Plus可以接入OpenClaw使用了，比API更加的划算：
🔥如果你还是免费用户,可以通过以下方式升级，亲测靠谱:
- 国内自助升级 ChatGPT Plus 工具:国内自助升级 ChatGPT Plus 网站
- 具体的开通教程:国内如何开通订阅ChatGPT Plus会员(支付宝微信代充值亲测有效)
一、准备工作：安装基础环境
OpenClaw 运行依赖 Node.js 24+ 和 Git ，Node.js 安装包自带 npm，不用单独装。Windows 用户注意：全程以管理员身份打开 PowerShell。
1. 安装 Node.js
方式一：官方下载（推荐新手）
前往 http://nodejs.org，选 LTS v24+ 稳定版本，页面会自动识别你的系统。安装时默认选项就行，务必勾选 Add to PATH。
方式二：包管理器安装（macOS/Linux 开发者推荐）
macOS 需要先装 Homebrew，然后：
brew install node
brew link node --overwrite --force国内下载慢的话，配一下淘宝镜像：
npm config set registry https://registry.npmmirror.com/2. 安装 Git
官方下载地址：http://git-scm.com，安装时勾选 Add Git to PATH。
包管理器安装：
# macOS
brew install git
# Linux（Debian/Ubuntu）
sudo apt install -y git
# Linux（CentOS/RHEL）
sudo dnf install -y git3. 验证安装（别跳过这步）
打开终端，依次执行以下命令，能输出版本号就说明装好了：
node -v
npm -v
git --version补充：Git 装好后可以顺手配一下全局用户信息，避免后续某些操作报错：
git config --global user.name "你的用户名"git config --global user.email "你的邮箱"
二、安装 OpenClaw
macOS / Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
npm i -g openclawWindows（PowerShell 管理员身份）：
iwr -useb https://openclaw.ai/install.ps1 | iexmacOS/Linux 如果遇到权限报错，命令前加
sudo即可。
三、交互式配置（跟着选就行）
安装完成后会自动进入交互式配置流程，下面是每一步的推荐选择：
- 确认风险提示 → 选 Yes，确认并继续
- Onboarding mode → 选 QuickStart，新手友好
- Model/auth provider → 选免费 Qwen 或 Skip for now，推荐先选 Qwen
- Filter models by provider → 选 All providers
- Default model → 保持默认就行
- Select channel → 选 Skip for now，后面单独配飞书
- Configure skills now? → 选 No，按需再加
- Enable hooks? → 按空格键选中，再按回车，支持命令日志、会话记忆
- How to hatch your bot? → 选 Hatch in TUI，从终端启动
四、配置模型（以免费 Qwen 为例）
这一步是核心。提供两种方式，新手推荐用 Web UI，开发者可以直接改配置文件。
前置准备： 先去百炼控制台（http://bailian.console.aliyun.com/cn-beijing/）拿到你的 Qwen API Key。
方式一：Web UI 配置（推荐新手）
启动 Web UI：
openclaw dashboard浏览器会自动弹出页面。然后依次进入 Settings → Config → Authentication → 底部切换到 Raw 模式。
第一步：配置 models.providers
把下面的内容粘贴进去，记得把 <QWEN_API_KEY> 换成你自己的：
"models": {
"providers": {
"qwen-portal": {
"baseUrl": "https://portal.qwen.ai/v1",
"apiKey": "<QWEN_API_KEY>",
"api": "openai-completions",
"models": [
{
"id": "coder-model",
"name": "Qwen Coder",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 8192
},
{
"id": "vision-model",
"name": "Qwen Vision",
"reasoning": false,
"input": ["text", "image"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
}第二步：配置 auth.profiles
"auth": {
"profiles": {
"qwen-portal:default": {
"provider": "qwen-portal",
"mode": "oauth"
}
}
}第三步：配置 agents.defaults
<你的工作空间目录> 替换为实际路径，macOS/Linux 一般是 /Users/你的用户名/.openclaw/workspace，Windows 是 C:\Users\你的用户名\.openclaw\workspace（不存在会自动创建）：
"agents": {
"defaults": {
"model": { "primary": "qwen-portal/coder-model" },
"models": {
"qwen-portal/coder-model": { "alias": "qwen" },
"qwen-portal/vision-model": {}
},
"workspace": "<你的工作空间目录>",
"compaction": { "mode": "safeguard" },
"maxConcurrent": 1,
"subagents": { "maxConcurrent": 2 }
}
}第四步（可选）：配置命令黑名单
防止机器人执行摄像头、录屏等高危操作：
"nodes": {
"denyCommands": [
"camera.snap", "camera.clip", "screen.record",
"calendar.add", "contacts.add", "reminders.add"
]
}最后点右上角 Save 保存，再点 Update 更新。终端跑一下验证：
openclaw config validate没报错就说明配好了。
方式二：终端直接编辑配置文件
打开配置文件：
# macOS/Linux
nano ~/.openclaw/openclaw.json
# Windows
notepad $HOME/.openclaw/openclaw.json下面是完整配置模板，直接复制粘贴进去，改掉 <QWEN_API_KEY> 和 <你的工作空间目录> 就行（配置较长，建议直接复制使用）：
{
"meta": {
"lastTouchedVersion": "2026.2.25",
"lastTouchedAt": "2026-02-26T12:51:37.823Z"
},
"wizard": {
"lastRunAt": "2026-02-26T12:51:37.794Z",
"lastRunCommand": "doctor",
"lastRunVersion": "2026.2.25",
"lastRunMode": "local"
},
"auth": {
"profiles": {
"qwen-portal:default": {
"provider": "qwen-portal",
"mode": "oauth"
}
}
},
"models": {
"providers": {
"qwen-portal": {
"baseUrl": "https://portal.qwen.ai/v1",
"apiKey": "<QWEN_API_KEY>",
"api": "openai-completions",
"models": [
{
"id": "coder-model",
"name": "Qwen Coder",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 8192
},
{
"id": "vision-model",
"name": "Qwen Vision",
"reasoning": false,
"input": ["text", "image"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": { "primary": "qwen-portal/coder-model" },
"models": {
"qwen-portal/coder-model": { "alias": "qwen" },
"qwen-portal/vision-model": {}
},
"workspace": "<你的工作空间目录>",
"compaction": { "mode": "safeguard" },
"maxConcurrent": 1,
"subagents": { "maxConcurrent": 2 }
},
"messages": { "ackReactionScope": "group-mentions" },
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true,
"ownerDisplay": "raw"
},
"session": { "dmScope": "per-channel-peer" },
"gateway": {
"mode": "local",
"port": 18789,
"bind": "loopback",
"auth": { "mode": "token", "token": "__OPENCLAW_REDACTED__" },
"tailscale": { "mode": "off", "resetOnExit": false },
"nodes": {
"denyCommands": [
"camera.snap", "camera.clip", "screen.record",
"calendar.add", "contacts.add", "reminders.add"
]
}
}
}
}保存后验证并重启：
openclaw config validate
openclaw gateway restart五、基础使用
两种交互方式，功能一致，看个人喜好。
Web UI（推荐）：
openclaw dashboard核心功能都在页面上：Chat 对话、Settings 配置、Plugins 插件管理。
TUI 终端交互（轻量无浏览器）：
openclaw tui常用命令：
/status # 查看网关状态
/help # 查看所有命令
/exit # 退出 TUI
/model # 切换模型正常状态：
/status显示Runtime: running、RPC probe: success，没有报错就说明一切正常。
六、接入飞书机器人（重头戏）
完成基础配置后就可以接飞书了，分四步走。
步骤一：安装飞书插件
四种方式，按顺序试：
方式1：官方命令（推荐）
openclaw plugins install @m1heng-clawd/feishu方式2：手动下载（方式1失败时用）
curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
openclaw plugins install ./feishu-0.1.3.tgz方式3：在 Chat 里对话安装
在 TUI 或 Web UI 的 Chat 界面发送以下内容（替换 App ID 和 App Secret，这两个值在步骤二创建飞书应用后获取）：
帮我安装飞书插件：https://github.com/AlexAnys/openclaw-feishu
我的飞书应用配置信息如下：
App ID: <App ID>
App Secret: <App Secret>方式4： 直接在 openclaw config 界面选择 feishu 插件安装，新版最便捷。
步骤二：创建飞书企业自建应用
- 登录飞书开放平台（http://open.feishu.cn），进入开发者后台
- 点击创建企业自建应用，填好名称（如"OpenClaw机器人"）和描述
- 进入 基础信息 → 凭证与基础信息 ，记下 App ID 和 App Secret
- 重要： 进入 测试企业和人员，添加测试人员和测试群组。发布前只有测试对象才能用机器人，不加这一步会导致测试时无法使用
步骤三：在 OpenClaw 中配置飞书参数
如果你用了上面的方式3或方式4安装插件，这步可以跳过，已经自动配好了。
终端逐行执行，替换 <App ID> 和 <App Secret>：
openclaw config set channels.feishu.appId "<App ID>"
openclaw config set channels.feishu.appSecret "<App Secret>"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true然后重启网关：
openclaw gateway restart步骤四：配置飞书权限与事件订阅
回到飞书开发者后台，对当前应用做以下配置，每步都要记得保存：
1）添加机器人能力
左侧菜单 → 应用能力 → 添加应用能力 → 选择"机器人"并添加。
2）填写机器人说明
在机器人配置区域，点击"如何开始使用"旁边的编辑按钮，加一段简单说明（比如"OpenClaw AI机器人，输入问题即可解答"）。
3）配置事件订阅
左侧菜单 → 开发配置 → 事件与回调 → 订阅方式选择**"使用长连接接收事件"**并保存。
4）添加消息接收事件
点击"添加事件"，搜索 im.message.receive_v1，添加该事件并确认开通对应权限。
5）开通核心权限
左侧菜单 → 开发配置 → 权限管理：
- 应用身份权限： 搜索
im:message，全部选中并开通 - 用户身份权限： 搜索
contact:user.base:readonly，选中并开通
6）发布应用
顶部菜单 → 应用发布 → 版本管理与发布 → 创建新版本，填写更新说明后发布。企业自建应用发布后直接生效，不需要平台审核。
七、飞书配对授权（最后一步！）
机器人配好了还不能直接用，需要完成配对授权。
第一步：获取配对码
在飞书里给机器人发一条消息（随便发个"测试"就行），机器人会回复类似这样的内容：
OpenClaw: access not configured. Your Feishu user id: ou_fxxxxxx
Pairing code: xxxx
Ask the bot owner to approve with: openclaw pairing approve feishu xxxx第二步：终端执行配对
openclaw pairing approve feishu xxxx看到 Pairing approved successfully 就成功了。
第三步：重启网关
openclaw gateway restart第四步：验证
再去飞书给机器人发条消息，能正常回复就大功告成了。
如果还是提示权限问题，等 2-3 分钟再试，飞书权限同步有延迟。群聊里需要 @机器人 才会响应，单聊直接发就行。
补充说明：配对完成后在 Web UI 中会看到两个会话：main（本地基础会话）和 fe-xxx（飞书会话），可以自由切换查看。
