OpenClaw 安装与飞书机器人配置实战指南
OpenClaw 是一个开源的 AI Agent 框架,核心作用是让你拥有一个私人 AI 助手,可以接入飞书、Telegram、WhatsApp、Discord 等多种聊天平台。其架构简单清晰:消息通过网关转发至 AI 模型,再返回回复。
选择 OpenClaw 的理由很直接:数据自托管隐私可控,支持多种聊天平台和 AI 模型(Claude、GPT、Gemini 等),且拥有可扩展的 Skill 系统,完全开源免费。
环境准备
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux / macOS / Windows (WSL2) |
| Node.js | v22 或更高 |
| 网络 | 能访问飞书开放平台 + AI API |
安装 Node.js
如果尚未安装 Node.js,建议使用 nvm 管理版本:
# 检查是否已安装
node --version
# 如果没有或版本太低,用 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
输入 node --version 后显示 v22.x.x 即表示安装成功。
安装 OpenClaw
一键安装
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
安装完成后验证版本号:
openclaw --version
看到类似 2026.3.2 的版本号说明安装成功。
手动安装(备选)
如果脚本执行有问题,也可使用 npm:
npm install -g openclaw
⚠️ 注意:如果遇到
EACCES: permission denied错误,不要直接用sudo npm install -g,建议先配置 npm 权限。
初始配置(onboard 向导)
安装完成后运行引导向导:
openclaw onboard --install-daemon
向导会引导你完成以下配置:
- AI 模型密钥:输入 Anthropic / OpenAI / Google API Key。
- Gateway 设置:默认端口 18789,一般无需修改。
- 聊天渠道:此处先跳过,后续单独配置飞书。
--install-daemon 参数会将 Gateway 安装为系统服务,实现开机自动启动。

