OpenClaw 本地部署并接入飞书
OpenClaw 是一款开源、可本地部署的AI智能体(AI Agent)工具,由奥地利开发者 Peter Steinberger 开发。它能“寄生”在聊天工具中,用户通过聊天发送指令,它就能直接操控电脑并完成任务,实现从“思考”到“行动”的闭环。至于它比 ChatGPT、豆包之类的强在哪?简单来说,ChatGPT 是个“陪聊”,而龙虾是个“替身”。它不仅仅是吐出文字,而是真的能接管你的电脑和软件,比如执行系统命令、浏览网页、管理文件,甚至编写代码。🦀🦀🦀
准备工作
- 资源规划
| ip地址 | 硬件配置 | OS版本 | 大模型 | 聊天工具 |
|---|---|---|---|---|
| 192.168.31.101 | 4核-8G-40G | Ubuntu 24.04.3 | Minimax | 飞书 |
- 选哪个大模型最省钱?目前市面上的模型五花八门,首推 Minimax(新人完成认证领取15元代金券)> 千问
- 接什么聊天工具最香?目前国内工具虽然多,首推 飞书 > 钉钉/企业微信,不建议微信(容易封号,懂的都懂)、WhatsApp及Telegram(需科学上网)
配置大模型 Minimax
- 登录 Minimax 官网,注册新账号并完成认证,自动到账15元代金券
配置IM工具 飞书
- 第1步,打开 飞书开放平台,依次点击 开发者后台 -> 创建企业自建应用,填写应用名称及应用描述
- 第2步,待自建应用创建之后,添加机器人
- 第3步,复制应用凭证的 App ID 及 App Secret,后面与 OpenClaw 关联会用到
- 第4步,开通权限,在“消息与群组”中选择所有应用身份权限(tenant_access_token)并确认开通(缺了这一步,你给机器人发消息会没有回复)
- 第5步,创建版本并发布,登录飞书客户端,确认审批已通过,示例应用版本号 1.0.0
安装 OpenClaw 并接入飞书
- 第1步,使用官方一键安装脚本(推荐),它会自动检测或安装 Node.js v22.22.1 和 Git 2.43.0,然后通过 npm 下载并安装 OpenClaw v2026.3.12
注:如果安装报错 ! npm install failed; 可重试几遍
#.官方一键安装
curl -fssL https://openclaw.ai/install.sh | bash
- 第2步,通过 ↑ ↓ ← → 键进行选择,以下示例 大模型选择 MiniMax、聊天工具选择 飞书
T OpenClaw onboarding
|
o I understand this is ****** Continue? 询问是否知道风险,通过 ← → 键,选择 Yes
| Yes
|
o Onboarding mode 初始化配置模式,示例选择 QuickStart(快速开始)
| QuickStart
|
o Model/auth provider 配置AI模型提供商,示例选择 MiniMax
| MiniMax
|
o MiniMax auth method 配置认证方式,示例选择 MiniMax CN — OAuth
| MiniMax CN — OAuth (minimaxi.com)
|
• Starting MiniMax OAuth (CN)…|
o MiniMax OAuth ---------------------------------------------------------------------------+
| |
| Open https://platform.minimaxi.com/oauth-authorize?user_code=0PgNAMxWsj&client=OpenClaw | 浏览器打开并点击“授权”
| to approve access. |
| If prompted, enter the code 0PgNAMxWsj. |
| Interval: 1000, Expires at: 1773372011657 unix timestamp |
| |
+-------------------------------------------------------------------------------------------+
|
o Default model 配置默认模型,示例选择 Keep current
| Keep current (minimax-portal/MiniMax-M2.5)
|
o Select channel (QuickStart) 配置聊天工具,示例选择 飞书
| Feishu/Lark (飞书)
|
o Install Feishu plugin? 如何安装飞书插件,示例选择 通过npm下载
| Download from npm (@openclaw/feishu)
|
o How do you want to provide this App Secret? 如何提供 App Secrect,示例选择 Enter App Secret
| Enter App Secret
|
o Enter Feishu App Secret 配置飞书应用的 App Secrect,请将 445566 替换为您的 App Secrect
| 445566
|
o Enter Feishu App ID 配置飞书应用的 App ID,请将 112233 替换为您的 App ID
| 112233
|
o Feishu connection mode 配置飞书的连接模式,示例选择 WebSocket
| WebSocket (default)
|
o Which Feishu domain? 配置飞书的区域,示例选择 中国
| Feishu (feishu.cn) - China
|
o Group chat policy 配置群聊策略,示例选择 Open(完全开放)
| Open - respond in all groups (requires mention)
|
o Search provider 配置搜索引擎,示例选择 Skip for now(稍后设置)
| Skip for now
|
o Configure skills now? (recommended) 是否现在配置skills,示例选择 Yes
| Yes
|
o Install missing skill dependencies 配置预装的skill依赖,按空格键打上 + 表示选中,示例选择 oracle
| oracle
|
o Preferred node manager for skill installs 配置以何种方式安装skills,示例选择 npm
| npm
|
o Set GOOGLE_PLACES_API_KEY for goplaces? 是否配置指令,推荐全部选择 No
| No
|
o Set GEMINI_API_KEY for nano-banana-pro? 是否配置指令,推荐全部选择 No
| No
|
o Enable hooks? 是否启用 hooks,示例选择 session-memory
| session-memory
|
o How do you want to hatch your bot? 如何训练机器人,示例选择 Open the Web UI
| Open the Web UI
|
— Onboarding complete. Use the dashboard link above to control OpenClaw.
- 第3步,确认配置文件(openclaw.json)中
"channels": { ... }中的内容
cat ~/.openclaw/openclaw.json | grep -A 10 "channels"
设置飞书回调与对话
- 第1步,事件配置,“订阅方式”选择“使用长连接接收事件”,“添加事件”选择“接收消息”(im.message.receive_v1)
注:必须先启动 OpenClaw 才能配置事件的订阅方式
- 第2步,开通权限,在“通讯录”中选择“获取通讯录基本信息”(contact:contact.base:readonly)
- 第3步,每次修改配置后都需要重新发布一个版本,示例应用版本号 1.0.1
- 第4步,打开飞书客户端,搜索 OpenClaw 并进行对话,第一次使用 OpenClaw 会发生一个编码让我们确认配对
- 第5步,登录服务器,执行聊天内容的最后一段脚本
root@ubuntu:~# openclaw pairing approve feishu HRPFVBD7
......
18:03:46 [plugins] feishu_bitable: Registered bitable tools
Approved feishu sender ou_6be3bab6ea3012aa9899750c506963a2.
- 第6步,返回飞书聊天窗口,再次对话就正常了
至此,OpenClaw 顺利配置完成










