logo
0
1
WeChat Login
docs: 更新 README 文档

openclaw

开整!从 0 到 1 把玩小龙虾(openclaw),怎么好玩怎么来~

项目简介

本项目提供了基于 Docker Compose 的一键部署方案,用于运行 OpenClaw AI 网关服务。OpenClaw 是一个强大的 AI 模型网关,支持多模型接入、工具调用和技能扩展。

架构概览

项目采用双层架构:

  • openclaw:AI 网关服务,监听 18789 端口
  • openresty:反向代理服务,对外暴露 8080 端口

环境变量

在启动服务前,需要配置以下环境变量:

变量名说明
CNB_API_ENDPOINTCNB API 端点地址
CNB_REPO_SLUG代码仓库标识
CNB_TOKEN认证令牌

快速开始

1. 配置环境变量

创建 .env 文件(或在 shell 中设置环境变量):

CNB_API_ENDPOINT=https://api.example.com CNB_REPO_SLUG=your-repo-slug CNB_TOKEN=your-api-token

2. 启动服务

docker-compose up -d

3. 访问服务

服务启动后,可通过以下方式访问:

配置说明

Nginx 配置

Nginx 配置支持 WebSocket 连接和 HTTP 代理,已禁用缓存和缓冲以确保实时性。

OpenClaw 配置

默认配置包含:

  • 模型提供者:支持 CNB 和 CodeBuddy 两种模型来源
  • 工具:启用 Web 搜索、网页获取、Agent 通信、文件执行等工具
  • 网关:本地模式,端口 18789,启用控制 UI
  • 技能:使用 npm 作为节点管理器

开发与构建

构建镜像

docker build -t docker.cnb.cool/zhiqiangwang/openclaw:latest .

重新部署

docker-compose down docker-compose up -d --build

查看日志

# 查看所有服务日志 docker-compose logs -f # 查看指定服务日志 docker-compose logs -f openclaw docker-compose logs -f openresty

常用命令

# 启动服务 docker-compose up -d # 停止服务 docker-compose down # 重启服务 docker-compose restart # 查看服务状态 docker-compose ps # 进入 OpenClaw 容器 docker-compose exec openclaw bash

技术栈

  • OpenClaw:AI 网关服务
  • OpenResty:高性能 Web 平台(基于 Nginx 和 LuaJIT)
  • Docker Compose:容器编排
  • Chromium:浏览器环境(用于网页抓取等)

注意事项

  1. 首次启动时,OpenClaw 会自动执行 setup 初始化配置
  2. 默认启用了不安全的设备认证,生产环境请修改 cnb-openclaw.json 配置
  3. Nginx 代理配置了 24 小时的读写超时,适用于长时间运行的 AI 任务

高级配置

查看当前认证配置

docker exec openclaw jq .gateway.auth /root/.openclaw/openclaw.json

设置允许跨域访问

docker exec openclaw openclaw config set gateway.controlUi.allowedOrigins.[0] "*"

执行后会自动重启服务使配置生效。