开始之前，请先明确一点：这份安装指南基于 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 | iexLinux / 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 onboardWindows 用户直接在 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/tcp3. 访问外网
访问 服务器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这里有一个细节需要注意：如果仅为个人使用，用飞书个人版创建机器人即可，无需企业版。但若计划将机器人分享给他人使用，则必须在飞书中创建一个企业，并在该企业下创建机器人——个人版创建的机器人无法分享给其他用户，这一点务必牢记。
