# **引言：为什么选择在 Linux 上部署 OpenClaw？**


Linux 是服务器和开发者的首选操作系统，以其稳定性、安全性和强大的命令行工具而闻名。OpenClaw（昵称“小龙虾”）作为 GitHub 上星标超 28 万的开源 AI 智能体框架，其设计哲学与 Linux 的“一切皆文件”和“组合小工具”的理念不谋而合。

在 Linux 上部署 OpenClaw，您可以获得：


- **极致的性能与稳定性**：直接运行在裸机上，无虚拟化开销，资源利用率最高。

- **完美的自动化体验**：通过 `systemd` 服务，可以轻松实现开机自启、后台常驻和日志管理。

- **强大的可扩展性**：Linux 丰富的软件生态和包管理器（如 `apt`、`yum`）让依赖管理和环境配置变得简单高效。

- **成本效益**：无论是老旧的 PC 还是云上的 VPS，只要满足基本要求，都能成为您专属的 AI 助理服务器。


本文将为您提供一份**保姆级**的 Linux 本地部署指南，并详细讲解如何将其接入飞书，打造一个 7x24 小时在线的企业智能助手。我们将重点关注并规避 Linux 环境下常见的各种“坑”，确保您能一次成功。


----

# **第一章：环境准备——打好坚实基础**


在开始之前，请确保您的 Linux 机器满足以下要求，并完成必要的软件安装。本教程以 **Ubuntu 22.04 LTS** 为例，其他发行版（如 CentOS, Debian）的操作大同小异。

## **1.1 系统与硬件要求**


- **操作系统**：Ubuntu 22.04 LTS / 24.04 LTS, Debian 12, CentOS Stream 9 等主流 64 位发行版。

- **CPU**：双核或以上。

- **内存**（RAM） **强烈建议 4GB 或以上**。8GB 是更理想的体验。

- **存储**（硬盘） **至少预留 2GB 的可用空间**。SSD 能显著提升模型加载和响应速度。

- **网络**：稳定的互联网连接，用于下载依赖和模型。


## **1.2 软件依赖安装**


我们需要安装 `git`、`curl` 和 **Node.js**（OpenClaw 的核心运行时）。

### **1.2.1 更新系统并安装基础工具**


首先，更新您的系统包列表并安装 `git` 和 `curl`。

```
# 更新包列表
sudo apt update

# 安装 git 和 curl
sudo apt install -y git curl
```
### **1.2.2 安装 Node.js (推荐 v22.x)**


OpenClaw 官方推荐使用 **Node.js 22.x**（LTS 版本）。我们将通过官方仓库进行安装，以确保版本的准确性和安全性。

```
# 下载并运行 NodeSource 的安装脚本
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证安装
node --version  # 应输出 v22.x.x
npm --version   # 应输出 10.x.x
```
**重要提示**：虽然 `bun` 运行时速度更快，但官方明确指出其在 Linux 上存在与 WhatsApp/Telegram 集成的 bug，**因此强烈建议使用 `npm`**。


----

# **第二章：安装与初始化 OpenClaw**


现在，我们正式开始安装 OpenClaw。

## **2.1 全局安装 OpenClaw CLI**


OpenClaw 提供了一个便捷的命令行工具（CLI），可以通过 `npm` 全局安装。

```
# 全局安装 OpenClaw
sudo npm install -g openclaw@latest

# 验证安装
openclaw --version
```
如果能看到版本号，则说明安装成功。

## **2.2 运行 Onboard 向导**


`onboard` 命令是 OpenClaw 的交互式初始化向导，它会引导您完成首次配置，包括选择 AI 模型、设置记忆等。

```
# 运行初始化向导
openclaw onboard
```
**Onboard 流程详解**：


1. **欢迎界面**：阅读并确认 OpenClaw 的功能和隐私声明。

2. **选择 AI 模型提供商**：
	- **云端模型**：如 OpenAI (GPT), Anthropic (Claude), 国内的通义千问、文心一言等。您需要提供相应的 API Key。
	- **本地模型**（推荐） 如 Ollama。这是最安全、最私有的选择。如果您选择此项，向导会提示您先安装 Ollama。

3. **配置模型**：根据您选择的提供商，输入 API Key 或选择具体的 Ollama 模型（如 `qwen:7b`、`llama3:8b`）。

4. **设置记忆**：OpenClaw 支持向量记忆，可以让助手越用越懂你。向导会询问您是否启用此功能。

5. **完成**：向导会生成配置文件，并提示您下一步操作。


**常见问题**：


- **Ollama 未安装**：如果您选择了本地模型，但系统未检测到 Ollama，向导会给出安装链接。您可以按 `Ctrl+C` 退出向导，先安装 Ollama，再重新运行 `onboard`。```
	# 安装 Ollama (Linux)
	curl -fsSL https://ollama.com/install.sh | sh
	```

- **国内网络问题**：如果下载模型缓慢，可以考虑使用国内镜像源或手动下载模型后导入 Ollama。


## **2.3 安装并启动 Gateway 服务**


Gateway 是 OpenClaw 的核心网关服务，负责处理与各个聊天平台（如飞书、Telegram）的通信。

在 `onboard` 向导的最后，它会提示您安装 Gateway 作为系统服务。这是一个**关键步骤**，能确保 OpenClaw 在后台稳定运行。

```
# 安装 Gateway 为系统服务（自动开机自启）
openclaw onboard --install-daemon

# 启动 Gateway 服务
sudo systemctl start openclaw-gateway.service

# 查看服务状态
sudo systemctl status openclaw-gateway.service
```
如果状态显示 `active (running)`，则说明 Gateway 已成功启动。

**验证 Gateway**：
Gateway 默认监听 `127.0.0.1:18789`。您可以通过以下命令检查端口是否已打开：

```
ss -tuln | grep 18789
```


----

# **第三章：深度集成——将 OpenClaw 接入飞书**


现在，让我们把本地部署的 OpenClaw 变成一个飞书群聊机器人。

## **3.1 在飞书开发者后台创建应用**


1. 访问 [飞书开放平台](https://open.feishu.cn/app)。

2. 点击 “创建企业自建应用”。

3. 填写应用名称（如 “我的AI助理”），点击 “确定创建”。

4. 在应用详情页，进入 “应用功能” -> “机器人”。

5. 开启 “启用机器人”。

6. **获取凭证**：在左侧导航栏找到 “凭证与基础信息”，复制 **App ID** 和 **App Secret**。这两个值稍后会用到。

7. **配置权限**：进入 “权限管理” -> “申请权限”。
	- 搜索并添加以下关键权限（这些是机器人正常工作的最低要求）：
		- `im:message` (读取和发送消息)
		- `im:chat` (获取群聊信息)
		- `contact:user` (获取用户信息)
	- **重要补充**：很多教程会遗漏事件订阅权限。为了确保机器人能正确响应消息，还需要添加以下事件回调权限（在“事件订阅”中勾选）：
		- `im.message.receive_v1`
		- `im.chat.member.bot.added_v1`
		- `im.chat.member.bot.deleted_v1`


## **3.2 在 OpenClaw 中配置飞书通道**


OpenClaw 使用 `channel` 命令来管理不同的聊天平台连接。


1. **添加飞书通道**：
	```
	openclaw channel add feishu
	```
	执行此命令后，CLI 会进入交互模式。

2. **输入凭证**：
	- 当提示输入 `App ID` 时，粘贴您从飞书后台复制的 App ID。
	- 当提示输入 `App Secret` 时，粘贴 App Secret。

3. **完成配对**：
	命令执行后，CLI 会输出一个 **配对码**（Pairing Code），例如 `ECX3H5PY`。
	```
	# 使用配对码批准连接
	openclaw pairing approve feishu ECX3H5PY
	```
	如果看到 `Pairing approved!` 的提示，则说明配对成功。


## **3.3 将机器人添加到飞书群聊**


1. 打开您的飞书客户端。

2. 创建一个新的群聊，或者进入一个现有的群聊。

3. 点击群成员列表，选择 “添加成员”。

4. 在搜索框中，输入您在飞书开放平台创建的应用名称（如 “我的AI助理”）。

5. 将机器人添加到群聊中。


**测试**：
在群聊中 @ 机器人并发送一条消息，例如 “你好”。如果一切配置正确，机器人应该会很快给出回复。


----

# **第四章：运维与排错——保障服务稳定运行**


## **4.1 日志查看**


OpenClaw Gateway 作为 `systemd` 服务运行，其日志可以通过 `journalctl` 查看。

```
# 查看实时日志
sudo journalctl -u openclaw-gateway.service -f

# 查看最近100行日志
sudo journalctl -u openclaw-gateway.service -n 100
```
## **4.2 常见问题及解决方案**


- **问题1：`systemctl is-enabled unavailable` 错误**。
	- **原因**：该错误通常出现在非交互式 shell 或某些容器环境中。
	- **解决方案**：确保您是在一个完整的用户会话中执行命令。如果是通过 SSH 连接，请确保使用了 `-t` 参数分配伪终端。

- **问题2：飞书机器人无响应**。
	- **排查步骤**：
		1. 检查 Gateway 服务是否正在运行 (`systemctl status`)。
		2. 检查飞书应用的 **事件订阅** 是否已开启，并且 **回调地址** 是否正确（对于本地部署，通常需要内网穿透，但 OpenClaw 的 P2P 架构可能已处理此问题，请查阅最新文档）。
		3. **最关键的一步**：确认是否已申请并批准了所有必要的 **事件回调权限**（如 `im.message.receive_v1`）。这是最常见的疏漏点。

- **问题3：模型响应慢或报错**。
	- **原因**：可能是 API Key 无效、本地模型未正确加载或网络问题。
	- **解决方案**：检查 `~/.openclaw/config.json` 中的模型配置，并通过 `ollama list` 或直接调用 API 来验证模型本身是否可用。


## **4.3 卸载 OpenClaw**


如果您需要完全卸载 OpenClaw，可以按照以下步骤操作：

```
# 停止并禁用服务
sudo systemctl stop openclaw-gateway.service
sudo systemctl disable openclaw-gateway.service

# 删除服务文件
sudo rm /etc/systemd/system/openclaw-gateway.service

# 重新加载 systemd
sudo systemctl daemon-reload

# 卸载全局 npm 包
sudo npm uninstall -g openclaw

# 删除配置和数据目录
rm -rf ~/.openclaw
```


----

**恭喜您！您已经成功在 Linux 上部署了 OpenClaw 并将其接入飞书！您现在拥有一个完全私有、安全可控、7x24小时待命的AI智能体。如果您在操作过程中遇到任何问题，或者觉得这篇教程对您有帮助，欢迎在评论区留言交流。别忘了点赞、收藏、关注，以便获取更多 AI 和 Linux 运维相关的实战教程！**

Linux 是服务器和开发者的首选操作系统，以其稳定性、安全性和强大的命令行工具而闻名。OpenClaw（昵称“小龙虾”）作为 GitHub 上星标超 28 万的开源 AI 智能体框架，其设计哲学与 Linux 的“一切皆文件”和“组合小工具”的理念不谋而合。

Linux 本地部署 OpenClaw！完整安装教程 + 飞书接入，全程避坑——从零开始，手把手教你搭建企业级AI智能体，并无缝集成飞书

人工智能

操作系统

开发工具

Linux部署OpenClaw开源AI框架指南：详细讲解Ubuntu等系统环境准备、Node.js安装、OpenClaw初始化配置及飞书机器人集成方法。提供保姆级教程，解决Linux环境下常见问题，实现7x24小时AI助手服务，适合企业智能助手搭建。

命令行工具

包管理器

服务器

智能体

虚拟化

CentOS

GitHub

Debian

容器

Linux

2026采购季 | AI焕新·智启新局

llmsgw

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Linux 本地部署 OpenClaw！完整安装教程 + 飞书接入，全程避坑——从零开始，手把手教你搭建企业级AI智能体，并无缝集成飞书-腾讯云开发者社区-腾讯云

Linux 本地部署 OpenClaw！完整安装教程 + 飞书接入，全程避坑——从零开始，手把手教你搭建企业级AI智能体，并无缝集成飞书

Linux 本地部署 OpenClaw！完整安装教程 + 飞书接入，全程避坑——从零开始，手把手教你搭建企业级AI智能体，并无缝集成飞书

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐