最近 OpenClaw 太火了，很多人想尝试下，都会被安装劝退。确实这个安装过程不太友好，在经过数次尝试，我总结出了最详细的安装教程。
OpenClaw 是一个开源的 AI agent 框架。可以跑在电脑或者服务器上，变成你的私人助理或者AI员工。
普通的 AI 聊天：你问它答，关掉网页就失忆。 OpenClaw 的 AI：能读写文件、跑代码、控制浏览器、定时提醒你、通过飞书/Telegram/Discord 找你聊天——而且它记得昨天聊了什么。
接下来，让我们开始教程。
Node.js 22+（安装脚本会自动检测，没有会帮你装）
操作系统：macOS / Linux / Windows (WSL2)
一个 LLM API Key（OpenAI、Anthropic、或任何 OpenAI 兼容接口）
一台机器：本地电脑或者 VPS 都行
推荐配置：一台便宜的 VPS（2C2G 足够），7×24 在线，随时响应你的消息。
macOS / Linux / WSL2：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex
脚本会自动：检测 Node → 安装 CLI → 启动配置向导。跟着走就行。
已经有 Node 22+ 的老手：
npm install -g openclaw@latest
openclaw onboard --install-daemon
pnpm 用户：
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
适合不想污染宿主环境的洁癖患者，详见 Docker 部署文档。
openclaw onboard 向导会问你用哪个 LLM。支持的提供商一大堆：
Anthropic（Claude 系列）
OpenAI（GPT-4o 等）
任何 OpenAI 兼容接口（Deepseek、通义千问、Groq、Together、本地 Ollama……）
填入 API Key，选个默认模型，搞定。
如果你像我一样用的是转发站或自建接口，可以直接编辑配置文件 ~/.openclaw/openclaw.json：
{
"models": {
"providers": {
"a": {
"baseUrl": "https://your-api-endpoint.com",
"apiKey": "sk-your-key",
"api": "openai-completions",
"models": [
{
"id": "gpt-4o",
"name": "GPT-4o",
"contextWindow": 128000,
"maxTokens": 4096
}
]
}
}
}
}
可以配多个 provider（比如 a 用 Claude、b 用千问、free 用免费模型），运行时用 /model a/claude-opus-4 随时切换。
这是重头戏。配好飞书，你就可以在飞书里直接和 AI 对话了——就像聊天一样自然。
openclaw plugins install @openclaw/feishu
进入应用的 凭证与基础信息 页面，复制：
App ID（格式：cli_xxx）
App Secret
⚠️ App Secret 要保密，别提交到 Git。
进入 权限管理，点击 批量导入，粘贴以下 JSON：
{
"scopes": {
"tenant": [
"im:message",
"im:message:send_as_bot",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:message:readonly",
"im:resource",
"im:chat.members:bot_access",
"im:chat.access_event.bot_p2p_chat:read",
"contact:user.employee_id:readonly",
"application:bot.menu:write"
],
"user": [
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
进入 应用能力 → 机器人，启用机器人功能，设置机器人名称。
⚠️ 先确保 OpenClaw 网关已启动（下面会说），再来配这一步。
进入 事件订阅：
im.message.receive_v1这是飞书的杀手级特性——WebSocket 长连接意味着你的 VPS 不需要暴露任何端口，不需要域名，不需要 HTTPS 证书。
进入 版本管理与发布，创建版本，提交审核。企业自建应用通常自动通过。
运行：
openclaw channels add
选择 Feishu，粘贴 App ID 和 App Secret。
或者直接编辑 ~/.openclaw/openclaw.json：
{
"channels": {
"feishu": {
"appId": "cli_xxx",
"appSecret": "your-secret-here",
"enabled": true
}
}
}
openclaw gateway start
在飞书里找到你的机器人，发条消息。第一次会收到配对码，在终端批准：
openclaw pairing approve feishu <配对码>
批准后就可以正常聊天了。🎉
openclaw doctor # 检查配置问题
openclaw status # 查看网关状态
openclaw logs --follow # 实时日志
在飞书里发几条消息试试：
/status — 查看机器人状态
/model — 查看/切换模型
/reset — 重置会话
本地电脑关机了机器人就断线。推荐丢到 VPS 上 7×24 运行：
推荐方案：
Oracle Cloud：永久免费 ARM 实例（抢到的话）
Hetzner：€3.79/月起，稳定便宜
腾讯云/阿里云轻量：国内延迟低，几十块一个月
VPS 上的安装流程完全一样，多一步把网关设为守护进程：
openclaw gateway install # 安装为 systemd 服务
openclaw gateway start # 启动
这样即使 SSH 断开，机器人也持续运行。
装完基础版只是开始，OpenClaw 真正的魅力在于可扩展性：
记忆系统：AI 会自动维护 MEMORY.md 和每日日志，跨会话记住你的偏好
定时任务：用 cron 设置定时提醒、定期检查邮件/日历
浏览器控制：内置 Playwright 浏览器，AI 可以帮你截图、读网页、填表单
多渠道：同时连飞书 + Telegram + Discord，一个 AI 管多个平台
自定义人设：编辑 SOUL.md 定义 AI 的性格、说话风格
技能系统：安装或自建 Skill，教 AI 新能力
Q：飞书机器人没反应？
im.message.receive_v1openclaw logs --followQ：openclaw 命令找不到？
export PATH="$(npm prefix -g)/bin:$PATH"
加到 ~/.bashrc 或 ~/.zshrc 里。
Q：支持群聊吗？ 支持。把机器人拉进群，@它就行。默认需要 @mention 才响应，可以配置为免 @ 模式。
Q：费用？ OpenClaw 本身免费开源。费用来自 LLM API 调用——取决于你用哪个模型和用量。用免费模型（如 Deepseek、Groq 免费额度）可以零成本玩。
OpenClaw + 飞书的组合，本质上是把一个有记忆、能执行操作的 AI 助手嵌入了你每天都在用的工作工具里。不需要切换应用，不需要打开网页——打开飞书就能聊。
装完之后，试着跟它说："记住我喜欢喝美式咖啡"，然后明天再问它你喜欢喝什么。你会发现，这和普通的 AI 聊天不是一个东西。
文档参考：OpenClaw 官方文档 | GitHub | Discord 社区