Isaac

OpenClaw 安装使用指南

OpenClaw 安装使用指南

本页面是 OpenClaw + 飞书机器人 + Claude Code 的完整安装配置教程。

一、环境准备

安装 Node.js

Windows：前往 nodejs.org 下载安装包

Mac：前往 nodejs.org 下载安装包

Ubuntu/Debian：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

node -v

安装 Git

前往 git-scm.com 下载对应平台的安装包。

二、安装 OpenClaw

一键安装：

curl -fsSL https://openclaw.ai/install.sh | bash

或者手动安装：

# Windows: 按 Win+空格 打开终端
# 进入管理员模式
sudo -i
# 输入你的系统密码

# 安装 OpenClaw
npm i -g openclaw

# 验证安装
openclaw -v

安装成功后，右键终端新建普通用户窗口启用。

获取 Kimi API

前往 kimi2.5.cn 登录并获取你的 API Key。

三、飞书机器人配置

Step 1：创建飞书应用

  1. 登录网页端飞书
  2. 点击进入开发者后台
  3. 创建新应用

Step 2：添加机器人能力

在应用中添加应用能力 → 机器人选项。

Step 3：配置权限

进入权限管理，开启以下权限：

  • 获取用户基本信息
  • 获取群组信息
  • 获取与发送单聊、群组信息
  • 机器人的单聊
  • 获取单聊、群组信息
  • 获取与上传文件和图片
  • 获取通讯录

Step 4：安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

配置插件：

  1. 粘贴 App Secret
  2. 粘贴 App ID
  3. 选择 飞书 China
  4. 连接方式选择 WebSocket

Step 5：配置事件与回调

  1. 在飞书开发者后台，进入事件与回调
  2. 选择 长连接 模式
  3. ⚠️ 记得重启 OpenClaw 网关：openclaw gateway stop 然后重新 open
  4. 在「消息与群组」里所有事件都选上
  5. 创建新版本并发布

Step 6：完成配置

openclaw doctor

运行 doctor 命令检查所有配置是否正确。

四、安装 Claude Code

npm install -g @anthropic-ai/claude-code

安装完成后，需要配置你的 Anthropic API Key 才能使用。

五、Windows 额外配置

如果在 Windows PowerShell 中遇到脚本执行限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

六、资源下载

📦 Skills Bundle 下载

📦 飞书文件上传器下载

📖 飞书文档参考

七、飞书完整权限列表（参考）

如果需要完整的飞书权限配置，以下是所需的全部权限范围。在飞书开发者后台的「权限管理」中逐一开启：

多维表格 (Base)：应用复制/创建/读取/更新、协作者管理、仪表盘、字段管理、表单、记录CRUD、角色管理、表格管理、视图管理

文档 (Docs/Docx)：文档读写、评论管理、内容读取、媒体上传下载、订阅、导入导出、权限管理

云空间 (Drive)：文件读写/上传/下载、元数据、搜索、版本管理

消息 (IM)：单聊群聊消息收发、群组管理、消息Pin/Reaction/撤回、文件资源、标签管理

通讯录 (Contact)：用户基本信息、员工ID、员工工号

知识库 (Wiki)：空间/节点读写、成员管理、设置管理

电子表格 (Sheets)：读写、元数据、创建

白板 (Board)：节点CRUD