OpenClaw 新手入门指南：一文看懂环境搭建、模型配置与 WebUI 远程访问

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 
  
    
     这是一篇为你准备的 OpenClaw 新手入门指南，专注于环境搭建、模型配置与 WebUI 远程访问的核心操作。

在开始敲代码之前，先明确 OpenClaw 的定位。OpenClaw（原名 Clawdbot/Moltbot）是一个开源的 AI 智能体（Agent）平台。与单纯的聊天机器人不同，它的核心能力在于让 AI “动手”——它可以读写文件、执行终端命令、操作浏览器，甚至通过配置接入飞书、钉钉等办公软件。

做个形象的比喻：如果大模型是“大脑”，OpenClaw 就是给这个大脑接上了“手脚”和“连接外部世界的神经”。它的定位是全天候数字员工，而不仅仅是陪聊工具。

OpenClaw 支持多种部署环境，入门阶段推荐以下三种。根据你的硬件条件和需求对号入座即可。

1. 本地快速体验（适用于 Mac/Linux/Windows）

这是最直接的部署方法，无需额外的服务器，在你的个人电脑上就能跑。

硬件要求：CPU 2核及以上，内存 4GB 以上，硬盘空余 20GB 以上。
软件依赖：需提前安装 Node.js 22+ 和 Git。Windows 用户建议使用 WSL2 或开启开发者模式以防兼容性问题。
一键安装：
打开终端，执行官方脚本即可进入引导界面：
```
curl -fsSL https://openclaw.ai/install.sh | bash 
```
脚本会自动处理依赖，下载完成后运行 openclaw onboard 开始初始化。

2. 云端服务器部署（推荐 7x24 小时在线）

本地电脑关机后 AI 就无法工作了，想让 OpenClaw 成为真正的“全天候员工”，租一台云服务器是更佳选择。国内华为云、阿里云等均提供了预装 OpenClaw 的镜像，甚至可以一键部署。

配置选购建议：起步可选 2核4GB 的轻量应用服务器。
安全组设置：务必在云防火墙放行 18789 端口（这是 OpenClaw WebUI 的默认端口），否则浏览器无法打开控制台。

3. Docker 容器部署

适合熟悉 Docker 的开发者，通过 docker run 拉取官方镜像即可。这种方式环境隔离最干净，迁移也方便。

OpenClaw 本身不包含大模型，需要接入第三方模型 API。它支持的模型厂商非常广泛，包括 OpenAI、Anthropic Claude、Google Gemini，以及国内的 DeepSeek、月之暗面、通义千问等。

1. 接入云端 API（以月之暗面 Kimi 为例）

大部分新手会选择这种方式，无需昂贵显卡，按量付费或使用免费额度。

获取 Key：在模型厂商控制台（如月之暗面）创建 API Key。
配置方法：
如果是全新安装，运行 openclaw onboard 后会进入交互式引导，选择对应模型提供商（如 Moonshot/Kimi）并输入 API Key 即可。
如果是已安装环境，可以通过命令行指定：
```
openclaw onboard --auth-choice moonshot-api-key 
```
进入容器后输入 Key，随后在 WebUI 的 Agent 设置里选择对应的 Kimi 模型就行。

2. 接入本地模型（Ollama，零成本方案）

如果你有高性能显卡且注重隐私，可以通过 Ollama 运行本地模型。

服务端部署：在局域网内的机器上安装 Ollama，下载模型（如 qwen3.5:9b）。
关键配置：必须将 Ollama 的监听地址从 127.0.0.1 改为 0.0.0.0 才能让 OpenClaw 调用。
对接 OpenClaw：修改 ~/.openclaw/openclaw.json 文件，在 models 字段添加本地 Ollama 的地址：
```
"ollama-remote": { "baseUrl": "http://你的局域网IP:11434/v1", "apiKey": "sk-no-key-required", "api": "openai-completions", "models": [{ "id": "qwen3.5:9b", ... }] } 
```
然后在 Agent 设置中将主力模型切换为刚配置的本地模型名即可。

重启 Gateway 服务后，最关键的步骤来了——如何从你自己的电脑浏览器访问服务器上的 OpenClaw 控制台。

方案 A：SSH 隧道转发（安全推荐）

这是最安全的访问方式。不需要把远程端口直接暴露在公网上，只需利用 SSH 加密通道。

远程获取访问链接：先 SSH 登录服务器，运行：
```
openclaw dashboard 
```
记下输出的链接，类似 http://127.0.0.1:18789/#token=xxxxx。
建立本地隧道：在本地电脑的新终端窗口中执行（以 Linux/Mac 为例）：
```
ssh -N -L 18789:127.0.0.1:18789 root@你的服务器公网IP 
```
命令执行后，保持终端窗口不要关闭。
本地打开：在你自己电脑的浏览器地址栏输入 http://127.0.0.1:18789/#token=xxxxx 即可访问。

方案 B：云服务商自带的 Session Manager（无公网 IP 方案）

如果你用的是阿里云 ECS，且服务器没有公网 IP，可直接使用阿里云 CLI 的端口转发功能，无需暴露任何端口。
在本地运行：

./ali-instance-cli portforward --instance <实例ID> --local-port 18789 --remote-port 18789

然后访问 http://localhost:18789/ 即可。

方案 C：直接公网访问（仅限调试）

直接在浏览器访问 http://公网IP:18789。重要提醒：生产环境千万不能这样裸奔！务必配合 Token 鉴权，或者在云防火墙里仅放行你自己的家庭 IP。

完成以上四步，你已拥有一个功能完备的本地 AI 智能体了。在 WebUI 里发条消息试试看，比如让它帮你查天气或整理文件。

当你熟练使用基础功能后，OpenClaw 真正的趣味在于 Skills 系统。它是 AI 的“技能插件”，能赋予 AI 联网搜索、操控浏览器、生成图表等能力。只需通过 npx skills add 命令就能从社区安装各种强大技能。

避坑提示：Skill 虽好用，但需注意第三方 Skill 可能存在安全风险。安装前最好审查其源码，避免使用来路不明的社区技能。