OpenClaw 的安装、启动和联网配置

OpenClaw 的安装、启动和联网配置

先把环境准备好。这个项目要求 Node.js 22，Windows 我习惯用 nvm 管版本，Linux 则别省事，Git 也要装好，不然后面脚本和依赖经常会卡在奇怪的地方。

安装

Windows

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

Linux/macOS

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

安装完后，跑引导并把服务装起来：

openclaw onboard --install-daemon 

接下来选 Quickstart Qwen 模型，其他选项先跳过，最后一步选 TUI。这样服务会在后台跑起来，后面调试也方便。

常用命令

这些命令基本够日常用了：

• 查看状态：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.json，加上 controlUi，同时把 gateway 下面的 bind 从 loopback 改成 lan。

{
  "controlUi": {
    "allowInsecureAuth": true
  },
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "你的 token"
    },
    "bind": "lan",
    ...
  }
}

完整示例可以参考下面这份：

{
  "meta": { "lastTouchedVersion": "2026.2.1" },
  "gateway": {
    "controlUi": { "allowInsecureAuth": true },
    "auth": { "mode": "token", "token": "你的 token" },
    "mode": "local",
    "port": 18789,
    "bind": "lan",
    "tailscale": { "mode": "off", "resetOnExit": false }
  },
  "agents": { "defaults": { "maxConcurrent": 4, "workspace": "/home/ubuntu/.openclaw/workspace" } },
  "models": { "providers": { "qwen-portal": { "baseUrl": "https://portal.qwen.ai/v1" } } }
}

改完重启网关：

openclaw gateway restart

接着把服务器上的 18789 端口放出来。腾讯云或者别的云服务器都差不多，防火墙没开的话外部永远连不上。

sudo apt install ufw
sudo ufw allow 18789/tcp

最后用 服务器 IP:18789/?token=XXXX 访问。

飞书集成

飞书这块是先装插件，再写应用配置。命令比较多，但思路其实很简单：把应用信息、连接方式和权限策略配好，然后重启网关。

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
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

个人自己用，直接创建飞书个人版机器人就够了；如果要分享给好友，还是得走企业版这条路。这个限制挺实际，个人版本来就不适合多人共享。