乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 安装配置指南

OpenClaw 安装配置指南

当前时间： 2026-08-17 02:18:09 分类：办公文件 评论(0)
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. 1. 登录 fly open.feishu.cn，点击右上角头像选择开发者后台
  2. 2. 创建企业自建应用：点击创建应用 → 企业自建应用
  3. 3. 添加机器人：应用详情页 → 添加能力 → 机器人 → 勾选功能
  5. 4. 配置权限：
    • • 权限管理 → 搜索 im: → 全部勾选 → 批量开通
    • • 搜索通讯录 → 开通获取用户 ID 信息权限 → 批量开通
  6. 5. 发布版本：版本管理与发布 → 创建版本 1.0.0 → 保存发布

CLI 中连接飞书

  1. 1. 运行 openclaw config 选择 local
  2. 2. Channels → Link → 添加新渠道 → 选 feishu
  3. 3. 安装飞书插件：选 Install
  5. 4. 填写凭证：
    • • 飞书后台 → 凭证与基础信息 → 复制 App ID 和 App Secret
    • • 粘贴到终端
  7. 5. 配置选项：
    • • Endpoint type：im
    • • Environment：国内或国际
    • • Allow group chat：open
  8. 6. 选择 finished 完成
  9. 7. 按 Esc 或 Finish 退出

飞书后台配置

  1. 1. 启动网关：openclaw gateway start
  2. 2. 订阅方式：事件与回调 → 修改 → 长连接 → 确认
  4. 3. 添加事件：
    • • 事件与回调 → 添加事件
    • • 选择接收消息（im.message.receive_v1）→ 确认添加
  5. 4. 重新发布版本：版本管理与发布 → 创建新版本 → 保存发布
  6. 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 资源，包含环境准备、软件安装、配置向导、飞书机器人接入、常见问题等内容。