介绍如何使用 OpenClaw 框架搭建飞书 AI 办公机器人。内容包括环境配置（Node.js、pnpm）、模型接入（支持本地 Ollama、vLLM 及云端 API）、飞书应用创建与权限配置、以及 Skills 插件的自动安装与使用。重点解决了上下文窗口限制导致的报错问题，并演示了通过浏览器操作和数据可视化技能实现自动化任务的能力。
执行以下命令克隆项目并进入目录：
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
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
按键盘右箭头选择 Yes，确认两次。
任选一个模型提供商。如果没有对应的提供商密钥可以跳过。如果是本地模型，推荐使用 vLLM（需 vLLM 框架启动）、Custom Provider（支持任何 OpenAI 或 Anthropic 兼容端点）或 LiteLLM（最通用，支持云端和本地后端如 Ollama、vLLM 等）。
Custom Provider 适合日常使用，支持范围包括：
localhost:8000/v1)localhost:1234/v1)localhost:8080/v1)Endpoint ID 可随意填写。
如果提示 alias 被占用，可以不填 Model alias，或删除用户目录隐藏目录 .openclaw 下的 openclaw.json 中冲突部分。
若遇到报错卡住，新开终端在项目文件夹执行日志查看：
pnpm openclaw logs --follow
关键报错原因通常是上下文窗口太小（OpenClaw 2026.2 版本要求 contextWindow ≥ 16000，默认仅设 4096）。
输入 /exit 退出后，修改用户目录隐藏目录 .openclaw 下的 openclaw.json，将本地模型的 contextWindow 设置为至少 16000。
重启网关：
pnpm openclaw gateway restart
终端执行 TUI 界面测试：
pnpm openclaw tui
输入问题，验证回答成功。
若无账号需注册，密码需包含数字和英文大小写。
验证激活。
按需安装对接软件插件，不需要则选 skip 跳过。
如需飞书集成，下载对应插件。
打开 https://open.feishu.cn/app，登录后点击创建企业自建应用。
简单填写应用名称和描述，点击创建。
点击凭证与基础信息，复制 APP ID 和 APP Secret。
点击创建版本，填写版本号及更新说明，保存并发布。
将 APP ID 和 APP Secret 粘贴到 OpenClaw 配置中。
选择中国版飞书。
按需选择群聊响应策略：
| 选项 | 效果 | 适用场景 |
|---|---|---|
| Allowlist | 只在指定群聊响应 | 推荐，安全可控 |
| Open | 所有群聊都响应（需@） | 团队小、群少 |
| Disabled | 完全不在群聊响应 | 仅私聊使用 |
建议选 Allowlist，后续在配置文件中指定允许响应的群 ID。
按需安装 Skills，需要的话选择安装方式，不需要则 skip for now。
Hooks 是可选的自动化触发器，建议先 Skip。
| Hook | 作用 | 适用场景 |
|---|---|---|
| boot-md | 启动时加载 Markdown 系统提示 | 固定指令集 |
| bootstrap-extra-files | 预加载额外文件 | 知识库文件 |
| command-logger | 记录命令日志 | 审计追踪 |
| session-memory | 保存/恢复会话上下文 | 持久化记忆 |
建议入门先 Skip，熟悉后再根据需求开启。
Skip 多个步骤后，选择 TUI 模式。
也可打开 http://127.0.0.1:18789/chat?session=main 修改配置。
后续直接启动可选择 pnpm openclaw dashboard --no-open。
回到飞书，点击应用能力，再点击机器人中的'添加'按钮。
点击创建版本。
点击订阅方式的编辑按钮，选择长连接，然后添加事件：
再次点击创建版本，填写版本号、更新说明和应用能力，点击发布。
打开飞书应用测试，如果出现配对码，在 OpenClaw 项目终端执行：
pnpm openclaw pairing approve feishu <配对码>
激活完成后继续测试对话，并在对话中切换模型。
执行以下命令安装 find-skills 工具：
npx skills add https://github.com/vercel-labs/skills --skill find-skills
选择 openclaw。
全局安装，采用符号链接，选择 yes。
打开网站或命令行 pnpm openclaw skills list 验证安装。
Mac 启动前最好设置权限。执行调查任务，若未加载 find-skills 工具，让 AI 自行分析并加载。
切换模型。
自动安装 skills 并执行 playwright-skill 打开浏览器。
成功获取数据。
创建访问链接成功。
查看链接以及下载 csv，地图可能过于简化。
让 AI 继续优化。
打开下载文件和地图链接，效果有所进步。如需更准更美观，建议更换更智能的 AI 模型或继续提要求。