晨涧云文档

首页

OpenClaw镜像 - Ubuntu

OpenClaw 是一款开源、高可扩展的AI Agent框架，基于TypeScript开发，核心用途是构建可自定义的私人AI助手，支持多场景任务自动化、多平台集成和多模型协作。

当前支持的版本

OpenClaw版本	Ubuntu版本	CUDA版本	Python版本
v2026.3.28	22.04	-	3.11

当前支持的版本会随着OpenClaw版本的更新而更新。

访问OpenClaw

系统创建好后，可通过浏览器访问OpenClaw界面。

查看访问地址，默认监听到内网8001端口，可通过8001对应的外网端口访问，外网端口请看下图

a7aa15f844f1ada8c20a809c2291666c.png#733px #215px

点击预留端口打开端口映射，如上图，获取内网8001的外网端口

控制台上查看机器IP，该IP是就是外网IP，在浏览器通过 “http://IP:外网端口” 访问服务，假如你的机器内网8001端口映射的外网端口为38190（这个外网端口是示例，实际映射端口，请看控制台，预留端口），则访问地址如下所示
```
	http://外网IP:38190
```
在浏览器输入上面URL后，可直接打开OpenClaw界面，如下图所示：

初次打开页面，需要输入token才能登录系统。登录系统后台，用系统命令行Terminal, 输入以下命令打开如下文件获取token:

cat /home/linux/.openclaw/openclaw.json

或者执行以下命令查看

openclaw dashboad

image.png#509px #254px

复制并输入Gateway Token，点击Connect，即可登录OpenClaw系统。

重要提示：以上token是系统镜像默认的token，强烈建议你设置个人的token，避免安全隐患。请参考以下运维章节如何设置token。

设置中文界面

初次登录默认是英文界面，如果需要切换为中文。在界面左侧选择Overview菜单，在页面的Language选择简体中文即可切换为中文。

image.png#1296px #583px

配置大模型

OpenClaw需要配置大模型才能使用，这里需要提供大模型的baseUrl和apiKey。

在Gateway Dashboard界面选择 配置 => 右边选Raw => 填入JSON格式的大模型配置 => 点击Apply生效。

镜像已经默认配置了智普的免费模型glm-4.7-flash，只需要登录智普官方申请apiKey，填入apiKey即可使用该模型。

iShot_2026-03-15_21.32.57.png#1349px #607px

1、如果要配置其他模型，例如Claude也是可以的。如下的Json配置以连接Claude模型为例（注意替换自己的baseUrl和apiKey，然后选择合适的默认模型修改配置（agents.defaults.model.primary），添加后整个JSON大概是这样的：

{
  "meta": {
    "lastTouchedVersion": "2026.2.24",
    "lastTouchedAt": "2026-02-26T18:15:43.767Z"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-claude": {
        "baseUrl": "https://api.xxx.xxx",
        "apiKey": "sk-xxxxxxxxxxxxxxxxx",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude 4.6 Opus",
            "reasoning": false,
            "input": [
              "text"
            ],
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude 4.6 Sonnet",
            "reasoning": false,
            "input": [
              "text"
            ],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "api-claude/claude-sonnet-4-6"
      },
      "workspace": "/root/.openclaw/workspace"
    },
    "list": [
      {
        "id": "main",
        "name": "main",
        "workspace": "/root/.openclaw/workspace",
        "agentDir": "/root/.openclaw/agents/main/agent"
      }
    ]
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "gateway": {
    "mode": "local",
    "controlUi": {
      "dangerouslyAllowHostHeaderOriginFallback": true,
      "dangerouslyDisableDeviceAuth": true
    }
  }
}

2、配置GPT5，如下图
d80625d07cc7e56e984ebd7560450f49.png#486px #389px

默认模型agents.defaults.model.primary配置如下图
9ed0c38953ff87716e48915767b83d43.png#493px #350px

配置后点击Apply就会生效，稍等Gateway重新启动完成就可以跟大模型对话让它帮你干活了。

对话

在Gateway显示健康状况是正常之后就会在【聊天】窗口跟Openclaw对话指挥它干活了。

OpenClaw对话.png#981px #289px

当输入“你好”之后，如果一切正常，OpenClaw会回复“你好！我刚上线——这是个全新的开始，……”之类的，说明就可以正常使用了。

运维

查看OpenClaw服务状态

登录后台，以linux用户执行以下指令

查看服务状态

openclaw status

启停OpenClaw服务

登录后台，以linux用户执行以下指令

启动服务

openclaw gateway start

停止服务

openclaw gateway stop

重启服务

openclaw gateway restart

查看日志

登录后台，以linux用户执行以下指令

查看OpenClaw日志

在运行过程中，建议打开一个命令行Terminal，可以随时观察运行日志

openclaw logs --follow

其他操作

其他更多对openclaw的控制，可以使用openclaw CLI工具，执行以下命令查看帮助：

openclaw --help

常用操作如下：

# 1. 查看openclaw整体状态
openclaw status

# 2. 查看gateway状态
openclaw gateway status

# 3. 查看skills列表
openclaw skills list

# 4. 查看模型
openclaw models list

# 5. 升级openclaw
openclaw update

升级OpenClaw

如需升级OpenClaw，官方推荐的方法是执行以下命令：

openclaw update

注意：由于openclaw目前的流行程度很高，官方更新迭代很快，升级版本后，可能OpenClaw的界面布局会有较大改变，与上述截图可能会存在较大差异。但建议你更新到最新版本，新版本会解决很多安全漏洞。

设置Token

可以直接在openclaw.json文件修改gateway.auth.token，也可以执行以下命令设置个人token：

openclaw config set gateway.auth.token '<你的个人token>'

设置后，如果默认没有重启，执行以下命令重启openclaw生效：

openclaw gateway restart