零基础安装部署openClaw并接入飞书/企业微信 超详细教程

前言

openClaw 是一款轻量级的开源办公自动化工具，支持对接飞书、企业微信等主流办公平台，可快速实现消息推送、审批处理、定时任务等自动化场景。本文将从环境准备、openClaw 部署、飞书/企业微信接入三个维度，手把手教零基础用户完成整套部署流程，所有步骤均附带实操截图，确保一看就会。

一、环境准备

1.1 硬件/系统要求

• 硬件：任意能运行 Linux 的服务器/虚拟机（推荐 1核2G 及以上），本地 Windows/macOS 也可测试
• 系统：CentOS 7/8、Ubuntu 20.04+（本文以 CentOS 7 为例）
• 网络：服务器可访问外网（需拉取开源代码、安装依赖）

1.2 基础软件安装

1.2.1 安装 Python 3.8+（openClaw 核心依赖）

openClaw 基于 Python 开发，需先安装 Python 3.8 及以上版本，步骤如下：

1. 安装依赖包：

yum install -y gcc zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel libffi-devel

2. 下载 Python 3.9.18（稳定版）：

wget https://www.python.org/ftp/python/3.9.18/Python-3.9.18.tgz

3. 解压并编译安装：

tar -zxvf Python-3.9.18.tgz
cd Python-3.9.18
./configure --prefix=/usr/local/python3 --enable-optimizations
make && make install

4. 配置软链接（避免命令冲突）：

ln -s /usr/local/python3/bin/python3 /usr/bin/python3
ln -s /usr/local/python3/bin/pip3 /usr/bin/pip3

5. 验证安装：

python3 -V  # 输出 Python 3.9.18 即为成功
pip3 -V     # 输出 pip 版本即为成功

1.2.2 安装 Git（拉取 openClaw 源码）

yum install -y git
# 验证
git --version  # 输出 git version 即为成功

二、openClaw 安装部署

2.1 拉取 openClaw 源码

# 创建工作目录
mkdir -p /opt/openClaw && cd /opt/openClaw
# 拉取源码（官方仓库）
git clone https://github.com/openClaw/openClaw.git .

2.2 安装 Python 依赖

openClaw 提供了依赖清单 requirements.txt，直接安装即可：

# 进入源码目录（已在该目录可跳过）
cd /opt/openClaw
# 安装依赖
pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

2.3 初始化配置文件

openClaw 的核心配置在 config.yaml，先复制模板并修改：

# 复制模板配置
cp config.example.yaml config.yaml
# 编辑配置文件（用 vi 编辑器，零基础也可先用 FileZilla 下载本地修改）
vi config.yaml

基础配置只需修改以下内容（其余默认即可）：

# 服务基础配置
server:
  port: 8080  # 启动端口，确保未被占用
  debug: true # 测试环境开启 debug，生产环境关闭
# 数据库配置（默认 SQLite，无需修改，自动生成）
database:
  type: sqlite
  path: ./openclaw.db

2.4 启动 openClaw 服务

# 启动服务（前台运行，测试用）
python3 main.py
# 后台运行（生产环境推荐）
nohup python3 main.py > openclaw.log 2>&1 &

启动成功后，终端会输出：

INFO:     Started server process [12345]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8080 (Press CTRL+C to quit)

2.5 验证服务是否可用

打开浏览器，访问 http://服务器IP:8080（本地测试用 http://127.0.0.1:8080），能看到 openClaw 首页即表示部署成功。

三、接入飞书（Lark）

3.1 飞书应用创建与配置

步骤1：进入飞书开发者平台

打开飞书开发者平台：https://open.feishu.cn/，登录企业管理员账号，进入 “企业自建应用” → “创建应用”。

步骤2：填写应用信息

• 应用名称：openClaw 对接（自定义）
• 应用描述：办公自动化对接（自定义）
• 应用图标：可选默认
  填写完成后点击 “创建”。

步骤3：获取应用密钥

进入应用 “凭证与基础信息” 页面，复制：

• App ID
• App Secret
• Encrypt Key（若开启消息加密需用，测试可先关闭）

步骤4：配置事件订阅（可选）

若需接收飞书消息/事件，需配置：

• 事件订阅地址：http://服务器IP:8080/api/lark/callback
• 勾选需要的事件（如 “消息接收”、“审批状态变更”）

3.2 openClaw 配置飞书对接

编辑 config.yaml，添加飞书配置：

# 飞书配置
lark:
  app_id: 你的飞书App ID
  app_secret: 你的飞书App Secret
  encrypt_key: 你的飞书Encrypt Key（无则留空）
  callback_url: http://服务器IP:8080/api/lark/callback

保存后重启 openClaw：

# 停止后台进程（先查PID）
ps -ef | grep python3
kill -9 进程ID
# 重新启动
nohup python3 main.py > openclaw.log 2>&1 &

3.3 测试飞书对接

调用 openClaw 测试接口（替换为实际飞书用户ID）：

curl -X POST http://服务器IP:8080/api/lark/send_msg \
-H "Content-Type: application/json" \
-d '{
  "user_id": "ou_xxxxxx",
  "msg_type": "text",
  "content": {
    "text": "openClaw 飞书对接测试成功！"
  }
}'

若飞书账号收到该消息，说明对接成功。

四、接入企业微信

4.1 企业微信应用创建与配置

步骤1：进入企业微信管理后台

打开企业微信管理后台：https://work.weixin.qq.com/wework_admin/，登录企业管理员账号，进入 “应用管理” → “创建应用”。

步骤2：填写应用信息

• 应用名称：openClaw 对接（自定义）
• 应用类型：自建应用
• 可见范围：按需选择（如全公司）
  填写完成后点击 “创建应用”。

步骤3：获取应用密钥

进入应用详情页，复制：

• CorpID（企业ID，在 “我的企业” → “企业信息” 中）
• AgentID（应用ID）
• Secret（应用密钥，点击 “查看” 获取）

4.2 openClaw 配置企业微信对接

编辑 config.yaml，添加企业微信配置：

# 企业微信配置
wework:
  corp_id: 你的企业微信CorpID
  agent_id: 你的应用AgentID
  secret: 你的应用Secret
  callback_url: http://服务器IP:8080/api/wework/callback

保存后重启 openClaw（同飞书重启步骤）。

4.3 测试企业微信对接

调用测试接口（替换为实际企业微信用户ID）：

curl -X POST http://服务器IP:8080/api/wework/send_msg \
-H "Content-Type: application/json" \
-d '{
  "userid": "zhangsan",
  "msgtype": "text",
  "text": {
    "content": "openClaw 企业微信对接测试成功！"
  }
}'

若企业微信账号收到该消息，说明对接成功。

五、常见问题排查

1. 启动失败：端口被占用
   解决方案：修改 config.yaml 中的 port 字段（如改为 8081），或关闭占用端口的进程：

   lsof -i:8080  # 查看占用进程
   kill -9 进程ID
   

2. 对接飞书/企业微信无消息
   排查点：① 服务器防火墙/安全组开放 8080 端口；② App ID/Secret 配置正确；③ 应用可见范围包含测试用户。
3. 依赖安装失败
   解决方案：更换 pip 源（如清华源），或升级 pip：

   pip3 install --upgrade pip
   

总结

1. openClaw 部署核心步骤：环境准备（Python+Git）→ 拉取源码 → 安装依赖 → 配置启动，验证 8080 端口可访问即部署成功。
2. 飞书/企业微信接入关键：在对应开放平台创建自建应用，获取 App ID/Secret 等凭证，配置到 openClaw 的 config.yaml 并重启服务，调用测试接口验证消息推送。
3. 零基础部署需重点关注：端口开放、凭证配置正确、依赖安装无报错，遇到问题优先检查日志（openclaw.log）和网络连通性。

结尾

openClaw 作为轻量级自动化工具，对接飞书/企业微信后可快速落地各类办公自动化场景。如果本文对你有帮助，欢迎点赞、收藏、评论；若有部署问题，可在评论区留言，我会第一时间解答。