OpenClaw 安装与配置指南：本地部署、隧道访问及百炼模型接入

OpenClaw 简介

OpenClaw（前身为 Clawdbot/Moltbot）是一款支持本地部署的开源 AI 个人助手。它兼容 MacOS、Windows 及 Linux 系统，能够接入常用聊天工具，让用户通过自然语言控制设备和服务。作为自动化工具，它支持 Qwen、Claude、GPT 等主流大模型，可处理邮件、日程安排及市场调研等任务。

典型应用场景

• 24 小时在线的 AI 助手服务
• 自动化处理日常任务（邮件、日程、提醒等）
• 连接各种 API 和服务，实现自定义自动化流程
• 作为个人知识库，随时回答你的问题

安装与前置准备

建议先确认 Node.js 版本，OpenClaw 要求 Node >= 22。如果不是 22+，请先升级 Node（使用 nvm / fnm / brew 均可）。

node -v

一键安装

根据官方指引，不同系统推荐不同的安装方式。

MacOS/Linux 用户 推荐使用官方一键安装脚本：

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

Windows (PowerShell) 用户

iwr -useb https://openclaw.ai/install.ps1 | iex

或者通过全局安装：

npm install -g openclaw@latest
# 或
pnpm add -g openclaw@latest

运行配置向导

向导将设置网关、认证和聊天平台。

openclaw onboard --install-daemon

脚本跑完后，会看到 onboarding 指引，说明安装成功。

启动网关与隧道配置

如果在向导中安装了服务，网关应该已经运行。检查状态如下：

openclaw gateway status

如需手动运行（前台模式）：

openclaw gateway --port 18789 --verbose

官方推荐访问地址为 http://127.0.0.1:18789/。由于本地无法直接外网访问，需要建立隧道。这里以阿里云 ECS 为例讲解。

注意： 以下命令需在本地电脑执行，而非服务器端。

1. 建立隧道命令

   ssh -L 18789:127.0.0.1:18789 -L 18800:127.0.0.1:18800 root@<ECS 公网 IP 地址>
   

   例如：ssh -L 18789:127.0.0.1:18789 -L 18800:127.0.0.1:18800 [email protected]

2. 登录验证 输入 ECS 服务器密码完成 SSH 登录。

3. 访问网关 登录成功后，访问 http://127.0.0.1:18789/?token=<您的 GATEWAY_TOKEN> 即可正常通过隧道登录。

配置大模型（阿里云百炼）

OpenClaw 支持通过 models.providers 添加自定义模型提供商。阿里云百炼 API 调用支持 OpenAI-compatible 接口。

准备工作

• 登录阿里云百炼大模型服务平台。
• 获取 API Key（密钥管理页面创建）。
• 确定模型调用地址 base_url：https://dashscope.aliyuncs.com/compatible-mode/v1
• 确定模型名称 model code：如 qwen-plus, qwen3-max 等。

若使用的是百炼 Coding Plan，需替换 API Key 和调用地址：

• base_url：https://coding.dashscope.aliyuncs.com/v1
• model code：如 qwen3-max-2026-01-23 等

配置环境变量

建议将 API Key 配置到环境变量，避免硬编码泄露风险。

1. 查看默认 Shell 类型。
2. 将环境变量追加到 ~/.bash_profile：

   echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile
   

3. 使变更生效：

   source ~/.bash_profile
   

修改配置文件

OpenClaw 配置严格校验，字段错误可能导致 Gateway 无法启动。如有报错，可运行 openclaw doctor 排查。 模型引用格式为 provider/model。可选择 Web UI 或手动编辑 ~/.openclaw/openclaw.json。

Web UI 方式

openclaw dashboard

浏览器打开 http://127.0.0.1:18789/ 进行配置。（此处显示 OpenClaw Dashboard 界面）

手动编辑示例 以阿里云百炼 qwen3-max 模型为例，可直接复制以下配置：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3-max-2026-01-23"
      }
    },
    "models": {
      "bailian/qwen3-max-2026-01-23": {
        "alias": "通义千问 Max Thinking 版"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-max-2026-01-23",
            "name": "通义千问 Max Thinking 版",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0.0025,
              "output": 0.01,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 262144,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

验证模型状态

配置完成后，重启服务使配置生效：

openclaw gateway restart

或通过以下指令检查模型是否被识别：

openclaw models list

若要测试真实连通性（可能产生费用），可运行：

openclaw models status --probe

最后，可通过 CLI 发起对话验证：

openclaw agent --agent main --message "介绍下阿里云百炼"