乐于分享
好东西不私藏

Ubuntu部署OpenClaw并对外提供访问全指南

Ubuntu部署OpenClaw并对外提供访问全指南

OpenClaw简介

如果2025年底有一款开源AI智能体,能用短短四个月时间在GitHub上狂揽超25万星标,超越React和Linux成为全球增速最快的开源项目——你会不会也想一探究竟?这款被网友亲切称为“龙虾”的产品,就是OpenClaw

与以往那些“能说会道”却“不会动手”的对话式AI不同,OpenClaw是一个真正“能干会做”的主动执行助手。你只需用自然语言下达指令,它就能直接操作你的电脑——读写文件、浏览网页、管理邮件、发送消息。它支持WhatsApp、飞书、微信等20多种渠道接入,运行在你的本地设备上,所有数据不出服务器。每一次互动都被记录为长期记忆,久而久之,它便成长为一个真正“懂”你的专属AI伙伴。OpenClaw的到来,标志着AI正从“对话者”蜕变为“执行者”——一个属于AI Agent的新时代,已然开启。

安装OpenClaw

Ubuntu环境下安装OpenClaw非常便捷,官方提供了一键安装脚本,只需在终端执行curl -fsSL https://openclaw.ai/install.sh | bash 即可自动完成环境配置与CLI安装,安装完成后,运行 openclaw onboard --install-daemon 启动交互式配置向导,即可完成大模型API接入、消息渠道设置等初始化工作。整个过程流畅高效,让你在Ubuntu上快速拥有一个强大的专属AI助手。

接下来将演示怎么在Ubuntu服务器上安装OpenClaw,然后通过win10计算机访问OpenClaw。

推荐:安装脚本

执行脚本安装是最快的安装方式。它会自动检测你的操作系统及依赖环境,自动安装依赖Node.js和Git,依赖环境具备了再进行OpenClaw的安装,并启动新手引导。在Ubuntu中执行下面命令:

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

安装完成后,进行OpenClaw的初始化设置,选择YES 、QuickStart进行设置。

在选择模型服务商时候,我选择Custom Provider(自定义服务商),因为我采用的是大模型服务平台硅基流动(SiliconCloud)

硅基流动(SiliconCloud)是硅基流动公司推出的一站式大模型云服务平台,致力于为开发者和企业提供高效、低成本且全面的生成式人工智能(GenAI)模型服务,包括 IaaS、PaaS和MaaS。其核心目标是通过优化大模型使用体验, 帮助用户实现 “Token 自由”,即以更低成本和更高效率使用先进的大语言模型(LLMs)及其他生成式 人工智能 (AI)模型。

硅基流动(SiliconCloud)统一登录入口:https://cloud.siliconflow.cn/i/caJN0Yzs。填写个人手机号,短信验证码,邀请码(caJN0Yzs),注册账号即可登录。

硅基流动(SiliconCloud) API

即日起至2026年12月31日,所有用户(含新注册与既有用户),在注册后首次完成有效实名认证,即可获得面值 ¥16 的「认证奖励券」 1 张。

📢 说明: 「认证奖励券」为一次性奖励,每位用户仅可领取 1 次。 无论是首次完成实名认证(个人或机构)的用户,还是已在活动前通过实名认证的用户,均可在活动期间手动领取。 若发生更换认证主体或重复认证,将不再重复发放。

在个人账号中创建API秘钥,用于OpenClaw调用SiliconCloud API时使用。API密钥是访问SiliconCloud接口的凭证,具有该账户的完整权限,请妥善保管。若API密钥泄漏,删除API秘钥,重新创建新的API秘钥即可。

填写模型服务商硅基流动(SiliconCloud)的API Base URL:https://api.siliconflow.cn

将硅基流动(SiliconCloud)个人账号中创建API秘钥(一段字符串)粘贴到此处。

下图里的选项,指的是 OpenClaw 程序该用什么样的“数据格式”去和你的大模型服务商(API 提供商)进行对话。 因为不同的大模型厂商(如 OpenAI、Anthropic 等)提供的 API 接口格式是不一样的(比如发过去的 JSON 数据结构不同,参数名称也不同)。OpenClaw 必须知道你用的是哪家的格式,才能正确地发送请求和读取回复。

具体含义如下:

1. OpenAI-compatible(OpenAI 兼容): 最常用的选项。如果你的模型服务商是 OpenAI(GPT-3.5/4)、DeepSeek、通义千问(Qwen)、智谱AI、Kimi 等,或者大部分国内厂商,它们通常都兼容 OpenAI 的 /v1/chat/completions 格式,选这个。

2. OpenAI Responses-compatible: 这是 OpenAI 最新推出的 Responses API 格式(目前属于较新的功能)。除非你明确在使用 OpenAI 的这个新 API,否则一般不需要选这个。

3. Anthropic-compatible: 这是给 Claude(Anthropic 公司)专用的格式。如果你调用的是 Claude 的官方 API,必须选这个,因为它的对话消息结构(如 messages 的 role 定义)和 OpenAI 完全不同。

4. Unknown (detect automatically)(未知/自动检测): 推荐新手选这个。如果你完全不确定你的服务商是哪一种格式,选这一项。OpenClaw 会按顺序依次尝试用 OpenAI、OpenAI Responses 和 Anthropic 的格式去测试接口,哪个通了就自动用哪个。

💡 总结建议:

  • 如果你的 API 是国内的大模型(如 DeepSeek、通义千问、智谱)或者OpenAI:直接选 OpenAI-compatible。
  • 如果你的 API 是 Claude:选 Anthropic-compatible。
  • 如果不确定:直接选 Unknown 让系统自己测。

Model ID(模型ID):deepseek-ai/DeepSeek-V4-Pro

Model alias(模型别名):DeepSeek-V4-Pro

至此Openclaw安装暂且告一段落,但是我是在Ubuntu服务器上部署OpenClaw,最终通过win10计算机跨网段网络访问OpenClaw,要实现此目的还得继续,执行命令openclaw configure --section gateway修改配置。

openclaw configure --section gateway

openclaw运行在Ubuntu服务器(本机),所以选择Local。

设置openclaw Gateway端口号

Gateway bind mode(网关绑定模式)选择 LAN (All interfaces),则可以通过Openclaw服务器任意IP地址对外提供访问,如果选择Custon IP则仅限制某一IP作为Openclaw服务器对外提供服务访问的IP,本处选择LANGateway access protection(网关访问保护)选择token认证,后续在Openclaw登录页面输入token即可访问;若选择Password,设置Password,后续在Openclaw登录页面输入Password即可访问,此处选择token方式。(在执行openclaw configure --section gateway命令前,需提前准备好token

查看Token

token 也存储在OpenClaw的本地配置文件中,可以直接查看。执行命令cat ~/.openclaw/openclaw.json

在文件中找到token字段,其对应的值就是所需的token。

使用 Token

拿到token后,主要有两种方式用于登录Web UI:

  • 直接通过 URL 访问:在浏览器地址栏输入 http://192.168.1.100:18789/?token=<你的token>。请注意,token 是作为18789 端口(Gateway API 端口)的查询参数传递的。
  • 在登录页面输入:访问http://192.168.1.100:18789,在登录界面的“Gateway Token”输入框中粘贴你的token。

Openclaw的安全校验

若直接HTTP内网访问,常见报错为:quires device identity (use HTTPS or localhost secure context)需要新增"allowInsecureAuth": true"dangerouslyDisableDeviceAuth": true两个字段,及Openclaw对外提供服务的IP。执行命令vim openclaw.json修改配置文件,然后执行命令openclaw gateway restart重启Openclaw。

"gateway": {
"mode""local",
"auth": {
"mode""token",
"token""a5bd208ec9c3cec4a90170721183d8f26c05bfb8fd25cd96"
    },
"port": 18789,
"bind""lan",
"tailscale": {
"mode""off",
"resetOnExit"false
    },
"controlUi": {
"allowInsecureAuth"true,   //新增字段
"dangerouslyDisableDeviceAuth"true,     //新增字段
"allowedOrigins": ["http://192.168.1.100"]   //Openclaw对外提供服务的IP
    },

通过win10计算机访问部署在Ubuntu服务器上的OpenClaw