使用 OpenClaw 搭建飞书 AI 办公机器人
本文介绍如何使用 OpenClaw 框架搭建飞书 AI 办公机器人，支持本地 Ollama 模型接入、自动安装 Skills 及数据可视化功能。
1. 环境准备与项目初始化
执行以下命令克隆项目并进入目录：
git clone https://github.com/openclaw/openclaw
cd openclaw
检查 Node.js 版本是否大于等于 22，如未安装请自行安装。随后安装 pnpm 包管理器并安装依赖：
node --version
npm install -g pnpm
pnpm install
首次执行构建 Web UI（会自动安装 ui/ 目录的依赖）：
pnpm ui:build
构建主程序：
pnpm build
运行配置向导安装守护进程，完成初始化：
pnpm openclaw onboard --install-daemon
按提示选择 Yes 确认。在模型提供商选择环节，若无对应密钥可跳过。对于本地模型，推荐选择 Custom Provider 或 LiteLLM。
支持的模型端点
Custom Provider 适合日常使用，支持范围包括：
- Ollama（自动检测）
- vLLM (
localhost:8000/v1) - LM Studio (
localhost:1234/v1) - llama.cpp (
localhost:8080/v1) - 自封装 API（OpenAI 兼容服务）
- LiteLLM 代理
- Text Generation WebUI
2. 模型配置与报错处理
a) 使用本地模型
Endpoint ID 可随意填写。如果提示 alias 被占用，可不填 Model alias，或删除用户目录隐藏文件夹 .openclaw/openclaw.json 中冲突的配置项。
若遇到连接卡住或报错，可能是上下文窗口太小。OpenClaw 2026.2 版本要求 contextWindow 必须 ≥ 16000，但向导默认设为 4096。
排查步骤：
- 输入
/exit退出当前会话。 - 查看日志定位错误：
pnpm openclaw logs --follow - 修改配置文件
~/.openclaw/openclaw.json，将本地模型的contextWindow设置为至少 16000。 - 重启网关：
pnpm openclaw gateway restart - 启动 TUI 测试对话：
pnpm openclaw tui
b) 使用云端模型
选择云端模型提供商，注册账号（密码需包含数字和英文大小写），验证激活后按需安装对接插件，无需则选择 Skip。
3. 连接飞书应用
下载飞书插件，登录 https://open.feishu.cn/app，创建企业自建应用。
- 基础信息：填写应用名称和描述，点击创建。
- 凭证获取：在'凭证与基础信息'中复制 APP ID 和 APP Secret，粘贴到 OpenClaw 配置中。
- 发布版本：创建版本，填写版本号及更新说明，保存并发布。
- 配置策略：选择中国版飞书，按需设置群聊响应策略（推荐 Allowlist，仅指定群聊响应）。
| 选项 | 效果 | 适用场景 |
|---|---|---|
| Allowlist | 只在指定群聊响应 | 推荐，安全可控 |
| Open | 所有群聊都响应（需@） | 团队小、群少 |
| Disabled | 完全不在群聊响应 | 仅私聊使用 |
- Skills 安装：按需安装 Skills，建议先 Skip，后续开启 Hooks 自动化触发器。
| Hook | 作用 | 适用场景 |
|---|---|---|
| boot-md | 启动时加载 Markdown 系统提示 | 固定指令集 |
| bootstrap-extra-files | 预加载额外文件到上下文 | 知识库文件 |
| command-logger | 记录命令到日志 | 审计追踪 |
| session-memory | 切换会话保存/恢复上下文 | 持久化记忆 |
-
能力订阅：在飞书应用中点击'添加'机器人，创建版本。编辑订阅方式选择长连接，添加事件：
- 用户进入与机器人的会话
- 解散群
- 机器人进群
- 接收消息
-
配对激活：打开飞书测试应用，若出现配对码，在终端执行：
pnpm openclaw pairing approve feishu <配对码>
激活完成后即可在飞书中测试对话，支持切换模型。
4. 安装与使用 Skills
a) 安装 find-skills
执行以下命令全局安装 find-skills：
npx skills add https://github.com/vercel-labs/skills --skill find-skills
选择 OpenClaw，采用符号链接全局安装（Yes）。安装后可通过 pnpm openclaw skills list 验证。
b) 浏览器操作与数据可视化
切换模型后，可通过自然语言指令自动安装 browser-playwright-skill 等工具。
示例流程：
- 请求执行调查任务。
- 机器人自动调用 playwright-skill 打开浏览器。
- 获取数据并生成访问链接。
- 支持下载 CSV 文件或展示地图数据。
若地图显示过于简化，可尝试更换更智能的 AI 模型或优化提示词要求。
5. 常用命令参考
- 启动 Dashboard：
pnpm openclaw dashboard --no-open - 查看日志：
pnpm openclaw logs --follow - 重启网关：
pnpm openclaw gateway restart - 列出 Skills：
pnpm openclaw skills list
