MacOS 安装 OpenClaw 并接入飞书机器人

同时修改 agents.defaults 配置默认模型与工作空间：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "unicom-cloud/Qwen3.5-397B-A17B"
      },
      "models": {
        "unicom-cloud/Qwen3.5-397B-A17B": {}
      },
      "workspace": "/Users/当前登录用户/.openclaw/workspace"
    }
  }
}

保存后点击 Update 按钮生效。

四、接入飞书机器人

1. 创建企业自建应用

访问飞书开放平台，创建企业自建应用，记录 App ID 和 App Secret。

2. 配置权限与事件订阅

• 开通核心权限：搜索 im:message 全部选中；搜索 contact:user.base:readonly 选中。
• 订阅方式选择长连接。
• 添加接收消息事件：搜索 im.message.receive_v1 并确认开通。
• 发布新版本至线上。

3. 配置 OpenClaw 飞书能力

安装插件：

openclaw plugins install @m1heng-clawd/feishu

配置参数（替换实际信息）：

openclaw config set channels.feishu.appId "<App ID>"
openclaw config set channels.feishu.appSecret "<App Secret>"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true

重启网关：

openclaw gateway restart

4. 配对授权

向飞书机器人发送任意消息获取配对码，终端执行：

openclaw pairing approve feishu <配对码>

再次重启网关使授权生效。

五、配置开机自启

方法 1：官方守护进程

openclaw onboard --install-daemon

方法 2：LaunchAgent 手动配置

创建 LaunchAgent 目录：

mkdir -p ~/Library/LaunchAgents

创建配置文件 com.openclaw.gateway.plist：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.openclaw.gateway</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/openclaw</string>
    <string>gateway</string>
    <string>start</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
</dict>
</plist>

加载服务：

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.openclaw.gateway.plist

六、常见问题解决

问题 1：compdef: command not found

macOS 默认未启用 zsh 补全系统，OpenClaw 依赖 compdef。

问题 2：zsh compinit: insecure directories

zsh 补全目录权限不安全。

解决方案

1. 安装补全组件：

   brew install zsh-completions
   

2. 修改 .zshrc，在文件顶部添加：

   autoload -Uz compinit && compinit -i -u
   if type brew &>/dev/null; then fpath=($(brew --prefix)/share/zsh-completions $fpath) fi
   

3. 修复目录权限：

   sudo chmod -R go-w $(brew --prefix)/share/zsh-completions
   sudo chown -R $(whoami) $(brew --prefix)/share/zsh-completions
   sudo chmod -R go-w /usr/share/zsh
   sudo chown -R root:wheel /usr/share/zsh
   

4. 清理缓存：

   rm -f ~/.zcompdump*
   source ~/.zshrc
   

七、总结

本文介绍了在 MacOS 上安装 OpenClaw、配置 AI 模型、接入飞书机器人及开机自启的方法，并解决了常见的终端报错问题。结合 AI Agent 与协作工具可实现自动日报、会议总结等重复工作的自动化。