使用 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,登录后点击创建企业自建应用。


