开始之前，请先明确一点：这份安装指南基于 OpenClaw 官方文档（docs.openclaw.ai/start/getti…）及社区教程整理而成，但部分命令已更新——例如旧版文章中的 clawdbot status 现已改为 openclaw status，下文将一一标注清楚。

在环境准备阶段，您需要先安装 Node.js 22，推荐使用 nvm 进行版本管理。Windows 用户可直接通过下方命令自动完成 Node 22 和 Git 的安装，Linux 用户则需要手动配置这些依赖项。

Windows 安装命令：

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

Linux / macOS 安装命令：

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

安装完成后，运行引导程序并安装服务：

openclaw onboard --install-daemon

整个安装流程可参考官方相关文章，但请注意其中部分命令仍沿用旧版本写法——例如 clawdbot status 应替换为 openclaw status，类似差异将在下文逐一指出。

引导过程中，选择 quickstart 并选用 qwen 模型，其他选项可跳过。最后一步选择 TUI，完成后 OpenClaw 将在后台自动运行（类似于 nohup 的效果）。

常用命令一览

# 查看状态
openclaw status

# 启动网关
openclaw gateway

# 重启网关（修改 openclaw.json 后执行）
openclaw gateway restart

# 查看仪表盘网址
openclaw dashboard

# 检查并修复问题
openclaw doctor --fix

# 重新运行引导配置
openclaw onboard

Windows 用户直接在 PowerShell 中执行上述命令。完成后输入 openclaw dashboard 查看网址，复制 Dashboard URL 即可访问。如果直接访问 127.0.0.1:18789 且缺少 token，将会出现 disconnected (1008): device identity required 错误。

Linux 外网访问配置

Linux 本机部署后默认仅限内网访问。若需通过外网访问仪表盘，需要进行端口映射，操作分三步：

1. 修改 openclaw.json 配置文件

在配置文件中添加 controlUi 节点，并将 gateway 下的 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

2. 开放服务器端口（以腾讯云为例，需同时配置安全组和防火墙）

使用 ufw 开放 18789 端口（TCP）：

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

3. 访问外网

访问 服务器IP:18789/?token=XXXX，token 通过 openclaw dashboard 获取。

完整的 openclaw.json 配置参考

ubuntu@VM-0-7-ubuntu:~$ cat ~/.openclaw/openclaw.json
{
  "meta": {
    "lastTouchedVersion": "2026.2.1",
    "lastTouchedAt": "2026-02-04T01:38:02.479Z"
  },
  "wizard": {
    "lastRunAt": "2026-02-04T01:38:02.475Z",
    "lastRunVersion": "2026.2.1",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "controlUi": {
      "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "你的token"
    },
    "mode": "local",
    "port": 18789,
    "bind": "lan",
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "agents": {
    "defaults": {
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "workspace": "/home/ubuntu/.openclaw/workspace",
      "models": {
        "qwen-portal/coder-model": {
          "alias": "qwen"
        },
        "qwen-portal/vision-model": {}
      },
      "model": {
        "primary": "qwen-portal/vision-model"
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "plugins": {
    "entries": {
      "qwen-portal-auth": {
        "enabled": true
      }
    }
  },
  "models": {
    "providers": {
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "qwen-oauth",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "auth": {
    "profiles": {
      "qwen-portal:default": {
        "provider": "qwen-portal",
        "mode": "oauth"
      }
    }
  }
}
ubuntu@VM-0-7-ubuntu:~$ 

飞书机器人配置

在飞书中配置机器人可参考相关文档，但请注意：旧版文章中的命令使用的是 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

这里有一个细节需要注意：如果仅为个人使用，用飞书个人版创建机器人即可，无需企业版。但若计划将机器人分享给他人使用，则必须在飞书中创建一个企业，并在该企业下创建机器人——个人版创建的机器人无法分享给其他用户，这一点务必牢记。