OpenClaw安装配置

1 参考链接

  1. OpenClaw官网
  2. [阿里云]OpenClaw（原 Clawdbot、Moltbot）
  3. 正式部署OpenClaw
  4. openclaw+qwen 配置

2 安装要求

  1. OpenClaw好像是不支持centos7安装，centos7安装需要升级程序和编译器。本次安装配置首先是在Centos10进行。
  2. Node 24（推荐）（出于兼容性考虑，仍支持 Node 22 LTS，目前为 22.16+；如果缺失，安装脚本 会安装 Node 24）

3 安 装 配 置

提醒：本次安装配置首先是在Centos10进行。

3.1 安装脚本

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

执行后会自动检测所需的依赖是否存在以及是否支持。不满足的会自动下载。

执行过程：

  🦞 OpenClaw Installer
  Chat automation for people who peaked at IRC.

✓ Detected: linux

Install plan
OS: linux
Install method: npm
Requested version: latest

[1/3] Preparing environment
· Node.js not found, installing it now
· Installing Node.js via NodeSource
· Installing Linux build tools (make/g++/cmake/python3)
✓ Build tools installed
✓ Node.js v22 installed
· Active Node.js: v22.22.1 (/usr/bin/node)
· Active npm: 10.9.4 (/usr/bin/npm)

[2/3] Installing OpenClaw
· Git not found, installing it now
✓ Git installed
· Installing OpenClaw v2026.3.13

[3/3] Finalizing setup

🦞 OpenClaw installed successfully (OpenClaw 2026.3.13 (61d171a))!
Finally unpacked. Now point me at your problems.

· Starting setup

3.2 Open Claw引导配置

  1. I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?：Yes
  2. Onboarding mode：选择 QuickStart
  3. Model/auth provider：选择 Skip for now（稍后配置模型）
  4. Filter models by provider：选择 All providers
  5. Default model：选择 Keep current
  6. Select channel (QuickStart)：选择 Skip for now（稍后配置渠道）
  7. Search provider：选择 Skip for now（稍后配置渠道）
  8. Configure skills now? (recommended)：选择 No
  9. Enable hooks?：使用空格选择 Skip for now（稍后配置渠道），按回车键进入下一步
  10. How do you want to hatch your bot?：选择 Do this later

完成所有引导配置。

OpenClaw 提供了两种配置方式，推荐使用 Web 控制台配置。

  1. 启动 Web 控制台，在终端中运行以下命令：
openclaw dashboard

启动后显示的Open Claw控制台页面地址：

🦞 OpenClaw 2026.3.13 (61d171a) — I can run local, remote, or purely on vibes—results may vary with DNS.

Dashboard URL: http://127.0.0.1:18789/#token=13eea5f6dcdd5d1fb8854e3ffda9b4ff3ebc3c18aa0615d6
Copy to clipboard unavailable.
No GUI detected. Open from your computer:
ssh -N -L 18789:127.0.0.1:18789 root@192.168.1.220
Then open:
http://localhost:18789/
http://localhost:18789/#token=13eea5f6dcdd5d1fb8854e3ffda9b4ff3ebc3c18aa0615d6
Docs:
https://docs.openclaw.ai/gateway/remote
https://docs.openclaw.ai/web/control-ui
  1. 浏览器会自动打开 OpenClaw 的控制台页面（通常是 http://127.0.0.1:18789）。如果浏览器没有自动打开，请手动访问该地址。【注意这个地址是只能本机访问！】

3.3 配置局域网访问

Open Claw默认监听 127.0.0.1:18789，仅本机可访问。若要在局域网内其他设备（如手机、平板、其他电脑）访问 OpenClaw，需要修改配置使其绑定到局域网可访问的地址。

通常报错为：origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)

首先启动 Web 控制台，在终端中运行以下命令：

openclaw dashboard

方式一：命令行快速配置（推荐）

# 1 允许局域网访问（作用：将网关从 loopback（仅本地）模式切换为 lan（局域网/公网可访问）模式）
openclaw config set gateway.bind lan

# 2. 允许非安全认证（解决跨域问题）
openclaw config set gateway.controlUi.allowInsecureAuth true

# 3. 关键步骤：禁用设备身份验证（允许 HTTP 访问）
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true

# 4. 配置允许的来源 Origins（解决跨域访问）
openclaw config set 'gateway.controlUi.allowedOrigins' '["http://192.168.1.220:18789"]'

# 5. 重启网关服务使配置生效
openclaw gateway restart

# 6. 验证服务监听状态（预期输出：0.0.0.0:18789 或 192.168.x.x:18789（而非 127.0.0.1:18789））
openclaw gateway status

方式二：手动编辑配置文件

直接把OpenClaw的gateway的配置改成可跨域：

 gateway: {
    port: 18789,
    mode: 'local',
    bind: 'lan',  // 确保绑定到 LAN 或 0.0.0.0
    controlUi: {
      allowedOrigins: [
        'http://192.168.1.220:18789',
      ],
      allowInsecureAuth: true,
      dangerouslyDisableDeviceAuth: true,
    },
  1. 重启网关服务使配置生效
openclaw gateway restart

使用方式一或方式二配置好后，如果访问不了，可能是没开放服务器的18789端口！

# 查看开放的端口
firewall-cmd --list-ports

# 开放18789端口
firewall-cmd --permanent --add-port=18789/tcp

# 重新加载防火墙
firewall-cmd --reload

再访问IP:18789

4 配置大模型

这里使用阿里的百炼模型配置。
访问IP:18789

  1. 进入配置页面
    在左侧菜单栏中依次选择：配置 > RAW（或Config > RAW）【右上角有Raw】。
    添加百炼配置，复制以下配置信息，替换原"agents": {...},部分，并将 DASHSCOPE_API_KEY 替换为百炼 API Key：
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "DASHSCOPE_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "qwen3-coder-next",
            "name": "qwen3-coder-next",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 262144,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-coder-next": {}
      }
    }
  },

保存并应用配置，配置完成后，单击右上角 Save 保存配置，单击 Update。

5 使用

5.2 OpenClaw官方SKills库

  1. https://zhuanlan.zhihu.com/p/2011890464383604275
  2. https://developer.aliyun.com/article/1712680

5.3 OpenClaw接入微信

系统要求

  • macOs/Linux系统
  • OpenClaw已安装并运行
  • 微信手机客户端（用于扫码登录）注意：微信最好是最新版本的！
  1. 检查OpenClaw里是否有微信插件及状态：
openclaw gateway restart

重启时观察输出，确认是否有微信插件。
2. 在OpenClaw安装微信插件：

# 快速安装（推荐）
npx -y @tencent-weixin/openclaw-weixin-cli install

# 或者手动安装
openclaw plugins install "tencent-weixin/openclaw-weixin"
  1. OpenClaw启用微信插件：
openclaw config set plugins.entries.openclaw-weixin.enabled true
  1. 验证配置：
openclaw configure
  1. OpenClaw调用微信二维码
openclaw channels login --channel openclaw-weixin
  1. 微信手机端扫码登录
  2. 授权登录成功后，手机端危险时，登录成功。
  3. 重启OpenClaw的Gateway，使配置生效。
  4. 测试微信连接

在微信手机端，找到刚刚登录的设备，发送一条消息，观察OpenClaw是否收到并回复。

如果配置成功，OpenClaw应该能接收微信消息，处理消息内容，并发送消息到微信。

6 卸载

简单方式（CLI 仍已安装）：

使用内置卸载程序：

openclaw uninstall

手动步骤（效果相同）：

  1. 停止 Gateway 网关服务：
openclaw gateway stop
  1. 卸载 Gateway 网关服务（launchd/systemd/schtasks）：
openclaw gateway uninstall
  1. 删除状态 + 配置：
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

如果你将 OPENCLAW_CONFIG_PATH 设置为状态目录外的自定义位置，也请删除该文件。
4. 删除你的工作区（可选，移除智能体文件）：

rm -rf ~/.openclaw/workspace
  1. 移除 CLI 安装（选择你使用的那个）：
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
  1. 如果你安装了 macOS 应用：
rm -rf /Applications/OpenClaw.app

注意事项：

如果你使用了配置文件（–profile / OPENCLAW_PROFILE），对每个状态目录重复步骤 3（默认为 ~/.openclaw-）。
在远程模式下，状态目录位于 Gateway 网关主机上，因此也需要在那里运行步骤 1-4。

7 出现的问题

8 总结

# linux
Logo
亚马逊云科技技术品牌专区

更多推荐

cover

把真实的时间序列数据喂给TimechoAI，让它帮你找异常

avatar 亚马逊云科技技术品牌专区
cover

Python深度学习：从入门到实战

avatar 亚马逊云科技技术品牌专区
cover

【AI大模型接入SDK】名词解释

avatar 亚马逊云科技技术品牌专区