JavaScriptNode.jsAI
OpenClaw 本地 AI 助手部署与飞书对接指南
介绍如何在 Linux 环境下部署开源本地 AI 助手 OpenClaw，并完成与飞书机器人的对接。内容包括环境准备（Node.js、Git）、OpenClaw 安装流程、模型配置（以通义千问为例）、Web UI 访问方式以及飞书应用创建与权限设置。通过该指南，用户可搭建自主可控的 AI 助手，实现消息交互、文件管理及代码执行等功能。
介绍如何在 Linux 环境下部署开源本地 AI 助手 OpenClaw，并完成与飞书机器人的对接。内容包括环境准备（Node.js、Git）、OpenClaw 安装流程、模型配置（以通义千问为例）、Web UI 访问方式以及飞书应用创建与权限设置。通过该指南，用户可搭建自主可控的 AI 助手，实现消息交互、文件管理及代码执行等功能。
OpenClaw 是一款开源的本地 AI 助手，支持在 Linux、macOS 或 Windows (WSL2) 系统下部署。它运行在你的服务器上，通过飞书、WhatsApp、Telegram 等聊天工具交互。与云端 SaaS 服务不同，OpenClaw 让你完全掌控数据隐私，可以执行系统命令、浏览网页、管理文件，甚至编写代码。
安装 OpenClaw 需要满足以下环境要求：
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux（推荐）/ macOS / Windows (WSL2) |
| Node.js | ≥ 22.x |
| 内存 | ≥ 2GB（建议 4GB，否则需配置 swap） |
| 网络 | 能访问 GitHub、npm 仓库 |
| AI 模型 | 通义千问、OpenAI、Claude、KIMI 等任一 API Key |
第一步安装 Git
sudo apt update && sudo apt install git -y
第二步安装 Node.js
# 国内使用 gitee 的镜像源
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 国外使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 重新加载环境变量
source ~/.bashrc
# 安装 Node.js 22
nvm install 22
# 查看 nodejs 版本
node -v # 输出 v22 即可
使用官方脚本安装：
curl -fsSL https://openclaw.bot/install.sh | bash
如果首次安装，时间会很长，需要耐心等待。如果最后输出 npm install failed，通常是由于服务器内存不足导致的 OOM（内存溢出）。建议使用 swap 把硬盘空间当作虚拟内存使用。
成功之后会看到安装成功的提示。如果首次安装，会进入 Onboarding 向导：
Yes 确认理解安全风险。QuickStart 模式。Qwen (OAuth)，免费额度充足。Keep current (qwen-portal/coder-model)。No。Hatch in TUI。如果看到 TUI 聊天界面，说明安装成功，可以尝试输入 Hello 进行测试。
openclaw status
服务监听在 http://127.0.0.1:18789/ 端口上，通过 SSH 隧道访问：
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
然后在浏览器打开 http://127.0.0.1:18789/。首次访问可能需要获取 Token，可在服务器输入 openclaw dashboard 获取 Dashboard URL。
回到刚才的配置向导，选择 Feishu/Lark (飞书) 添加通道。
Download from npm(@openclaw/feishu) 安装扩展。Feishu (feishu.cn)，群组策略选择 Open。Open。openclaw gateway restart。contact:user.base:readonly 和 im:message。发布完成后，回到飞书客户端，点击打开应用，向机器人发送 Hello 即可收到回复。
| 命令 | 功能 |
|---|---|
openclaw status | 查看 OpenClaw 运行状态 |
openclaw onboard | 重新进入配置向导 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw gateway restart | 重启服务 |
openclaw update | 更新到最新版本 |
openclaw health | 健康检查 |
openclaw doctor | 诊断问题 |
openclaw dashboard | 获取 Web UI 访问链接 |
openclaw security audit --deep | 安全审计 |
openclaw uninstall | 卸载 OpenClaw |
OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终定名为 OpenClaw。三者是同一个项目的不同阶段命名。
这通常是服务器内存不足导致的。新版本脚本对内存要求较高，2G 内存可能会出现 OOM。建议配置 swap 交换空间。
请检查以下几点：
openclaw gateway restart 重启服务后再试。如果服务器内存不足 2GB，可以配置 swap 交换空间：
# 创建 2G 的 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
使用其他端口启动服务：
openclaw gateway --port 18790
这通常是环境变量未加载导致的。尝试以下步骤：
source ~/.bashrc 重新加载环境变量。openclaw doctor 检查问题。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online