Mac mini 安装 OpenClaw 并对接飞书

• 应用名称：OpenClaw 助手
• 应用描述：AI 智能体助手

发布应用（必须）：左侧 → 「版本管理与发布」→ 「创建版本」，填写版本号（如 1.0.0）、更新说明，提交后申请发布，完成企业内审批，确认应用状态为「已发布」。

获取核心凭证（务必保存）：左侧 → 「凭证与基础信息」→ 复制「App ID」「App Secret」。

点击「创建企业自建应用」，填写信息。

3.3 安装 OpenClaw 飞书插件

# 安装飞书官方插件
openclaw plugins install @openclaw/feishu
# 验证插件安装（输出列表包含 @openclaw/feishu 即成功）
openclaw plugins list

3.4 配置飞书渠道（两种方式任选其一）

方式 1：交互式配置（推荐，新手友好）

openclaw channels add

按终端提示操作：

1. 选择渠道类型：Feishu
2. 粘贴飞书应用的「App ID」
3. 粘贴飞书应用的「App Secret」
4. 确认配置，完成渠道添加

方式 2：命令行一键配置

openclaw config feishu \
  --app-id "你的飞书 App ID" \
  --app-secret "你的飞书 App Secret"

3.5 启动飞书网关并验证连接

# 启动飞书 WebSocket 网关（维持长连接）
openclaw gateway start
# 查看网关状态（显示 Feishu gateway running (connected) 即成功）
openclaw gateway status
# （可选）查看实时日志，用于排查错误
openclaw logs --follow

3.6 飞书客户端配对与使用

1. 打开飞书客户端，搜索创建的机器人名称（如「OpenClaw 助手」），发起私聊
2. 机器人会自动回复配对码（如 H9ZEHY8R）
3. 终端执行配对授权（替换「你的配对码」为实际收到的代码）： openclaw pairing approve feishu 你的配对码
4. 配对完成后即可使用：
   • 私聊：直接给机器人发指令（如「整理桌面文件」「写一段 Python 脚本」）
   • 群聊：@机器人 + 指令（如「@OpenClaw 助手 生成一份周报模板」）

4. 常见问题与解决方案

4.1 安装 OpenClaw 提示权限不足

# 方式 1：命令前加 sudo 提升权限
sudo curl -fsSL https://openclaw.ai/install.sh | bash
# 方式 2：手动赋予脚本权限（若下载了安装脚本）
chmod +x install.sh && ./install.sh

4.2 飞书网关连接失败（status 非 connected）

# 重启网关
openclaw gateway restart
# 核对 App ID/Secret 是否正确
cat ~/.openclaw/config.json | grep feishu

4.3 飞书机器人收不到消息/无响应

• 确认飞书应用已「发布并审批通过」（未发布无法正常使用）
• 确认飞书权限已开通「获取与发送单聊、群组消息」
• 重启飞书网关：openclaw gateway restart
• 查看日志排查错误：openclaw logs --follow

4.4 Apple Silicon（M1/M2/M3）Node.js 架构不匹配

# 卸载现有 Node.js 22
nvm uninstall 22
# 安装 ARM64 版本 Node.js 22
arch -arm64 /bin/zsh -c "nvm install 22"
nvm use 22
# 验证架构（输出 arm64 即成功）
node -p "process.arch"

5. 进阶配置（可选）

编辑 OpenClaw 配置文件 ~/.openclaw/config.json，可修改飞书权限策略：

{
  "channels": {
    "feishu": {
      "dmPolicy": "open",
      "allowFrom": ["*"],
      "groupPolicy": "open",
      "allowGroups": ["群 ID1", "群 ID2"]
    }
  }
}

配置修改后，重启网关生效：

openclaw gateway restart

6. 卸载（按需执行）

6.1 卸载 OpenClaw 完整程序

openclaw stop
npm uninstall -g openclaw
rm -rf ~/.openclaw

6.2 仅卸载飞书插件

openclaw plugins uninstall @openclaw/feishu