OpenClaw 安装教程（windows+Linux）
OpenClaw快速部署与飞书集成指南
想把一个开箱即用的AI助手部署到自己的服务器，并通过飞书随时随地调用吗？OpenClaw提供了一个相当顺滑的解决方案。下面这份从零开始的部署与配置手册，能帮你快速打通整个流程。
环境准备与基础安装
一切始于官方文档，建议动工前先浏览一遍：https://docs.openclaw.ai/start/getting-started。
首先需要搞定运行环境。核心前提是安装Node.js 22。这里推荐使用nvm进行版本管理，一步到位。针对不同操作系统，安装命令有所区别：
对于Windows系统，下面这条PowerShell命令会帮你自动完成Node 22的安装：
iwr -useb https://openclaw.ai/install.ps1 | iex而对于Linux或Mac用户，则需要执行这条命令，请注意，Linux系统可能需要你手动安装git：
curl -fsSL https://openclaw.ai/install.sh | bash基础环境就绪后，就可以启动OpenClaw的引导配置程序了。执行以下命令，它会引导你完成初始设置并安装后台服务：
openclaw onboard --install-daemon如果安装过程中想参考更详细的图文步骤，阿里云上的这篇文章是个不错的选择。不过要注意，文中部分命令属于旧版本，例如检查状态的clawdbot status，在新版中应使用openclaw status。
引导配置时，模型选择“quickstart qwen”即可，其他步骤可以酌情跳过。最后一步交互界面推荐选择“TUI”，配置完成后，OpenClaw会自动在后台运行，类似于nohup的效果。
核心操作与本地访问
掌握几个常用命令，管理起来就轻松多了：
查看状态：openclaw status
启动网关：openclaw gateway
重启网关（修改配置后必需）：openclaw gateway restart
查看仪表盘访问地址：openclaw dashboard
系统检查和修复：openclaw doctor --fix
重新运行引导配置：openclaw onboard在Windows上，通过PowerShell执行上述命令即可。安装配置完成后，运行openclaw dashboard，你会看到Dashboard的访问URL。复制这个链接就能在浏览器中打开管理界面。如果直接访问不带token的地址（如127.0.0.1:18789），通常会遇到“disconnected (1008): device identity required”的错误提示。
实现外网访问配置
默认情况下，Linux服务器上的部署只在内网环境生效。要想从外网访问，需要进行端口映射和配置调整。
关键步骤是修改~/.openclaw/openclaw.json配置文件。主要做两处调整：
- 在
gateway部分添加controlUi配置项以允许非安全认证（测试环境适用）。 - 将
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完成以上步骤后，就可以通过外网访问了。访问格式为：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这里有个重要提醒：如果只是个人使用，在飞书个人版中创建机器人应用即可。但如果你打算将机器人分享给同事或朋友一起使用，则必须在飞书上创建一个“企业”（哪怕只有你自己），然后在该企业下创建机器人。因为飞书个人版创建的机器人，无法被其他用户添加和使用。