效率起飞:OpenClaw + Ollama + 飞书私聊机器人搭建全流程(含避坑)

虽迟但到！观望了很久，也是因为没啥时间，难得得闲，立马装上 OpenClaw + Ollama + 飞书，效率起飞。

0. 总览

目标：运行 Ollama 模型，用 OpenClaw 接入飞书私聊机器人（WebSocket 长连接）。
关键点：

App Secret 属于敏感信息：只放本地环境变量/凭据引用，不要发给任何人
飞书后台每次改配置后都要发布，否则不生效
设置完环境变量后必须新开 PowerShell，并在 OpenClaw 写入配置后重启 daemon

1. 安装 Ollama & OpenClaw

1.1 安装 Ollama

Ollama 直接下载安装：

https://ollama.com/download

1.2 安装 OpenClaw

OpenClaw 一键安装：

ollama launch openclaw

1.3（可选）本地安全策略与自检

安装后默认本地回环，权限按需设置：

1）按需设置沙箱

2）启用谨慎审批策略：

openclaw exec-policy preset cautious

安全自检：

openclaw security audit

2. 飞书开放平台：创建企业自建应用

2.1 创建应用

打开 https://open.feishu.cn/
开发者后台 → 企业自建应用 → 创建
填名称、描述、图标（个人助理即可）
创建后进入 凭证与基础信息：

复制 App ID（cli_xxx，不敏感）
复制 App Secret（敏感，本地暂存，不发任何人）

2.2 配置应用能力（左侧导航逐项）

A. 添加应用能力 → 启用「机器人」

机器人卡片介绍（64 字以内）：

例：本地 AI 助理，仅作者本人使用

自定义菜单：留空（用不上）

B. 权限管理（最小权限集）

申请以下权限：

im:chat.access_event.bot_p2p_chat:read — 收私聊会话事件
im:message.p2p_msg:readonly — 读私聊消息
im:message.reactions:write_only — 给消息加表情反馈
im:message:send_as_bot — 以机器人身份回消息
contact:contact.base:readonly — 获取通讯录基础信息（不加后悔，避坑）

C. 事件与回调

订阅方式：选 长连接 / WebSocket
添加事件：im.message.receive_v1

D. 版本管理与发布（非常关键）

创建版本 1.0.0
可用范围：选「指定人员」→ 仅自己
提交并发布（发布后才生效；后续每次修改配置也要重新发布）

3. OpenClaw：注册 Feishu channel

Step 1：注入凭证到环境变量

[Environment]::SetEnvironmentVariable("FEISHU_APP_ID", "<你的 cli_xxx>", "User")[Environment]::SetEnvironmentVariable("FEISHU_APP_SECRET", "<你的 App Secret>", "User")

关键：设置完成后必须新开 PowerShell 窗口，子进程才能继承这两个变量。

Step 2：安装飞书插件

openclaw channels capabilities --channel feishu# 首次会提示要装飞书插件，按 Y 同意

Step 3：创建 channel 占位 + 写入配置

openclaw channels add --channel feishu --use-envopenclaw config set channels.feishu.appId $env:FEISHU_APP_IDopenclaw config set channels.feishu.appSecret --ref-provider default --ref-source env --ref-id FEISHU_APP_SECRETopenclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.connectionMode websocketopenclaw config set channels.feishu.groupPolicy disabledopenclaw config set channels.feishu.domain feishu

配置写完后重启 daemon（必需，env 变量只有新进程才能读到）：

openclaw daemon restart

Step 4：验证 WebSocket 握手

openclaw channels status --probe# 期待: Feishu default: enabled, configured, running, works

4. 设备配对（飞书 ↔ OpenClaw）

4.1 触发配对信息

在飞书 App 里加机器人为好友，发任意消息 → 机器人回复类似：

OpenClaw: access not configured.Your Feishu user id: ou_xxxPairing code: ABCDEFGHAsk the bot owner to approve with:  openclaw pairing approve feishu ABCDEFGH

4.2 在本机批准配对（5 分钟内）

openclaw pairing approve feishu <你的 code>

4.3 关于 Approval required（谨慎策略）

如果机器人回复收到 Approval required，通常是因为启用了谨慎策略，需要你在对话里按提示进行授权：回复 /approve <...> allow-once / -always / deny。使用 -always 后后续同类操作就不会再问了。

#OpenClaw #Ollama #飞书 #科研工具