搭建环境：Ubuntu 24 （Linux环境），使用 Ubuntu 服务器（推荐 20.04+）+具有 sudo 权限的用户+服务器防火墙开放所需端口
CPU：最低 2 核，推荐 4 核及以上，内存：最低 2GB，推荐 4GB 及以上，磁盘：至少 10GB 可用空间，网络：能正常访问国内镜像源
可使用宝塔Linux面板预装部署必要软件：Node.js 版本 22 或更高，可选 Nginx 1.24.0 设置反向代理
教程供参考
安装或更新Node.js
安装了宝塔面板的Node.js版本管理器，可快速安装和切换Node版本v22+ 也可以使用官网提供的包安装管理器
apt update #更新安装列表 apt list -a nodejs #查看当前可安装的nodejs版本 curl -sL https://deb.nodesource.com/setup_22.x | bash - #找到最新的LTS版本 apt list -a nodejs #可找到最新版本 apt install nodejs #执行安装 #验证安装完成和版本号 node -v npm -v #国内用户执行这行命令，切换 npm 国内镜像源，解决下载超时、安装失败的问题 npm config set registry HTTPS://registry.npmmirror.com
安装 OpenClaw 最新版中文版
使用全局安装 openclaw-cn为中文版，下面以中文版执行安装
# 全局安装最新版 # npm install -g openclaw@latest # 使用中文版 npm install -g openclaw-cn@latest # 安装验证 输出版本号为安装成功 openclaw-cn -v
快速配置 OpenClaw
初始化配置
# 初始化配置向导命令 安装守护进程 openclaw-cn onboard --install-daemon # 后续可启动控制面板命令 # openclaw-cn dashboard
安全风险确认
提示安全风险警告， 按左右方向键切换到 Yes 继续执行，进行回车确认，若选择 No，则无法完成后面的配置，需要重新执行上一步。
配置模式
最好选择快速开始模式，配置默认选择项，因手动模式配置易出错，可后续进行配置。
AI主流模型选择
如果已经备有某模型提供商 API Key ，优先选择该提供商的 AI 大模型进行配置，选对应的具体模型版本，并设置API Key。如果没有 API Key，就选择暂不配置即可，可后续进行配置。
接入平台和技能
OpenClaw支持接入微信、QQ、飞书、钉钉、Telegram等聊天平台，可先选择暂不配置，可后续进行对接。技能配置项可先选择 No，后续根据需求安装技能。
选择启动方式
Hatch in TUI：在终端里使用，Open the Web UI：打开网页控制面板，Do this later：稍后配置
最好选择 Open the Web UI，回车确认。后续可启动控制面板命令。
配置完成
终端给出一个链接，格式是 127.0.0.1:18789/?token=xxxxxx，把这个链接复制到服务器浏览器里打开，就能看到 OpenClaw 的控制面板。
注意：链接中的 token 值 是登录凭证，后续访问控制面板都需要这个 token，需要保存下来。
打开面板后你可能会出现下面这些问题，需要注意。
修改配置
初始化的时候跳过了一些配置比如模型配置，现在可以通过修改配置文件，解决下面一些问题。
# 修改 openclaw 配置文件 nano ~/.openclaw/openclaw.json
通过快捷键 ctrl+X + yes 完成退出nano编辑器和保存操作
网关配置
"gateway": {
"port": 18789,
"mode": "local",
"bind": "lan",
...
}
bind默认值是loopback，若设置为lan，可通过ip:18789访问。
端口号占用的问题
# 停止服务 openclaw-cn gateway stop # 查看端口占用情况 找到占用pid ss -tlnp | grep 18789 # 如有占用杀掉进程 kill -9 pid # 确认没有进程占用 18789 ss -tlnp | grep 18789 # 启动服务 openclaw-cn gateway start
disconnected (1006): no reason
设置了反向代理，通过ip:18789/?token=xxxxxx或域名/?token=xxxxxx访问到服务时面板出现的错误。
修复 Nginx 配置文件：
server {
location / {
proxy_pass http://127.0.0.1:18789;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# Origin 头修正
proxy_set_header Origin "http://127.0.0.1:18789";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# 关闭缓冲
proxy_buffering off;
# 超时设置
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
}
}
未通过设备配对：
# 查看待配对设备 pending状态执行下面命令 openclaw-cn devices list # 批准所有待审批请求 openclaw-cn devices approve --all
disconnected (1008): unauthorized: gateway token mismatch
如果通过浏览器的旧标签页或直接访问 http://127.0.0.1:18789/ 打开的面板，那么浏览器不会携带当前有效的 Token
# 输出URL，手动复制到浏览器 openclaw-cn dashboard --no-open
对齐配置文件中的 Token
# 修改配置文件 nano ~/.openclaw/openclaw.json
{
"gateway": {
"auth": {
"token": "token-xxxxxx"
},
"remote": {
"url": "ws://localhost:18789",
"token": "token-xxxxxx" // 与上面一致
}
}
}
模型接入配置
# 修改配置文件 nano ~/.openclaw/openclaw.json
在文件中找到 models ，可以根据示例的配置，替换掉里面的 API Key 即可
// 示例配置
{「agents」: {「defaults」: {「model」: {「primary」: 「moonshot/kimi-k2.5」},「maxConcurrent」: 4,「workspace」: 「/root/.openclaw/workspace」}},「models」: {「mode」: 「merge」,「providers」: {「moonshot」: {「baseUrl」: 「HTTPS://api.moonshot.cn/v1」,「apiKey」: 「这里替换成 Moonshot API Key」,「api」: 「openai-completions」,「models」: [{「id」: 「kimi-k2.5」,「name」: 「Kimi K2.5」},{「id」: 「moonshot-v1-auto」,「name」: 「Kimi 自动适配」}]},「qwen」: {「baseUrl」: 「HTTPS://dashscope.aliyuncs.com/compatible-mode/v1」,「apiKey」: 「这里替换成通义千问 API Key」,「api」: 「openai-completions」,「models」: [{「id」: 「qwen-max」,「name」: 「通义千问 Max」},{「id」: 「qwen-plus」,「name」: 「通义千问 Plus」}]}}}}
# 保存后重启配置 openclaw-cn gateway restart # 重启后打开控制面板，在对话界面选择你配置的模型，在面板可接入聊天平台 openclaw-cn dashboard # 接入飞书 openclaw-cn plugin install @openclaw/channel-feishu # 通道配置 openclaw-cn configure
本页作者：czhdawn，如若转载，请注明出处：https://www.czhdawn.cn/archives/5018
