OpenClaw 安装配置指南

根据 OpenClaw 官方文档和 community 经验，本文介绍从环境准备到配置飞书机器人的完整流程。

一、准备工作

确保你的环境满足以下条件：

• Node.js 版本：>= 22
• pnpm 包管理器（源码构建时需要）

其他可选：

• API 密钥：如果想用联网搜索功能，需要准备 Brave Search API 密钥
• macOS：只使用命令行和网关功能的话，Node.js 就够。如果要构建桌面应用，需要安装 Xcode
• Windows：推荐使用 WSL2（建议 Ubuntu）。原生 Windows 可能有兼容性问题

二、安装 OpenClaw CLI

1. 检查 Node 版本

node -v

版本低于 22 的话先更新。

2. 安装 CLI 工具

npm install -g openclaw@latest

其他安装方式备用：

• macOS/Linux 一键脚本：curl -fsSL https://openclaw.ai/install.sh | bash
• Windows PowerShell：iwr -useb https://openclaw.ai/install.ps1 | iex

3. 验证安装

openclaw --version

看到版本号或帮助信息就正常。也可以查看安装位置：

which openclaw
npm list -g --depth=0

三、快速启动与配置向导

运行配置向导：

openclaw onboard

向导会问你几个问题：

• 风险确认：选择 Yes 继续
• 模式：选 QuickStart（新手用这个）
• AI 模型：选模型供应商，没有 API Key 就跳过，后续再配
• 通信渠道：建议先跳过，先用网页界面
• 技能配置：选 No
• 钩子：选 skip for now

向导完成后就准备好了。

四、配置 API 密钥

1. 获取 API Key

去各模型提供商官网获取。

2. 配置模型

在终端运行：

openclaw models auth login --provider <provider> --set-default

或在向导中粘贴 API Key。

五、连接飞书机器人

飞书开发者后台配置

1. 登录 fly open.feishu.cn，点击右上角头像选择开发者后台
2. 创建企业自建应用：点击创建应用 → 企业自建应用
3. 添加机器人：应用详情页 → 添加能力 → 机器人 → 勾选功能
4. 配置权限：

• 权限管理 → 搜索 im: → 全部勾选 → 批量开通
• 搜索通讯录 → 开通获取用户 ID 信息权限 → 批量开通

5. 发布版本：版本管理与发布 → 创建版本 1.0.0 → 保存发布

CLI 中连接飞书

1. 运行 openclaw config 选择 local
2. Channels → Link → 添加新渠道 → 选 feishu
3. 安装飞书插件：选 Install
4. 填写凭证：

• 飞书后台 → 凭证与基础信息 → 复制 App ID 和 App Secret
• 粘贴到终端

5. 配置选项：

• Endpoint type：im
• Environment：国内或国际
• Allow group chat：open

6. 选择 finished 完成
7. 按 Esc 或 Finish 退出

飞书后台配置

1. 启动网关：openclaw gateway start
2. 订阅方式：事件与回调 → 修改 → 长连接 → 确认
3. 添加事件：

• 事件与回调 → 添加事件
• 选择接收消息（im.message.receive_v1）→ 确认添加

4. 重新发布版本：版本管理与发布 → 创建新版本 → 保存发布
5. 测试：飞书客户端发送 hello，看到回复就成功

六、其他配置

多 Bot 配置

支持同时运行多个 Telegram Bot：

openclaw config set channels.telegram.botToken "token1"
openclaw config set channels.telegram.botToken "token2"

浏览器自动化

openclaw browser open "https://www.google.com"
openclaw browser navigate "https://www.example.com"

技能扩展

• 安装插件：openclaw plugins install
• 启用插件：openclaw plugins enable

定时任务

配置 cron 可让 AI 定期执行某些操作。

七、注意事项

数据隐私

• 本地安装：数据不离开设备
• VPS 部署：需要配置防火墙和访问控制

硬件建议

• 现有设备可以先用
• Mac mini（600 美元）性价比较好
• Mac Studio 仅本地模型高强度计算时考虑

八、常见问题

Q：没有 API Key 能使用吗？
A：可以，向导里选跳过，后续补充。

Q：安装失败？
A：检查 Node 版本，确保 >= 22。

Q：飞书连接失败？
A：检查权限配置、版本选择、订阅方式。

Q：支持多个渠道吗？
A：支持，共享记忆和配置。

Q：本地安装和 VPS 部署的区别？
A：本地安装最简单，数据更安全。VPS 适合远程访问但需要额外配置防火墙。

九、小贴士

首次配置可跳过大部分步骤，后续根据需要逐步补充。

另外，你也可以用codex、opencode和trae等工具帮你直接安装配置，你只要等待就行。

本文参考 OpenClaw community 资源，包含环境准备、软件安装、配置向导、飞书机器人接入、常见问题等内容。