前言：为什么我要部署这个？

说起来挺有意思，之前玩过一些云端AI助手，但是总感觉少了点什么。要么是数据跑到别人的服务器上，心里不踏实；要么是功能受限，想干点啥都干不了。

后来刷到了OpenClaw，说是开源的，能在本地部署，还能执行命令、浏览网页、管理文件，这不就是我想要的东西吗？

说干就干，但是一开始也是踩了不少坑。OpenClaw这项目之前还叫Clawdbot，又改过Moltbot，现在才正式叫OpenClaw，名字变来变去的，害我还查了半天才知道是同一个东西。

不过折腾下来，发现这东西确实挺好用的。所以写这篇文章，后面想玩的朋友能少走点弯路。

OpenClaw是什么？

简单说，OpenClaw是一个运行在你本地环境的高权限AI智能体。

主要特点：

  • 本地部署：跑在自己的服务器上，数据完全自主可控
  • 多平台支持：支持飞书、WhatsApp、Telegram、Discord、Slack等主流聊天工具
  • 功能强大：能浏览网页、填写表单、读写文件、执行Shell命令、运行脚本
  • 持久化记忆：能记住你的偏好和上下文，时间久了就像是你的私人助理
  • 插件扩展：支持社区技能插件，自己也能写插件

能用它干啥？

邮件管理、日程安排、数据查询，甚至是写代码，它基本都能搞定。对我来说，主要是想把它当个飞书机器人用，日常办公能省不少事。

一、准备工作

服务器要求

先说门槛，其实不高，但也不是啥机器都能跑。

最低配置：

  • CPU：双核以上
  • 内存：2GB以上（但建议4GB+，2GB容易OOM）
  • 硬盘：20GB可用空间
  • 系统：Ubuntu 20.04 / 22.04 LTS 或 Debian 11+
  • 网络：稳定的互联网连接

安全建议：

别在本地电脑或者工作机上装，这个项目权限挺大的，能执行系统命令什么的。最好单独准备一台闲置的云服务器或者VPS，推荐香港节点，国内访问方便。

如果你经常访问国外，海外节点也行，看自己需求。

更新系统

登录服务器后，先更新一下系统包：

1
sudo apt update

二、安装OpenClaw

2.1 安装Git

Git版本管理工具得有：

1
sudo apt install git -y

2.2 安装Node.js

OpenClaw需要Node.js，而且要求版本≥22。这里用NVM来管理会比较方便。

国内服务器（使用Gitee镜像源）：

1
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash

海外服务器（使用官方源）：

1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

安装完NVM后，重新加载环境变量：

1
source ~/.bashrc

然后安装Node.js 22版本：

1
nvm install 22

验证一下版本：

1
node -v

输出v22.x.x就说明没问题了。

2.3 安装OpenClaw

这个最简单，官方给了一键安装脚本：

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

注意事项：

  • 国内服务器如果安装失败，先检查网络
  • 2GB内存的服务器容易出现OOM（内存溢出），建议配置swap空间
  • 安装过程有点慢，耐心等一下

配swap的命令（如果内存不够）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 创建1GB swap文件
sudo fallocate -l 1G /swapfile

# 设置权限
sudo chmod 600 /swapfile

# 设置为swap空间
sudo mkswap /swapfile

# 启用swap
sudo swapon /swapfile

# 设置开机自启
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

2.4 初始化配置

安装成功后会自动进入初始化向导，按步骤来：

  1. 安全提示确认：会提示”OpenClaw is a hobby project and still in beta…”，输入Yes继续
  2. 选择部署模式：选QuickStart（后面可以再补充配置）
  3. 选择模型服务商：选Qwen（OAuth）（通义千问，免费额度充足，适合入门）
  4. 模型授权：系统会生成授权链接，复制到浏览器打开，登录Qwen账号完成授权
  5. 选择默认模型：选qwen-portal/coder-model
  6. 跳过通信通道配置：选Skip for now（后面专门配置飞书）
  7. 技能配置：选No（暂时不配置，后面按需扩展）
  8. Hooks配置：选Skip for now（暂时不启用）
  9. 启动方式选择：选TUI（终端聊天界面）
  10. 测试：出现聊天界面后输入Hello测试一下，确认安装成功
  11. 退出：按Ctrl+C退出，后续用Web UI或者飞书交互

2.5 验证服务状态

运行这个命令查看服务状态：

1
clawdbot status

如果输出包含Gateway service: running、Node service: running这些信息，说明服务启动成功了。

2.6 访问Web UI面板

如果你想看看Web界面，可以这样做：

第一步：建立SSH隧道（在本地电脑终端执行）

1
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP

输入密码连接上。

第二步：获取授权链接（服务器终端执行）

1
clawdbot dashboard

复制输出的Dashboard URL。

第三步：访问面板

本地浏览器打开刚才复制的URL，就能进入OpenClaw Web UI了。首次使用可以设置AI助手名称和你的称呼，比如：

  • Name: 小爪
  • My Name: 老板

三、对接飞书机器人

这部分是重点，飞书机器人配置好之后，日常用起来会很方便。

3.1 安装飞书插件

在服务器终端执行：

1
clawdbot plugins install @m1heng-clawd/feishu

3.2 飞书开放平台配置

第一步：创建企业自建应用

  1. 登录飞书开放平台：https://open.feishu.cn
  2. 进入”开发者后台”
  3. 点击”创建企业自建应用”

第二步：填写应用信息

  • 应用名称：比如”小爪”
  • 应用描述：比如”我的个人AI助手”
  • 应用图标：上传一张图片（JPEG/PNG/SVG/BMP，2MB以内，尺寸≥240×240px）
  • 点击”创建”

第三步：获取应用凭证

  1. 进入”凭证与基础信息”页面
  2. 复制”App ID”和”App Secret”
  3. 重要：这两个信息后面配置要用，妥善保存

第四步：添加机器人能力

  1. 进入”应用能力”页面
  2. 点击”添加应用能力”
  3. 选择”机器人”
  4. 设置机器人名称，比如”小爪”
  5. 点击”保存”

第五步：订阅事件

  1. 进入”事件与回调”页面
  2. 选择”事件配置”
  3. 点击”添加事件”
  4. 选择”接收消息”事件（im.message.receive_v1）
  5. 点击”确认添加”

第六步：开通权限

进入”权限管理”页面，勾选以下权限并申请开通：

  • contact:user.base:readonly（获取基础用户信息）
  • im:message相关全量权限（发送和接收单聊、群组消息等）

第七步：选择事件接收方式

在”事件与回调”页面，选择”使用长连接接收事件”（推荐），点击”保存”。

3.3 服务器配置飞书参数

在服务器终端执行以下命令，把占位符替换成你真实的飞书App ID和App Secret：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 设置App ID
clawdbot config set channels.feishu.appId "你的飞书App ID"

# 设置App Secret
clawdbot config set channels.feishu.appSecret "你的飞书App Secret"

# 启用飞书通道
clawdbot config set channels.feishu.enabled true

# 使用websocket连接模式
clawdbot config set channels.feishu.connectionMode websocket

# 单聊策略：需配对
clawdbot config set channels.feishu.dmPolicy pairing

# 群聊策略：白名单
clawdbot config set channels.feishu.groupPolicy allowlist

# 需要@机器人才能触发响应
clawdbot config set channels.feishu.requireMention true

3.4 重启服务使配置生效

1
clawdbot gateway restart

3.5 发布飞书应用

  1. 飞书开放平台进入”版本管理与发布”页面
  2. 点击”创建新版本”
  3. 填写版本信息：
    • 版本号：1.0.0
    • 版本描述：初始版本，对接OpenClaw
  4. 选择应用可见范围
  5. 点击”保存”
  6. 点击”直接发布”
  7. 等待审核通过（企业自建应用通常自动审核）

3.6 测试飞书机器人

  1. 飞书客户端搜索你创建的机器人名称（比如”小爪”）
  2. 打开单聊窗口
  3. 发送Hello，机器人会回复配对提示（因为配置了dmPolicy为pairing）
  4. 按提示完成配对后就能正常交互了
  5. 测试一下功能，比如发个命令”介绍下自己”或者”帮我写个简单的Python代码”，验证机器人是否能正常响应

四、常见问题

Q：OpenClaw和Clawdbot、Moltbot咋回事？

这仨其实是同一个项目，只是不同阶段的命名而已：

  • 最开始叫Clawdbot
  • 后来改叫Moltbot
  • 现在正式叫OpenClaw

功能差不多，命令也兼容，所以你在网上看到的教程，不管用哪个名字，都能用。

Q：安装时提示”npm install failed”怎么办？

通常是服务器内存不足导致的，2GB内存容易出现OOM。解决方案：

  1. 配置swap空间（前面说过了）
  2. 或者升级到4GB及以上内存

Q：飞书机器人配置后收不到消息？

检查一下这些点：

  • 飞书插件是否安装成功
  • App ID和App Secret配置是否正确
  • “接收消息”事件是否订阅
  • 相关权限是否开通
  • 长连接模式是否配置（connectionMode: websocket）
  • 应用是否已发布
  • 服务是否重启（clawdbot gateway restart）

Q：OpenClaw数据安全吗？

数据存储在你自己的服务器上，不会上传第三方云端，相对安全。但是因为具备系统级权限，建议在独立服务器部署，别跟生产环境或者重要数据共用一个机器。

Q：如何更新OpenClaw到最新版本？

1
openclaw update

按提示完成更新就行了。

Q：除了飞书，还支持哪些平台？

支持：

  • WhatsApp
  • Telegram
  • Discord
  • Slack
  • 等等

需要安装对应的插件并配置，跟飞书类似。

五、核心操作总结

服务管理命令

1
2
3
4
5
6
7
8
9
10
11
# 查看状态
clawdbot status

# 重启网关
clawdbot gateway restart

# 进入Web UI
clawdbot dashboard

# 更新版本
openclaw update

飞书配置关键步骤

1
安装插件 → 创建飞书应用 → 获取凭证 → 服务器配置参数 → 重启服务 → 发布应用 → 配对测试

安全建议

  • 定期备份服务器数据
  • 不要泄露应用凭证和服务器密码
  • 限制机器人可见范围和权限
  • 在独立服务器部署

六、我的使用体验

配置好之后，现在日常用着挺顺手的。

飞书机器人能干很多事情：

  • 查服务器状态，执行一些简单的命令
  • 查文件、查日志
  • 帮我写点小脚本
  • 甚至是浏览网页、抓取数据

时间久了，它好像越来越懂我的需求了，这就是持久化记忆的作用吧。

不过刚开始配置的时候，确实遇到了一些坑。比如飞书的应用权限没搞对，导致机器人收不到消息；又比如内存不够导致安装失败。好在网上资料还挺多，慢慢都搞定了。

如果你也在玩这个，有啥问题可以一起交流。OpenClaw这东西挺有意思的，折腾一下值得。

七、进阶玩法

配置好飞书只是开始，OpenClaw还有很多好玩的地方。

多模型切换

不想用通义千问？没问题，OpenClaw支持多个模型提供商：

  • OpenAI（GPT-4、GPT-3.5）
  • Anthropic（Claude系列）
  • 各种国产模型

切换模型很简单，修改配置文件就行。

自定义技能插件

有特殊需求？自己写个插件！

OpenClaw支持自定义技能，你可以用JavaScript写自己的功能模块，比如：

  • 集成公司内部API
  • 特定的数据处理逻辑
  • 特定的工作流程

Webhook集成

需要跟其他系统集成？用Webhook：

1
2
clawdbot config set webhooks.enabled true
clawdbot config set webhooks.url "https://your-server.com/webhook"

定时任务

设置定时任务，让AI助手定期帮你干活：

1
clawdbot config set cron.enabled true

这个挺实用的，比如每天早上自动总结昨天的邮件、每周自动生成报告等等。

总结

OpenClaw这个项目，如果你是玩AI的，或者是需要自动化工作的，强烈推荐试试。

核心要点：

  1. 准备一台独立的服务器（别用生产环境）
  2. 内存最好4GB以上（2GB容易OOM）
  3. 用官方一键安装脚本最简单
  4. 飞书配置要一步步来，每一步都要验证
  5. 日志是最好的朋友，出问题了先看日志
  6. 安全别马虎，该设的防护得设

踩过的坑：

  • 内存不足导致安装失败 → 配置swap或者升级内存
  • 飞书收不到消息 → 检查权限和事件订阅
  • 长连接受连不上 → 确保网络通畅，检查connectionMode配置
  • 机器人响应慢 → 更换模型或者检查服务器资源

这个项目还在快速发展中，功能会越来越强。现在算是早期采用阶段，如果你也感兴趣，不妨一起玩玩。

祝你部署顺利，玩得开心！

更新于2026年2月8日 | 作者：洞洞

相关文章：

有问题可以留言或者直接飞书找我讨论。