OpenClaw 搭建飞书 AI 办公机器人
1. 环境准备与安装
克隆项目并进入目录：
git clone https://github.com/openclaw/openclaw
cd openclaw
检查 Node.js 版本（需 >= 22），安装 pnpm 包管理器及依赖：
node --version
npm install -g pnpm
pnpm install
首次执行 Web UI 构建及主程序构建：
pnpm ui:build
pnpm build
运行配置向导安装守护进程：
pnpm openclaw onboard --install-daemon
按提示选择 Yes 完成初始化。
2. 模型配置
a) 本地模型
支持 vLLM、Custom Provider 或 LiteLLM。Custom Provider 最方便，支持 Ollama、vLLM、LM Studio 等兼容 OpenAI/Anthropic 的端点。
常见问题处理：
若遇到连接超时或报错，可能是上下文窗口不足。OpenClaw 要求 contextWindow ≥ 16000。
- 输入
/exit退出当前会话。 - 编辑用户目录隐藏文件
.openclaw/openclaw.json。 - 将本地模型的
contextWindow设置为至少 16000。 - 重启网关：
pnpm openclaw gateway restart - 启动 TUI 测试：
pnpm openclaw tui
b) 云端模型
选择云端提供商，注册账号并验证激活。按需安装对接插件，无需则跳过。
3. 连接飞书
创建应用
- 访问 https://open.feishu.cn/app，登录并创建企业自建应用。
- 填写应用名称和描述，点击创建。
- 在凭证与基础信息中复制 APP ID 和 APP Secret。
- 创建版本，填写版本号及更新说明，保存并发布。
配置权限
- 在 OpenClaw 中粘贴 APP ID 和 Secret，选择中国版飞书。
- 设置群聊响应策略：
- Allowlist: 仅指定群聊响应（推荐）。
- Open: 所有群聊响应（需@）。
- Disabled: 仅私聊。
- 如需自动安装 Skills，选择相应方式；Hooks 建议先 Skip。
能力订阅
- 在飞书应用中点击'添加'机器人。
- 创建版本，编辑订阅方式为长连接。
- 添加事件：用户进入会话、解散群、机器人进群、接收消息。
- 发布版本。
配对测试
- 打开飞书应用测试页面。
- 若出现配对码，在终端执行：
pnpm openclaw pairing approve feishu <code> - 激活后测试对话，支持切换模型。
4. Skills 安装与使用
安装 find-skills
npx skills add https://github.com/vercel-labs/skills --skill find-skills
选择 OpenClaw，全局安装并确认符号链接。
验证安装：
pnpm openclaw skills list
自动化工具
通过自然语言指令自动安装浏览器操作、数据可视化、高德地图等 Skills。
示例流程：
- 切换模型。
- 请求执行调查任务或获取数据。
- 系统自动调用 Playwright 打开浏览器。
- 获取数据并生成 CSV 下载链接或地图可视化。
注：若工具未加载，可尝试手动触发分析或更换更智能的模型。
