OpenClaw 怎么安装？AI 智能助手软件完整安装与配置教程

OpenClaw 是什么软件？

OpenClaw 是一款开源 AI 智能助手平台，让你通过 飞书、企业微信、钉钉 等国内主流协作工具直接与 AI 进行对话。安装后无需打开浏览器，在日常使用的办公软件里即可调用豆包、通义千问、文心一言等大模型，适合个人效率管理和企业团队自动化场景。

安装 OpenClaw 之前需要准备什么？

• Node.js ≥ 22
• 一个国内 AI 模型的 API 密钥（豆包、通义千问、文心一言均支持）
• 飞书 / 企业微信 / 钉钉 账号之一

Windows 用户特别注意：建议先安装 WSL2（Linux 子系统）再运行 OpenClaw，原生 Windows 环境兼容性较差，容易报错。在 PowerShell 中运行以下命令即可一键安装 WSL2：

wsl --install

第一步：安装 OpenClaw 命令行工具

根据你的系统选择对应命令：

macOS / Linux / WSL2：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell（原生）：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后验证是否成功：

openclaw --version

第二步：运行配置向导（推荐新手使用）

OpenClaw 提供一键配置向导，自动完成所有设置：

openclaw onboard --install-daemon

向导会依次引导你完成 4 项配置：

1. 选择 AI 模型：输入豆包（Doubao）、通义千问（Qwen）或文心一言的 API 密钥
2. 选择沟通渠道：飞书机器人、企业微信或钉钉（按需选择）
3. 网关设置：本地运行或部署到云服务器（阿里云、腾讯云均支持）
4. 安装后台服务：开机自启，持续在后台运行无需手动启动

第三步：启动网关服务

配置完成后，启动 OpenClaw 的网关服务：

openclaw gateway status        # 查看运行状态
openclaw gateway --port 18789 --verbose   # 手动启动

打开浏览器访问 http://127.0.0.1:18789/，即可看到 OpenClaw 的可视化控制台，支持中文界面。

第四步：连接飞书或企业微信

飞书机器人：在飞书开放平台创建应用，获取 App ID 和 App Secret，在向导中填入即可完成绑定。绑定后在飞书群或私信中直接 @ 机器人即可与 AI 对话。

企业微信：在企业微信后台创建自建应用，获取 CorpID 和 Secret，通过向导配置完成接入。

首次使用需完成安全配对，运行以下命令审批：

openclaw pairing list feishu
openclaw pairing approve feishu <配对码>

如何验证安装是否成功？

openclaw status
openclaw health

全部显示 ✓ 即代表安装成功。如果提示"未配置认证"，回到第二步重新输入 API 密钥。

常见问题（FAQ）

Q：支持哪些国内 AI 大模型？
A：目前支持豆包（字节跳动）、通义千问（阿里云）、文心一言（百度）等主流国内模型，通过各平台官网申请 API 密钥后即可接入，无需翻墙。

Q：Windows 上安装失败怎么办？
A：建议切换到 WSL2 环境（Ubuntu 22.04），90% 的 Windows 报错在 WSL2 下会消失。

Q：部署在公司服务器上，同事都能用吗？
A：可以。将 OpenClaw 部署在内网服务器上，配置飞书或企业微信机器人后，全公司同事均可在聊天软件中直接使用，无需每人单独安装。

Q：数据安全有保障吗？
A：OpenClaw 本身不存储对话内容，数据直接在你的服务器与 AI 模型 API 之间传输。选择国内 AI 模型（如豆包、千问）可确保数据不出境，符合国内数据安全合规要求。