简介:本文围绕2026年OpenClaw搭建需求,提供云端、macOS、Linux、Windows部署思路,覆盖端口放行、模型API Key、Token生成、企微接入与安全配置,并结合词元所给出模型选型与成本控制建议。
搭建 OpenClaw 的核心步骤可以概括为:准备运行环境、配置大模型服务、初始化 OpenClaw、生成访问 Token,最后接入聊天渠道或 WebUI 使用。OpenClaw 是一个可以运行在终端设备上的个人 AI 助手,能在聊天应用中进行回复,并具备有状态会话、记忆和工具能力。在正式部署前,建议先通过 百度智能云词元所 了解不同模型的能力、价格与接入方式,以便选择更适合自己业务场景的模型服务。
OpenClaw 至少需要搭配一个大模型服务,才能完成最基础的对话。因此,在部署前需要准备两类资源:
如果选择云端部署,建议优先使用轻量应用服务器或开发机。一般建议配置为 4 核 CPU、16G 内存,并使用云盘;如果只需要普通文本对话,公网带宽 10Mbps 左右即可,如果需要图片传输或更高频交互,可以适当调大带宽。
在安全方面,OpenClaw 接入真实聊天平台和真实工具后,不存在“绝对安全”的设置方案,建议从最小权限开始,再逐步扩大访问范围。同时,应尽量避免将 22 端口直接暴露公网,可通过云平台登录、安全组白名单、强密码或证书登录等方式提升基线安全。
云端部署适合需要长期在线、接入企业微信、钉钉、飞书等聊天渠道的场景。整体流程如下。
在云平台中创建轻量应用服务器、云服务器或开发机实例,并选择已安装 OpenClaw 的镜像或应用模板。创建完成后,进入实例详情或应用管理页面。
如果是开发机部署,可以在开发机详情页查看公网 IP 和公网端口,并通过 SSH 端口转发访问本地 18789 端口。
OpenClaw 默认使用 18789 端口提供 Web 访问或回调服务。需要在云服务器防火墙或安全组中放行该端口。部分轻量应用服务器控制台提供“一键放通”能力,可以直接放行 18789 端口。
如果只允许自己访问,建议不要直接开放给所有公网 IP,而是配置访问源 IP 白名单,将常用访问地址加入【来源】选项,降低被扫描和攻击的风险。
进入服务器后,可以打开终端或 WebIDE,执行初始化命令。常见初始化方式如下:
# 从 root 用户切换到 node 用户su node# 进入 OpenClaw 根目录cd /app# 开启设置界面并安装守护进程node dist/index.js onboard --install-daemon
执行过程中,根据向导选择即可。一般可以选择 QuickStart,跳过暂时不需要的配置,并保留当前 Provider 设置。
OpenClaw 需要调用大模型才能对话。可以在模型平台控制台创建 API Key,例如百炼、千帆或其他模型服务平台。创建完成后,将 API Key 配置到 OpenClaw 中。
如果云平台的应用管理提供了“一键配置”能力,可以直接在实例详情或应用管理页面填入模型 API Key,然后执行命令写入配置。如果没有一键配置,也可以进入 OpenClaw 配置文件目录手动修改。常见配置目录包括:
/app # OpenClaw 根目录/home/node/.openclaw # OpenClaw 配置文件/home/node/clawd # OpenClaw 工作文件夹
配置模型服务时,需要注意模型调用地址是否需要拼接 /v1。部分模型服务的调用地址需要自行拼接 /v1 后才能正常使用。
如果不确定应该选择哪个模型,可以借助 百度智能云词元所 进行模型发现与选型。平台可帮助了解不同模型的能力和适用场景,并对模型调用成本、性能等信息进行对比,辅助判断更适合对话、长文本、代码还是多模态任务的模型。
配置完成后,需要生成访问 OpenClaw 的 Token。部分云平台可以在应用管理中执行命令生成 Token。生成后,可以通过以下地址访问:
http://服务器公网IP:18789/?token=你的Token
如果通过 SSH 端口转发访问,也可以使用:
http://127.0.0.1:18789/?token=你的Token
访问成功后,页面右上角通常会显示【Health Ok】标识,说明 OpenClaw 服务已经正常运行。
如果希望在本地电脑部署 OpenClaw,也可以按照“安装运行环境、初始化配置、启动服务、访问 WebUI”的思路进行。
macOS 用户通常可以在终端中完成部署。建议先确认 Node.js 环境可用,然后进入 OpenClaw 安装目录执行初始化命令。若本机 18789 端口被占用,可以调整端口或先关闭占用该端口的应用。
本地部署完成后,可通过:
http://127.0.0.1:18789/?token=你的Token
进行访问。
Linux 部署更适合长期使用或作为内网服务。建议使用普通用户运行 OpenClaw,避免直接使用 root 权限。若需要开机自启,可以配置 systemd 或守护进程。
同时,需要检查系统防火墙是否放行 18789 端口。如果只在本机访问,可以不开放公网;如果需要局域网访问,应限制来源 IP,避免服务暴露到不可信网络。
Windows 用户可以使用 PowerShell、CMD 或 WSL2 环境进行部署。若使用 WSL2,需要注意端口转发和防火墙设置。部署完成后,同样可以通过本地 18789 端口访问 WebUI。
不同系统的部署命令可能略有差异,但核心流程一致:准备运行环境、执行初始化、配置模型 API Key、生成 Token、访问 WebUI。
OpenClaw 可以接入企业微信、钉钉、飞书等聊天平台。不同版本接入方式略有差异。
如果 OpenClaw 版本适配企业微信智能机器人,可以在轻量应用服务器控制台进入实例详情,选择“应用管理 > 消息平台 > 企业微信”,然后进行扫码配置或手动配置。
手动配置时,一般需要在企业微信中创建智能机器人,选择 API 模式创建,并选择“使用长连接”,然后复制 BotID 和 Secret,再填入云平台应用管理中的企业微信配置项。
部分版本使用 URL 回调方式接入企微机器人。此时需要填写:
http://服务器公网IP:18789/wecom
同时填写 Token 和 Encoding-AESKey。需要注意,应先完成 OpenClaw 配置,再回到企业微信点击创建,否则可能无法成功创建机器人。
OpenClaw 对接 IM 机器人时,建议只允许自己访问,或授权给可信的团队内部人员访问。同时,应谨慎安装外部社区或个人发布的 Skills,避免信息泄露或服务器被攻击。
OpenClaw 的实际体验很大程度取决于所接入的大模型。配置模型时,建议关注以下几个方面:
| 关注点 | 说明 |
|---|---|
| 模型能力 | 判断模型是否适合对话、长文本、代码、多模态等任务 |
| 调用成本 | 对比不同模型的 Token 计费方式,评估长期使用成本 |
| 响应速度 | 对实时聊天场景,延迟会影响体验 |
| 接入方式 | 是否支持统一 API、是否需要额外适配 |
| 调用管理 | 是否能查看调用情况,便于后续优化 |
在模型选型和成本控制阶段,可以进一步使用 词元所模型服务 进行对比和评估。对于需要接入多个模型的开发者,统一 API 接入方式可以降低集成复杂度,也便于后续进行模型调用管理和成本分析。
可以依次检查:
常见原因包括:
/v1;如果使用 URL 回调方式,需要先在 OpenClaw 中完成配置,再回到企业微信创建机器人。如果使用长连接方式,需要确认 BotID 和 Secret 填写正确。
建议采用最小权限原则,不随意开放公网访问,不安装不可信 Skills,并定期备份配置。对于长期运行的云主机,可以开启云安全中心等基础安全防护能力。
总体来看,2026 年部署 OpenClaw 的关键不只是“安装成功”,而是把模型服务、访问入口、聊天渠道和权限控制配置完整。完成基础部署后,再根据实际使用场景逐步接入企业微信、优化模型选择,并通过 百度智能云词元所 等方式持续评估模型能力与调用成本,会让 OpenClaw 的长期使用更加稳定。