在 Linux (Debian 13.3.0) 从源码安装 OpenClaw + Feishu Bot

本指南介绍如何在没有预装 Node.js 环境的 Debian/Ubuntu Linux 系统上，从克隆的代码仓库构建并运行 OpenClaw。

• Debian/Ubuntu 系系统（已在 Debian 13 / amd64 上验证）
• 可用的 或
• 已克隆代码仓库（）
• 需要 Node.js 22+（如未安装，参见第 1 步）

OpenClaw 使用 pnpm 作为包管理器。安装 （ 字段）中锁定的版本：

在仓库根目录执行：

这会安装所有工作区依赖（包括 下的扩展插件），并运行 钩子配置 git hooks。首次运行时需要拉取和构建原生插件（、 等），可能需要几分钟。

安装过程中可能会看到以下警告，属正常现象，不影响构建：

目录现在包含可由 Node.js 直接运行的所有编译产物。

输出正常即表示 CLI 入口 已正确解析到 。

向导引导你完成 gateway 配置、连接 AI 模型凭证，并可选安装 systemd 用户服务以在登录时自动启动。

向导过程中会提示：

1. 选择 AI 提供商并粘贴 API Key（如 Anthropic、OpenAI、Google Gemini）。
2. 配置 gateway 端口（默认：）。
3. 可选安装 systemd 用户级守护进程（ 会预先勾选此项）。

如果跳过了守护进程安装，手动启动 gateway：

让它在终端中保持运行（或使用 ）。Gateway 现在监听并准备好处理 Agent 请求和频道连接。

在另一个终端中（如需要，先执行 ）：

Agent 会调用已配置的 AI 提供商，并将回复打印到标准输出。

在修改源码时，可通过 直接运行 TypeScript，无需重新构建：

等效于 ，但跳过了构建步骤。

完成后，将包安装到 nvm 管理的 Node 全局目录：

然后重新加载 Shell 配置，使 nvm bin 目录进入 ：

这是一次性操作。此后所有加载 的交互终端都能直接使用 。

为什么出现 ？ nvm 将自身写入 ，而该文件只在
交互式 Shell 启动时被加载。如果当前终端会话早于 nvm 安装，或处于非交互上下文
（tmux、无登录 Shell 的 SSH），需手动执行 激活，再执行
使其完全生效。

完整文档：https://docs.openclaw.ai/start/getting-started

内置 Web UI 无需配置任何频道，gateway 启动后即可使用：

默认会在浏览器中打开 ，你可以：

• 直接在浏览器中与 Agent 对话。
• 实时观看工具调用事件和推理过程流式输出。
• 查看会话历史，管理工作区。
• 通过界面配置频道、技能和 gateway 设置。

若浏览器未自动打开，手动访问 （远程访问openclaw 安装时将 替换为 gateway 主机 IP）。

命令向助手发送单轮消息并打印回复。必须指定会话目标——最简单的方式是 （默认 Agent）：

Agent 可访问的内置工具（文件浏览、网页搜索、Shell 执行、画布、定时任务等）取决于已安装的技能和已授权的执行权限。

注意： 省略 （或 / ）会报错：
。
三者必选其一。

引导向导可安全地重复运行——它保留现有配置，只更新你修改的部分：

完全重置（清空所有配置重新引导）：

运行 时提供两种路径：

向导按顺序经过以下节：

1. 模型 / 认证 — 选择提供商（Anthropic、OpenAI、Gemini 或自定义兼容端点），通过 API Key 或 OAuth 认证。
2. 工作区 — Agent 读写文件的位置（默认：）。
3. Gateway — 端口、绑定地址、认证令牌、可选 Tailscale 广域暴露。
4. 频道 — 连接 WhatsApp、Telegram、Discord、Slack、Google Chat、Signal、BlueBubbles、iMessage 等，每个频道有独立的凭证配置流程。
5. 守护进程 — 安装 systemd 用户服务，重启后自动启动 gateway。
6. 健康检查 — 确认 gateway 启动成功。
7. 技能 — 安装推荐工具包（网页搜索、编码工具、记忆等）。

OpenClaw 支持多个隔离的 Agent，每个 Agent 拥有独立的工作区、模型和频道路由：

技能扩展 Agent 的能力（网页浏览、记忆、代码执行等）：

配置好频道（如 Telegram 或 WhatsApp）后，可以从 CLI 主动推送消息：

查询自己的频道 ID：

不将凭证写入配置文件的最简方式是在 Shell 配置文件中导出，或按需内联传入：

• 连接消息频道：频道概览
• 安装记忆或网页搜索技能：技能
• 配置 macOS 伴侣应用：macOS
• 查阅完整引导参考：Onboarding
• 阅读向导指南：Wizard

飞书提供了一个独立的引导助手 CLI，托管在其 CDN：

为什么不用 ？ dist-tag 会解析到较旧的 ，
其 声明了 。
OpenClaw 的路径包含检查会拒绝 源文件入口——只接受编译后的 入口。
稳定版 使用 ，可正常工作。

如果插件目录消失： gateway 的进程内重启有时会清理 extensions 目录。
若 不见了，重新执行上方安装命令即可，
该命令可安全重复执行。

1. 前往 https://open.feishu.cn/app（国际版 Lark 使用
   ）。
   
2. 创建自建应用（或打开已有应用）。
3. 进入凭证与基础信息，复制 App ID（以 开头）和 App Secret。

插件使用 WebSocket 长连接模式。未启用此设置时，Bot 能启动但会立即报错且无法接收消息。

在飞书开发者后台（你的应用页面）：

1. 左侧菜单 → 事件与回调
2. 找到订阅方式
3. 选择使用长连接接收事件
4. 保存。

同时添加以下事件订阅，使 Bot 能接收消息：

并在权限管理中开通以下权限：

确认频道在线：

审批后，该发件人的所有后续私信将被路由到 Agent，并通过飞书回复。

飞书频道文档：https://docs.openclaw.ai/channels/feishu