使用 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（会自动安装 ui/ 目录的依赖）：
pnpm ui:build
构建主程序：
pnpm build
运行配置向导安装守护进程，完成初始化：
pnpm openclaw onboard --install-daemon
按键盘右箭头选择 Yes，确认两次。
2. 模型配置
任选一个模型提供商。若无对应密钥可跳过。如果是本地模型，推荐 vLLM（需 vLLM 框架启动，原生仅完全支持 Linux CUDA）、Custom Provider（连接任何 OpenAI 或 Anthropic 兼容端点）或 LiteLLM（最通用，支持云端及本地模型如 Ollama、vLLM、LM Studio 等）。
Custom Provider 最方便，适合日常使用，支持范围包括：
- ✅ Ollama（自动检测，无需配置）
- ✅ vLLM（
localhost:8000/v1） - ✅ LM Studio（
localhost:1234/v1） - ✅ llama.cpp（
localhost:8080/v1，需启动./llama-server） - ✅ 自封装 API：任何 Python + Transformers 封装的 OpenAI-compatible 服务
- ✅ LiteLLM 代理
- ✅ Text Generation WebUI
a) 使用本地模型及报错处理
Endpoint ID 随便填。如果提示 alias 被占用，可以不填 Model alias，或删除用户目录隐藏目录 .openclaw 下的 openclaw.json 中类似红色框的部分。
若卡住疑似报错，新开终端在 openclaw 项目文件夹输入：
pnpm openclaw logs --follow
关键报错原因可能是上下文窗口太小（OpenClaw 2026.2 版本硬性要求：contextWindow 必须 ≥ 16000，但 onboard 向导默认只设 4096）。
先输入 /exit 退出，到用户目录隐藏目录 .openclaw 的 openclaw.json 对本地模型的 contextWindow 设置至少 16000。
重启网关：
pnpm openclaw gateway restart
终端执行 pnpm openclaw tui，输入问题测试成功回答。
b) 使用云端模型
注册账号（密码需数字和英文大小写），验证激活。按需安装对接软件插件，不需要则选 skip 跳过。
c) 连接飞书
如需飞书，下载插件。打开 https://open.feishu.cn/app，登录后点击创建企业自建应用。
