OpenClaw MacOS/Linux龙虾安装教程

官方网站：https://openclaw.ai/

项目地址：https://github.com/openclaw/openclaw

一、执行 openclaw 安装脚本

打开终端执行命令：curl -fsSL https://openclaw.ai/install.sh | bash

会自动安装依赖工具和依赖环境，安装时间可能会有点长，耐心等待。

二、启动初始化配置

1、执行 openclaw 初始化命令：openclaw onboard –install-daemon

2、是否明白此工具功能强大且存在固有风险。是否继续？选择yes

3、选择快速安装模式

4、配置大模型，先选择跳过

5、按提供商筛选模型，这里选择Google

6、随便选一个模型，后面会重新配的

7、配置对话机器人，先跳过，后面再进行配置

8、配置自带的skills包，选择yes

9、skills安装方式，选择pnpm

10、选择自己所需要的skills然后回车

✅ 推荐勾选清单（核心刚需–只选最有用的）

• clawhub（插件中心，必须开）
• summarize（网页 / 文件一键摘要）
• github（Git/GitHub 操作）
• goplaces（终端快速跳目录）

✅【推荐（提升效率）】

• gemini（AI 助手，命令行直接问问题）
• openai-whisper（语音转文字）
• nano-banana-pro（nano 编辑器变强）
• himalaya（终端查邮件）

11、配置skills所需的大模型apikey，这里全部选择No

12、自动安装好后会启动网关

三、在配置文件 openclaw.json 中加入 模型供应商 API

1. 文件路径 ~/.openclaw/openclaw.json
2. 打开文件，将其中的 models 部分替换成下面的内容，请一定注意将 apiKey 更换为您自己的：

{
  // 模型总配置节点
  "models": {
    // 模型提供商配置（不同AI服务商）
    "providers": {
      // Claude模型提供商配置
      "codeassist-claude": {
        // API请求基础地址
        "baseUrl": "https://api.XXX.com/api/claudecode",
        // 访问API的密钥（需替换为实际有效密钥）
        "apiKey": "换成你的key",
        // API接口类型标识
        "api": "anthropic-messages",
        // 该提供商下支持的具体模型列表
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929", // 模型唯一标识（调用时使用）
            "name": "Claude Sonnet 4.5"        // 模型友好名称（展示用）
          },
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5"
          }
        ]
      },
      // GPT模型提供商配置
      "codeassist-gpt": {
        "baseUrl": "https://api.XXX.com/api/codex/backend-api/codex",
        "apiKey": "换成你的key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2"
          },
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4"
          }
        ]
      },
      // Gemini模型提供商配置
      "codeassist-gemini": {
        "baseUrl": "https://api.XXX.com/api/gemini/v1",
        "apiKey": "换成你的key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-3-pro-preview",
            "name": "Gemini 3 Pro Preview"
          },
          {
            "id": "gemini-3-flash-preview",
            "name": "Gemini 3 Flash Preview"
          }
        ]
      }
    }
  }
}

3、配置完成后，打开终端执行命令：openclaw gateway restart，重启网关服务

4、回到claw网关的网页界面，在「chat」输入「/models」查看已配置的 provider

输入「/models codeassist-claude」选择 claude 系列 provider（您也可以选择 codeassist-gemini 或 codeassist-gpt）

5、输入「/model codeassist-claude/claude-opus-4-5-20251101」选择 claude opus 模型

6、发送「你好」等待模型回复，验证是否配置正确

四、配置机器人对话（可选）

参考 OpenClaw 文档：https://docs.openclaw.ai/channels

五、网页访问OpenClaw

本地访问（Gateway 主机上）：

Dashboard: http://127.0.0.1:18789/
Control UI: http://127.0.0.1:18789/openclaw/

远程访问（适用于部署在服务器上的openclaw，通过PC电脑浏览器去访问）

openclaw安装好后默认只允许本地访问，外部访问修改修改openclaw.json文件的gateway配置。

nano ~/.openclaw/openclaw.json

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "http://localhost:18789",
        "http://127.0.0.1:18789",
        "http://192.168.XX.XX:18789"    //解决跨域问题
      ],
      "dangerouslyDisableDeviceAuth": true   //允许HTTP下的令牌认证，绕过设备标识限制
    },

注意：在PC打开远端服务器上的openclaw控制台后提示：

“control ui requires device identity (use HTTPS or localhost secure context) 此页面为 HTTP，因此浏览器阻止设备标识。请使用 HTTPS (Tailscale Serve) 或在网关主机上打开 http://127.0.0.1:18789。 如果您必须保持 HTTP，请设置 gateway.controlUi.allowInsecureAuth: true (仅限令牌)。 Docs: Tailscale Serve · Docs: Insecure HTTP”

解决办法：openclaw.json文件的gateway配置添加 dangerouslyDisableDeviceAuth: true

• 新版 OpenClaw 核心配置项已变更：dangerouslyDisableDeviceAuth: true 替代旧的 allowInsecureAuth: true；
• 配置后重启网关即可绕过 HTTP 的设备身份验证限制，快速访问 Control UI；
• 该配置为临时测试方案，生产环境优先选择 HTTPS/SSH 端口转发的安全方式。

访问WEB控制台的时候记得把token值带上，获取方法，输入openclaw dashboard ,然后在浏览器输入http://IP地址:18789/#token=值

注意：非必要不映射到公网环境，部分实例在默认或不当配置情况下存在较高安全风险，极易引发网络攻击、信息泄露等安全问题。请在安全加固条件下再考虑对外访问。