OpenClaw 本地 AI 助手部署与飞书对接实战

若遇到 npm install failed 错误，通常是服务器内存不足导致 OOM。建议配置 Swap 交换空间，将部分硬盘作为虚拟内存使用。

初始化配置

安装成功后会进入 Onboarding 向导，按以下步骤操作：

1. 安全确认：输入 yes 确认了解安全风险。OpenClaw 拥有较高权限，需谨慎对待。
2. 启动模式：选择 QuickStart 快速配置。
3. 模型选择：推荐选择 Qwen (OAuth)，免费额度充足，适合入门。
4. 授权登录：复制提供的链接到浏览器，完成 OAuth 授权并选择默认模型（如 qwen-portal/coder-model）。
5. 通道跳过：初次安装可先选择 Skip for now，后续再单独配置。
6. 功能插件：选择 No 跳过复杂插件配置。
7. 启动方式：选择 Hatch in TUI 进入终端聊天界面测试。

此时可在 TUI 界面输入 Hello 进行测试。测试完成后按 Ctrl+C 退出。

服务状态与 Web UI

查看服务状态

openclaw status

若显示 Gateway service ... running，说明服务已正常启动。

访问管理面板

服务默认监听在 http://127.0.0.1:18789/。由于是本地端口，需通过 SSH 隧道映射到本地访问。

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

隧道建立后，在浏览器打开 http://127.0.0.1:18789/ 即可看到 Dashboard。首次访问可能提示未授权，需在服务器端执行以下命令获取 Token URL：

openclaw dashboard

复制输出的完整链接（包含 token）在浏览器打开，即可查看聊天记录和管理后台。

对接飞书机器人

这是本文的核心部分。回到配置流程，选择添加 Feishu/Lark 通道。

◆ Select a channel
● Feishu/Lark (飞书)

系统会自动尝试安装对应的扩展包。如果遇到模块缺失错误（如 Cannot find module 'zod'），请先全局安装依赖并清理旧扩展：

npm install -g zod
rm -rf ~/.openclaw/extensions/feishu

随后再次选择飞书通道，按提示填入 App ID 和 App Secret。

飞书开放平台配置

1. 登录 飞书开放平台，创建企业自建应用。
2. 在凭据管理中获取 App ID 和 App Secret。
3. 添加机器人能力，配置名称。
4. 在「事件与回调」中开启长连接模式，并订阅「接收消息」事件。
5. 开通必要权限：contact:user.base:readonly 和 im:message。
6. 发布应用版本。

配置 OpenClaw 参数

回到 OpenClaw 配置界面，依次填入：

• App ID：飞书应用凭证
• App Secret：飞书应用密钥
• Domain：选择 Feishu (feishu.cn)
• Group Policy：选择 Open 以响应所有群组（需提及机器人）
• DM Policy：选择 Open 允许公开 DM

配置完成后，重启网关使生效：

openclaw gateway restart

重启后回到飞书客户端，点击应用图标，向机器人发送 Hello 即可收到回复。

常用命令速查

常见问题 FAQ

为什么安装时提示 npm install failed？

多为服务器内存不足。新版脚本对内存要求提升，2GB 内存容易出现 OOM。建议配置 Swap 交换空间。

如何配置 Swap？

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

飞书收不到消息怎么办？

1. 确认通道已正确安装。
2. 核对 App ID 和 App Secret 无误。
3. 检查是否开启了「接收消息」事件权限。
4. 确认长连接模式配置成功。
5. 确保应用版本已发布。
6. 执行 openclaw gateway restart 重启服务。

可以在 Windows 或 macOS 上运行吗？

可以。OpenClaw 支持多系统，本文以 Linux 为例，其他系统安装逻辑基本一致。

数据安全吗？

数据存储在本地服务器，不会上传第三方云端。但因其具备系统级权限，建议在独立服务器上部署，避免影响生产环境。