OpenClaw 搭建飞书 AI 办公机器人
环境准备
- 克隆项目并进入目录
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 完成初始化。
模型配置
本地模型及报错处理
在配置向导中选择 Custom Provider 或 LiteLLM，支持连接任何 OpenAI 或 Anthropic 兼容端点。
- Ollama：自动检测
- vLLM：
localhost:8000/v1 - LM Studio：
localhost:1234/v1 - llama.cpp：
localhost:8080/v1
常见错误处理：
若遇到上下文窗口报错，OpenClaw 2026.2 版本要求 contextWindow 必须 ≥ 16000。默认向导可能设为 4096，需手动修改。
- 退出当前会话
/exit - 编辑用户目录隐藏文件
.openclaw/openclaw.json - 将本地模型的
contextWindow设置为至少 16000 - 重启网关
pnpm openclaw gateway restart
- 验证 TUI 交互
pnpm openclaw tui
云端模型
注册账号并验证激活，按需安装对接软件插件。
连接飞书
- 下载飞书插件
- 登录 飞书开放平台，创建企业自建应用
- 填写应用名称和描述，点击创建
- 复制 APP ID 和 APP Secret
- 创建版本并发布
- 将凭证粘贴到 OpenClaw 配置中
- 选择中国版飞书，设置群聊响应策略
| 选项 | 效果 | 适用场景 |
|---|---|---|
| Allowlist | 只在指定群聊响应 | 推荐，安全可控 |
| Open | 所有群聊都响应（需@） | 团队小、群少 |
| Disabled | 完全不在群聊响应 | 仅私聊使用 |
- 安装 Skills 和 Hooks（建议先 Skip，后续按需开启）
- 启动 Dashboard 或 TUI
pnpm openclaw dashboard --no-open
- 在飞书应用中添加机器人，订阅长连接事件（用户进入会话、解散群、进群、接收消息）
- 发布版本并在飞书测试对话
- 如需配对，执行命令
pnpm openclaw pairing approve feishu <code>
安装 Skills
发现 Skills
npx skills add https://github.com/vercel-labs/skills --skill find-skills
全局安装后验证是否加载成功。
浏览器操作与数据可视化
切换模型后，可自动安装 playwright-skill 打开浏览器，获取数据并生成 CSV 下载链接。若地图显示过于简化，建议更换更智能的 AI 模型或优化提示词。
macOS 启动前请确保已设置相应权限。