使用 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，创建企业自建应用。
