OpenClaw 安装教程（windows+Linux）

OpenClaw部署教程：从零搭建AI助手并接入飞书

你是否希望将一款功能强大的AI助手部署到自己的服务器，并集成到飞书应用中实现随时调用？OpenClaw提供了一个完整且高效的解决方案。本指南将从环境准备开始，一步步指导你完成服务器部署、外网访问配置与飞书机器人集成的全流程。

环境准备与基础安装步骤

部署前，建议先阅读官方文档以获得整体概念：https://docs.openclaw.ai/start/getting-started。

首先需要搭建基础运行环境。核心要求是安装Node.js 22版本。我们推荐使用nvm（Node Version Manager）进行版本管理，方便快捷。根据操作系统的不同，安装命令有所差异：

对于Windows用户，请在PowerShell中执行以下命令，系统将自动下载并安装Node.js 22：

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

而Linux或MacOS用户，请运行下面的命令。请注意，部分Linux发行版可能需要预先安装git工具：

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

基础环境配置完成后，即可启动OpenClaw的初始化引导程序。运行以下命令，它将指引你完成服务器初始设置并自动安装后台守护进程：

openclaw onboard --install-daemon

如需更直观的安装图解，阿里云社区上的这篇教程提供了详细参考。请注意，其中部分命令适用于旧版本，例如检查服务状态的命令已从clawdbot status更新为openclaw status。

在引导配置过程中，模型选择界面建议勾选“quickstart qwen”作为起点，其他非必需步骤可跳过。最后，交互界面类型推荐选择“TUI”（终端用户界面）。配置结束后，OpenClaw服务将自动在后台持续运行。

核心管理命令与本地访问方法

掌握OpenClaw的核心管理命令，有助于高效运维：

查看服务状态：openclaw status
启动API网关：openclaw gateway
重启网关服务（修改配置后必须执行）：openclaw gateway restart
查看管理面板访问地址：openclaw dashboard
运行系统诊断与自动修复：openclaw doctor --fix
重新运行初始化引导：openclaw onboard

在Windows系统上，通过PowerShell执行上述命令即可。安装成功后，运行openclaw dashboard命令会显示出Dashboard的访问链接。将此链接复制到浏览器即可打开管理控制台。若直接访问不带认证令牌的地址（例如127.0.0.1:18789），通常会遇到“disconnected (1008): device identity required”的身份验证错误。

配置服务器实现外网访问

默认部署仅支持本地内网访问。若要通过互联网远程访问你的AI助手，需要进行端口转发与配置调整。

关键操作是编辑~/.openclaw/openclaw.json配置文件。主要需修改两个部分：

1. 在gateway配置段内添加controlUi项，启用非安全认证模式（适用于测试环境）。
2. 将bind参数值由“loopback”（环回地址）改为“lan”（局域网），允许更广范围的网络绑定。

需要添加或修改的配置行如下：

"controlUi": {"allowInsecureAuth": true},
"bind": "lan",

修改后的完整gateway配置段示例如下：

"gateway": {
  "controlUi": {"allowInsecureAuth": true},
  "auth": {"mode": "token", "token": "你的token"},
  "mode": "local",
  "port": 18789,
  "bind": "lan",
  "tailscale": {"mode": "off", "resetOnExit": false}
},

配置文件保存后，必须重启网关服务以使新配置生效：openclaw gateway restart。

接下来是服务器网络安全配置。你需要登录云服务器（如腾讯云、阿里云）的控制台，在安全组规则中放行TCP协议18789端口。若服务器使用UFW防火墙，可通过以下命令行操作开放端口：

sudo apt install ufw
sudo ufw status
sudo ufw enable
sudo ufw allow 18789/tcp

完成以上所有步骤后，即可通过外网访问你的OpenClaw AI助手。访问地址格式为：http://你的服务器公网IP:18789/?token=XXXX。其中，认证令牌（token）可通过执行openclaw dashboard命令获取。

一份完整的openclaw.json配置文件结构参考如下：

ubuntu@VM-0-7-ubuntu:~$ cat ~/.openclaw/openclaw.json
{
  "meta": {...},
  "wizard": {...},
  "commands": {...},
  "gateway": {
    "controlUi": {"allowInsecureAuth": true},
    "auth": {"mode": "token", "token": "你的token"},
    "mode": "local",
    "port": 18789,
    "bind": "lan",
    "tailscale": {"mode": "off", "resetOnExit": false}
  },
  "agents": {...},
  "messages": {...},
  "plugins": {...},
  "models": {...},
  "auth": {...}
}
ubuntu@VM-0-7-ubuntu:~$

飞书机器人接入与配置指南

将OpenClaw接入飞书平台，即可在团队协作环境中直接与AI助手互动。配置流程可结合前述阿里云文章进行，但请确保将所有提到的clawdbot旧命令替换为新的openclaw命令。

详细的飞书机器人集成命令序列如下：

# 安装官方飞书插件
openclaw plugins install @m1heng-clawd/feishu
# 配置飞书开放平台获取的应用凭证
openclaw config set channels.feishu.appId "你的飞书应用 App ID"
openclaw config set channels.feishu.appSecret "你的飞书应用 App Secret"
openclaw config set channels.feishu.enabled true
# 推荐使用 websocket 连接模式，以获得更低的响应延迟
openclaw config set channels.feishu.connectionMode websocket
# 配置消息接收策略
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true
# 重启网关服务，加载飞书插件配置
openclaw gateway restart

重要提示：如果仅供个人使用，在飞书个人版中创建机器人应用即可。但如果你计划让同事或团队成员共同使用此AI助手，则必须在飞书平台上创建一个“企业”（即使成员只有你自己），并在该企业下创建机器人应用。因为飞书个人版创建的机器人应用不支持被其他用户添加和使用。