Linux部署

Docker方式部署

第一步：启动openclaw容器

# 1. 拉取最新镜像（国内源）
docker pull sgccr.ccs.tencentyun.com/openclaw/openclaw:latest

# 2. 获取配置
docker run -itd \
  --name openclaw \
  --restart always \
  -p 18789:18789 \
  --cap-drop=ALL \
  --security-opt no-new-privileges:true \
  sgccr.ccs.tencentyun.com/openclaw/openclaw \
  openclaw gateway \
  --port 18789 \
  --bind lan \
  --allow-unconfigured

注意：openclaw gateway 后面的参数

openclaw参数说明：

• --port 服务的端口号
• --bind lan 表示将OpenClaw的Web网关绑定到局域网（LAN）接口‌，即监听所有本地网络接口（相当于 0.0.0.0），使得同一局域网内的其他设备‌可以通过访问该设备的IP地址和端口来使用OpenClaw的控制界面（Control UI）。默认情况下，OpenClaw 只绑定到 loopback（仅本机可访问）。
• --allow-unconfigured 作用是‌允许在配置不完整或未明确设置某些关键参数的情况下启动服务

docker参数说明：

• -i（–interactive）‌：以交互模式运行容器。
• ‌-d（–detach）‌：在后台运行容器。容器不会占用当前终端，适合长期运行的服务。
• ‌-t（–tty）‌：为容器分配一个伪终端，模拟一个真实的终端环境。
• --name 创建容器名
• --restart always：开机自启，服务崩溃自动重启
• -p {port1}:{port2}：从本机端口{port1}映射到容器内端口{port2}
• --cap-drop=ALL：禁用所有容器特权，最小化权限，降低逃逸风险
• --security-opt no-new-privileges:true：禁止容器内进程提升权限

运行成功

docker logs -f openclaw

第二步：建立openclaw与浏览器页面连接

1. 获取页面地址及Token，服务器执行

docker exec -it openclaw openclaw dashboard

2. 浏览器远程连接，首先在Windows上运行cmd，执行

ssh -N -L 18789:127.0.0.1:18789 user@<host>

user@<host>为openclaw部署的服务器地址

3. 然后浏览器打开带有token的地址

4. 建立连接

在服务器终端执行以下命令：
（1）查看待配对的设备请求：

docker exec -it openclaw openclaw devices list

复制下图位置的Request ID

（2）批准配对请求：

复制上面查到的 Request ID，执行：

# 请将 <requestId> 替换为你在上一步看到的实际 ID
docker exec -it openclaw openclaw devices approve <requestId>

5. 再次刷新页面，点击Overview，可以看到Status为OK

第三步：配置大模型API

1. 配置大模型

docker exec -it openclaw openclaw config set 'models.providers.ark' --json '{
  "baseUrl": "YOUR_BASE_URL",
  "apiKey": "YOUR_API_KEY",
  "api": "openai-completions",
  "models": [
    {
      "id": "YOUR_MODEL_ID",
      "name": "YOUR_MODEL_NAME",
      "contextWindow": YOUR_MODEL_CONTEXT_WINDOW,
      "maxTokens": YOUR_MODEL_MAX_TOKENS
    }
  ]
}'

注意：需要替换以下内容

• YOUR_BASE_URL
• YOUR_API_KEY
• YOUR_MODEL_ID
• YOUR_MODEL_NAME
• YOUR_MODEL_CONTEXT_WINDOW
• YOUR_MODEL_MAX_TOKENS

2. 设置agent调用的默认大模型

# 设置默认模型
docker exec -it openclaw openclaw config set 'agents.defaults.model.primary' 'ark/YOUR_ENDPOINT_ID'

注意：需要将YOUR_MODEL_ID替换为上一步一样的YOUR_MODEL_ID

3. 重启网关

# 重启网关
docker exec -it openclaw openclaw gateway restart
# 重启网关如果失败，就重启容器
docker restart openclaw