OpenClaw 保姆级安装部署教程

🦞 OpenClaw 保姆级安装部署教程

从零开始，手把手教你搭建自己的 AI 助手

作者：nihao561
更新时间：2026年2月

📋 目录

前言
环境准备
[安装 Node.js](#安装 Node.js)
[安装 OpenClaw](#安装 OpenClaw)
配置飞书机器人
启动与测试
常见问题
进阶配置

🎯 前言

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手框架，你可以把它理解为**「私人贾维斯」**。它可以：

✅ 接入多种 AI 大模型（Kimi、GPT、Claude 等）
✅ 连接多个社交平台（飞书、Discord、Telegram 等）
✅ 帮你操作电脑（执行命令、读写文件、浏览器自动化）
✅ 7×24 小时待命，随时响应

本教程适合谁？

✅ 技术人员，想自己部署 AI 助手
✅ 爱好者，想体验本地 AI 能力
✅ 想搭建私人助理的企业/个人

🛠 环境准备

1. 系统要求

项目	最低配置	推荐配置
操作系统	Windows 10 / Ubuntu 20.04 / macOS 12	Windows 11 / Ubuntu 22.04
Node.js	v18+	v20 LTS
内存	4GB	8GB+
磁盘	2GB	10GB+
网络	能访问国际网络	稳定宽带

2. 需要准备的账号

飞书账号（企业版或个人版均可）
OpenClaw 账号（可选，用于插件市场）

📦 安装 Node.js

OpenClaw 基于 Node.js 开发，第一步必须安装它。

Windows 用户

打开浏览器，访问：https://nodejs.org/
下载 LTS（长期支持版），建议 v20.x
运行安装包，全程点「下一步」
打开 CMD 或 PowerShell，验证安装：

bash 复制代码

node --version
# 应该显示 v20.x.x

npm --version
# 应该显示 10.x.x

macOS 用户

bash 复制代码

# 使用 Homebrew（推荐）
brew install node

# 或者直接下载 pkg 安装包

Linux 用户

bash 复制代码

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version

🦞 安装 OpenClaw

方式一：npm 全局安装（推荐）

bash 复制代码

# 安装 OpenClaw CLI
npm install -g openclaw

# 验证安装
openclaw --version

方式二：Git 克隆（开发版）

bash 复制代码

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
npm install

# 编译
npm run build

方式三：Docker 安装

如果你熟悉 Docker，可以用这种方式：

bash 复制代码

# 拉取镜像
docker pull openclaw/openclaw

# 运行
docker run -d -p 3000:3000 -v ~/.openclaw:/root/.openclaw openclaw/openclaw

🐟 配置飞书机器人

飞书是 OpenClaw 支持最完善的渠道之一，以下是配置步骤。

第一步：创建飞书应用

打开飞书开放平台
登录你的飞书账号
点击 「创建企业自建应用」
填写应用名称（如「我的 AI 助手」）
添加应用图标（可选）

第二步：获取应用凭证

创建完成后，在应用页面找到 「凭证与基础信息」：

App ID ：类似 cli_xxxxxxxxx
App Secret ：类似 xxxxxxxxx

⚠️ 重要：App Secret 只显示一次，请立即保存！

第三步：配置应用权限

进入 「权限管理」
点击 「批量导入」
粘贴以下权限 JSON：

json 复制代码

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:chat",
      "im:chat.members:bot_access",
      "im:message.p2p_msg:readonly",
      "im:message.group_msg"
    ],
    "user": [
      "im:message.p2p_msg:readonly"
    ]
  }
}

点击 「批量导入」

第四步：启用机器人

进入 「应用能力」 → 「机器人」
开启 「机器人能力」
设置机器人名称

第五步：配置事件订阅

进入 「事件订阅」
选择 「使用长连接接收事件」（WebSocket 模式）
添加事件：im.message.receive_v1
点击保存

第六步：发布应用

进入 「版本管理与发布」
创建新版本
提交审核
发布（企业自建应用通常自动通过）

⚙️ 配置 OpenClaw

方式一：交互式配置（推荐新手）

bash 复制代码

# 启动配置向导
openclaw channels add

按提示选择 Feishu，输入 App ID 和 App Secret 即可。

方式二：手动配置文件

OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json（Linux/Mac）或 C:\Users\你的用户名\.openclaw\openclaw.json（Windows）。

创建或编辑配置文件：

json 复制代码

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "你的App ID",
          "appSecret": "你的App Secret",
          "botName": "AI助手"
        }
      }
    }
  },
  "model": {
    "provider": "opencode",
    "model": "minimax-m2.5-free"
  }
}

方式三：环境变量

bash 复制代码

# Windows (PowerShell)
$env:FEISHU_APP_ID = "cli_xxx"
$env:FEISHU_APP_SECRET = "xxx"

# Linux/Mac
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

🚀 启动与测试

1. 启动网关

bash 复制代码

# 启动网关服务
openclaw gateway start

# 查看状态
openclaw gateway status

# 查看实时日志
openclaw logs --follow

2. 配对飞书

首次使用时，你需要和机器人配对：

在飞书中找到你的机器人
发送一条消息
机器人会回复一个 配对码
在命令行批准：

bash 复制代码

openclaw pairing approve feishu <配对码>

3. 开始使用

配对成功后，你就可以和机器人对话了！

试试发送：

「帮我查一下今天的天气」
「帮我打开 VSCode」
「给我讲个笑话」

❓ 常见问题

Q1: 启动失败，提示端口被占用？

bash 复制代码

# 查找占用端口的进程
netstat -ano | findstr "3000"

# 或者修改配置中的端口

Q2: 收不到飞书消息？

检查应用是否已发布
检查事件订阅是否配置正确
查看日志：openclaw logs --follow

Q3: 如何更换 AI 模型？

在配置文件中修改 model 部分：

json 复制代码

"model": {
  "provider": "openai",
  "apiKey": "你的API Key",
  "model": "gpt-4o"
}

Q4: 如何让机器人自动回复群消息？

在 channels.feishu 中配置：

json 复制代码

"groupPolicy": "open",
"groups": {
  "群ID": {
    "requireMention": true
  }
}

🔧 进阶配置

1. 配置多个渠道

OpenClaw 支持同时接入多个平台：

json 复制代码

{
  "channels": {
    "feishu": { "enabled": true },
    "discord": { "enabled": true },
    "telegram": { "enabled": true }
  }
}

2. 配置 Claude 模型

json 复制代码

{
  "model": {
    "provider": "anthropic",
    "apiKey": "你的Claude API Key"
  }
}

3. 配置手机远程控制

如果你想让 AI 也能控制手机：

在手机上安装 OpenClaw 客户端
扫码配对
即可远程截图、执行命令

4. Docker 部署

yaml 复制代码

# docker-compose.yml
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw
    ports:
      - "3000:3000"
    volumes:
      - ./config:/root/.openclaw
    environment:
      - FEISHU_APP_ID=xxx
      - FEISHU_APP_SECRET=xxx

bash 复制代码

# 启动
docker-compose up -d

📚 相关链接

🌐 OpenClaw 官网：https://openclaw.ai
📖 官方文档：https://docs.openclaw.ai
💬 社区支持：https://discord.com/invite/clawd
🐙 GitHub：https://github.com/openclaw/openclaw

☕ 致谢

感谢 OpenClaw 团队的开源工作，让每个人都能拥有自己的 AI 助手。

本文作者：nihao561 🦞
如需转载，请注明出处