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

最后选择 Web UI，当然你也可以选择 TUI 这个是用命令行窗口聊天，习惯用 web 页面。后续在想进入这个配置页面的话可以使用仪表盘命令：

openclaw dashboard

然后就会自动打开一个网页看到龙虾的配置页面了。

四、配置 AI 模型

点击'配置'然后点击右边的 open 按钮打开配置源文件修改。

在 json 文件的根节点上看下有没有 models 属性，没有就新建个，有就修改它：

"models":{"mode":"merge","providers":{"unicom-cloud":{"baseUrl":"根据自己的模型服务上信息配置","apiKey":"根据自己的模型服务上信息配置","api":"openai-completions","models":[{"id":"Qwen3.5-397B-A17B","name":"Qwen3.5-397B-A17B","reasoning":false,"input":["text"],"cost":{"input":0,"output":0,"cacheRead":0,"cacheWrite":0},"contextWindow":202752,"maxTokens":16384}]}}}

以上是我的配置，我用的是联通云的服务，Qwen、DeepSeek 等都有官方文档教程可以到对应的官方查看下。

然后，再修改 agents.defaults（默认模型与工作空间配置）：

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

保存并生效配置。保存后点击 Update 按钮更新新配置。

再次启动后，选择刚才配置好的模型，在聊天窗口可以和龙虾聊天了。

五、接入飞书机器人

打开飞书开放平台：

https://open.feishu.cn

创建企业自建应用。

填写应用名称（如 OpenClaw 机器人）、应用描述（可选），点击创建。

应用创建后，进入凭证与基础信息，记录 App ID 和 App Secret（后续配置需用）。 然后在配置飞书机器人权限与事件订阅。

开通核心权限：左侧菜单栏开发配置 → 权限管理

• 「应用身份权限」：搜索 im:message，全部选中并开通；
• 「用户身份权限」：搜索 contact:user.base:readonly，选中并开通；

订阅方式选择长连接。 添加接收消息事件：点击添加事件，搜索 im.message.receive_v1，添加该事件并确认开通对应权限。 好了可以创建版本并发布：点击页面顶部应用发布 → 版本管理与发布，创建新版本，填写更新说明后申请线上发布。

六、配置 openclaw 的飞书能力

步骤一：安装 OpenClaw 飞书插件 官方命令安装

openclaw plugins install @m1heng-clawd/feishu

OpenClaw 会自动完成安装、配置、重启。

在 OpenClaw 中配置飞书参数

终端执行以下命令，将占位符替换为飞书应用的实际信息：

# 配置飞书 App ID
openclaw config set channels.feishu.appId "<App ID>"
# 配置飞书 App Secret
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

七、飞书机器人配对授权

飞书机器人配置完成后，需完成配对授权才能实现消息响应。 要配对可以按照以下流程：

1. 终端执行配对命令获取配对码 在飞书向刚才配置的机器人发送任意消息，机器人会自动回复包含配对码的消息。

openclaw pairing approve feishu xxxx

2. 重启网关使授权生效

openclaw gateway restart

3. 验证授权是否成功 再次向飞书机器人发送消息，机器人能正常回答就说明配置好了，不过测试的时候发现机器人答复的有点慢，需要多等一会。

八、配置 OpenClaw 开机自启（推荐）

为了避免每次手动启动，可以配置开机自启。

方法 1 官方守护进程（推荐）

openclaw onboard --install-daemon

重启电脑即可自动启动。

方法 2 LaunchAgent 手动配置（备用）

创建 LaunchAgent：

mkdir -p ~/Library/LaunchAgents

创建配置文件：

vim ~/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

验证：

launchctl list | grep openclaw

九、常见问题解决

在配置 OpenClaw 时，遇到了两个典型问题。

问题 1

compdef: command not found

原因：macOS 默认未启用 zsh 补全系统，而 OpenClaw 的自动补全脚本依赖 compdef。

问题 2

zsh compinit: insecure directories

原因：zsh 补全目录权限不安全。

十、完整解决方案（推荐）

1. 安装补全组件

brew install zsh-completions

2. 修改 .zshrc

nano ~/.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

十一、验证是否成功

重新打开终端：

source ~/.zshrc

如果没有任何报错，说明成功。

测试：

openclaw + TAB

能看到命令补全。

十二、懒人方案（可选）

如果不需要命令补全，可以直接禁用：

echo 'export OPENCLAW_COMPLETIONS_DISABLE=1' >> ~/.zshrc
rm -f ~/.openclaw/completions/openclaw.zsh
source ~/.zshrc

十三、总结

通过本文，我们完成了：

✔ MacOS 安装 OpenClaw ✔ 接入飞书机器人 ✔ 配置开机自启 ✔ 解决终端报错

当 AI Agent + 协作工具结合时，很多重复工作都可以自动化。

未来你可以扩展：

• 自动日报
• 自动会议总结
• 自动任务创建
• 自动客服机器人

OpenClaw 是一个非常值得尝试的 AI Agent 开源项目。