OpenClaw 本地 AI 助手部署及飞书对接指南

此时应能看到 TUI 聊天界面，输入 Hello 测试是否正常响应。测试无误后，按 Ctrl+C 退出。

服务管理与 Web UI

查看服务状态

clawdbot status

若显示服务已启动，说明后台运行正常。

访问 Web 管理面板

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

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

输入密码后，在本地浏览器打开 http://127.0.0.1:18789/。初次访问可能显示未授权，回到服务器执行以下命令获取 Dashboard URL：

clawdbot dashboard

复制输出的 URL 到浏览器即可正常查看聊天记录和管理面板。首次使用时，可在对话框输入名字设置指令，例如：

Name: Openclaw My Name: Boss 

对接飞书

1. 安装飞书插件

clawdbot plugins install @m1heng-clawd/feishu

2. 创建飞书应用

登录飞书开放平台，点击「开发者后台 -> 创建企业自建应用」。

• 创建应用后，前往凭据管理获取 App ID 和 App Secret，请妥善保存。
• 添加机器人能力，配置机器人名称。

3. 配置 OpenClaw 参数

回到服务器，依次设置飞书相关配置：

clawdbot config set channels.feishu.appId "你的 App ID"
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

配置完成后重启网关：

clawdbot gateway restart

4. 配置回调与权限

回到飞书开发者后台：

1. 找到「事件和回调」，选择长连接模式。
2. 添加「接收消息」事件。
3. 开通必要权限，包括用户信息读取 (contact:user.base:readonly) 和消息收发 (im:message)。
4. 发布应用版本。注意：每次修改配置后都需重新发布版本才能生效。

发布成功后，在飞书客户端打开应用，向机器人发送 Hello，即可收到回复。

常见问题 FAQ

OpenClaw 和 Clawdbot、Moltbot 是什么关系？

三者是同一项目的不同阶段命名。最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终于 2025 年 1 月正式定名为 OpenClaw。

OpenClaw 支持哪些 AI 模型？

支持 Anthropic Claude、OpenAI GPT、通义千问（Qwen）、KIMI、小米 MiMo 等多种服务商。本教程选用 Qwen 因其免费额度友好。

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

通常是服务器内存不足。建议配置 swap 交换空间，将硬盘空间作为虚拟内存使用。

OpenClaw 可以在 Windows 或 macOS 上运行吗？

可以。支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例，其他系统请参考官方文档。

飞书机器人配置后无法收到消息怎么办？

检查以下几点：

1. 飞书插件是否安装成功
2. App ID 和 App Secret 是否填错
3. 是否开通了「接收消息」事件权限
4. 长连接模式是否配置成功
5. 应用版本是否已发布

OpenClaw 数据安全吗？

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

如何更新 OpenClaw？

使用以下命令更新至最新版本：

openclaw update

OpenClaw 命令和 clawdbot 命令有什么区别？

更名后官方推荐使用 openclaw 命令，但为了兼容性 clawdbot 依然可用，两者功能相同。