我们每天dou要在无数个应用之间来回切换：一会儿去ChatGPT查资料，一会儿去钉钉回消息，一会儿又要打开终端敲代码。这种碎片化的工作流，不仅让人心累，效率geng是大打折扣。你有没有想过Ru果Neng把这些工具串联起来让AI直接“住”进你每天dou在用的聊天软件里那该多好？

别急，今天我要给大家安利一个在极客圈子里Yi经火得一塌糊涂的开源项目——OpenClaw。这不仅仅是一个简单的聊天机器人，它geng像是一个24小时待命的数字员工。Zui关键的是它原生支持飞书！这意味着，你Ke以直接在飞书里指挥它去写代码、查资料、甚至帮你管理服务器。

这篇文章，我会毫无保留地把从零开始部署 OpenClaw 并接入飞书的经验分享出来。不管你是技术小白还是老手，跟着这份教程走，你也Neng拥有一个属于自己的私人AI助手。

一、 为什么选择 OpenClaw？它到底NengZuo什么？

在开始动手之前，咱们先得明白这玩意儿到底有什么魔力。OpenClaw 是一款运行在你本地设备或云服务器上的开源 AI 助手框架。和那些只Neng陪聊的“人工智障”不同，OpenClaw 拥有真正的执行力。

想象一下这样的场景：

自动化办公： 每天早上9点，它自动在飞书群里发送一份整理好的行业早报。

代码运维： 你在飞书里发一句“重启一下测试环境的服务”，它就Neng在后台执行命令并反馈结果。

多平台互联： 它不仅支持飞书，还Neng搞定钉钉、WhatsApp、Telegram 等主流通讯软件。

GitHub 上它的星标Yi经突破了 10 万颗，这足以说明社区的活跃程度和它的实用性。而且，由于它是部署在你自己的环境中的，数据隐私完全掌握在自己手里这对于hen多对数据安全敏感的开发者来说简直是刚需。

二、 准备工作：环境检查与依赖安装

工欲善其事，必先利其器。在开始安装 OpenClaw 之前，我们需要确保你的“武器库”是准备妥当的。OpenClaw 是基于 Node.js 构建的，所以一个稳定的 Node 环境是必不可少的。

1. 检查 Node.js 版本

打开你的终端，输入以下命令检查当前环境：

node -v

请注意，OpenClaw 对 Node.js 的版本有一定要求。Ru果你的版本低于 v22.x.x，或者干脆提示“command not found”，那就需要升级一下。这里强烈推荐使用 nvm 来管理版本，省时省力。

对于国内用户，为了防止网络波动导致安装失败，建议使用 Gitee 的镜像源：

# 国内用户推荐使用 gitee 镜像
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 重新加载环境变量
source ~/.zshrc
# 安装Zui新的 LTS 版本
nvm install 22
# 切换使用该版本
nvm use 22

2. 准备一台“主机”

OpenClaw Ke以运行在你的个人电脑上，也Ke以运行在云服务器上。Ru果你希望它 24 小时在线，随时待命，那么云服务器绝对是首选。当然Ru果你只是想体验一下在自己的 Mac 上跑起来也完全没问题。

三、 安装 OpenClaw：一键部署与脚本详解

环境搞定后接下来就是激动人心的安装环节了。OpenClaw 提供了非常人性化的安装方式，哪怕你不太熟悉命令行操作，也Neng轻松搞定。

方式一：使用官方安装脚本

对于 macOS 和 Linux 用户，官方提供了一键脚本，自动帮你处理环境配置和依赖下载。在终端中执行：

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

Ru果你是 Windows 用户，Ke以使用 PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

方式二：NPM 全局安装

Ru果你习惯使用 npm 包管理器，也Ke以直接通过命令行进行全局安装：

npm install -g openclaw@latest

安装完成后别急着高兴，先验证一下是否成功：

openclaw --version

Ru果Nengkan到版本号输出，恭喜你，第一步Yi经迈出去了！Ru果你使用的是 macOS 并且安装了菜单栏 Companion App，记得去应用程序文件夹里确认一下这Neng让你geng方便地查kan状态。

四、 初始化配置：让 OpenClaw 听懂你的话

安装好软件只是第一步，接下来我们要进行“初始化向导”。这一步就像是给新手机开机设置一样，告诉 OpenClaw 你希望它怎么工作。

在终端执行：

openclaw onboard

或者，Ru果你希望它作为一个守护进程在后台稳定运行：

openclaw onboard --install-daemon

向导会问你一系列问题，比如选择默认的模型、设置工作目录等。这里有个小建议：Workspace 的设置hen重要，它决定了 OpenClaw Neng够访问你电脑上的哪些文件。为了安全起见，建议专门给它建一个文件夹，比如：

# 查kan当前 workspace 配置
cat ~/.openclaw/openclaw.json | grep workspace
# 修改 workspace 限制 agent 的访问范围
openclaw config set agents.defaults.workspace "/Users/你的用户名/openclaw-workspace"
# 修改完记得重启网关
openclaw gateway restart

五、 飞书开发者后台配置：打通任督二脉

这是整个流程中Zui关键，也是Zui容易出错的一步。我们要在飞书的开放平台上创建一个应用，并赋予它足够的权限，让它Neng代表 OpenClaw 发言和行动。

1. 创建自建应用

登录飞书开放平台，点击“创建企业自建应用”。起个霸气的名字，比如“钢铁侠的贾维斯”，上传个头像，然后创建。

2. 配置权限

hen多新手在这里踩坑，导致机器人发不了消息或者读不到联系人信息。进入应用的「权限管理」页面我们需要开启一系列权限。

为了方便大家，我整理了一份核心权限清单，你Ke以直接在「批量导入权限」里粘贴：

{
  "scopes": {
    "tenant": ,
    "user": 
  }
}

特别提醒： 千万别漏了 contact:contact.base:readonly 这个权限！Ru果没有它，你的定时任务就无法主动找到你并发送消息，因为机器人“kan不见”你。

配好权限后记得去「版本管理与发布」创建一个新版本并发布。不发布的话，权限是不会生效的，这一点经常被遗忘。

3. 获取凭证与事件订阅

在「凭证与基础信息」页面记下你的 App ID 和 App Secret，一会儿配置 OpenClaw 时要用。

接着，来到左侧导航栏的「事件与回调」。这里我们要告诉飞书，当有消息时往哪里推送给 OpenClaw。

订阅方式选择：「使用长连接接收事件」。

这是一个非常棒的设计！传统的回调方式需要你有公网 IP 或者用 ngrok Zuo内网穿透，麻烦且不稳定。而飞书的长连接模式，只要你的机器Neng连上外网，就Neng直接建立连接，无需公网 IP，无需域名，简直太友好了！

点击「添加事件」，至少添加 im.message.receive_v1事件。

六、 将 OpenClaw 接入飞书：Zui后的握手

现在飞书那边准备好了OpenClaw 这边也装好了就差Zui后一条线把它们连起来。

回到你的终端，使用刚才获取到的 App ID 和 Secret 进行配置：

openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId "你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
# 必须重启网关使配置生效！
openclaw gateway restart

敲黑板： 一定要执行 openclaw gateway restart！Ru果不重启，新配置是不会加载的，后面你在飞书里发消息，机器人就会像死了一样没反应。

重启后你Ke以通过以下命令检查状态：

openclaw status    # 查kan网关状态
openclaw doctor    # 检查配置是否有误

七、 进阶玩法：定时任务与模型管理

连上飞书只是开始，真正发挥 OpenClaw 威力的，是它的自动化Neng力和对多种大模型的支持。

1. 切换 AI 模型

OpenClaw 默认可Neng连接的是 GPT-4 或其他模型，但这对于国内用户来说访问速度和成本dou是问题。我们Ke以轻松切换到国产大模型，比如智谱 AI 的 GLM 系列。

# 查kan当前模型
openclaw model
# 列出所有可用模型
openclaw models
# 切换默认模型
openclaw models set zhipu/glm-4-flash
# 设置备用模型，主模型挂了自动切
openclaw models fallbacks add zhipu/glm-4-plus

2. 定时任务：你的私人秘书

想让机器人每天早上 8 点给你发早报？或者提醒你下午 2 点开会？OpenClaw 内置了强大的 Cron 任务系统。

添加每日早报任务：

openclaw cron add \
  --name "早报" \
  --cron "0 8 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "生成今日科技新闻早报并发送给我" \
  --delivery-channel feishu \
  --delivery-to "ou_你的飞书用户ID"

添加一次性会议提醒：

openclaw cron add \
  --name "会议提醒" \
  --at "2023-10-20T14:00:00+08:00" \
  --session main \
  --system-event "提醒：下午2点有重要会议" \
  --wake now \
  --delete-after-run

这里有个小技巧，怎么知道你的飞书用户 ID 是多少？你Ke以先随便给机器人发条消息，然后执行：

openclaw logs --tail 50 | grep "ou_"

从日志里就Neng找到那一串以 ou_ 开头的 ID 了。

八、 远程访问与故障排查：解决那些“坑”

部署过程中难免遇到各种奇奇怪怪的问题，别慌，这里有几个常见的解决方案。

1. 无头模式下的远程访问

Ru果你把 OpenClaw 部署在了一台没有显示器的 Mac Studio 或者云服务器上，怎么打开它的 Web 管理界面呢？

OpenClaw 的 Dashboard 默认只监听本地 localhost。我们需要用 SSH 隧道把远程端口映射到本地。

在你的本地电脑终端执行：

ssh -N -L 3333:localhost:3333 用户名@服务器IP地址

然后在服务器上启动 Dashboard：

openclaw dashboard --no-open

命令会输出一个带 Token 的 URL。Zui后在你本地电脑的浏览器里访问：

http://localhost:3333/?token=你的token

这样就Neng安全地远程管理你的 AI 助手了。

2. 常见报错修复

问题：提示“duplicate plugin id” 原因：你手动安装了飞书插件，但 OpenClaw 新版本Yi经内置了导致冲突。 解决：删除手动安装的插件并重启。

rm -rf ~/.openclaw/extensions/feishu
openclaw gateway restart

问题：定时任务不执行 原因：可Neng是 HEARTBEAT.md 文件为空，或者权限没配好。 解决：给心跳文件加点内容，确保系统Neng感知到任务的存在。

echo "Check and run pending cron tasks."> ~/.openclaw/agents/main/agent/HEARTBEAT.md
openclaw gateway restart

问题：配置报错 gateway.host 原因：当前版本可Neng不支持该配置项，或者拼写错误。 解决：检查官方文档，通常默认配置即可，无需手动修改 host。

九、 ：开启你的 AI 自动化之旅

走到这里相信你Yi经成功在飞书里唤醒了你的 OpenClaw 助手。从环境搭建到飞书对接，再到定时任务和模型切换，每一个步骤dou是通往高效工作的基石。

OpenClaw 的魅力在于它的可 性。除了飞书，你还Ke以尝试接入钉钉，或者去 ClawHub 安装各种第三方技Neng。它就像一个乐高积木，等待你去搭建属于自己的自动化城堡。

Ru果你在安装过程中遇到了其他问题，别忘了去官方文档 docs.openclaw.ai 寻找答案，或者在 Discord 社区里喊一嗓子。毕竟折腾本身就是一种乐趣，不是吗？

现在打开飞书，给你的新助手发个“你好”吧！

---