登陆 注册
AI创想 › 综合版块 › OpenClaw › OpenClaw本地Docker安装部署+自定义配置国内大模型 ...
25位大厂高管转战生成式AI创业！吸金猛，不

[hr] 智东西 作者 李水青 编辑 心缘 智东西7月2日报道，今年3月智东西曾报道，超14位互联网大厂离职高管 详细

返回列表 发新帖
开启左侧

OpenClaw本地Docker安装部署+自定义配置国内大模型

[复制链接]
AI小编 发表于 昨天 07:05 | 显示全部楼层 |阅读模式 打印 上一主题 下一主题
作者：CSDN博客
目录
一、源码Docker镜像部署
        1.第一步：安装Node.js
        2.第二步：配置环境变量
        3.第三步：构建镜像
        4.第四步：初始化openclaw配置
        5.第五步：启动容器
二、配置国内模型API
     1.方法一：交互式配置
      2.方法二：openclaw CLI 命令工具
      3.方法三：直接修改配置文件
阶段性完结
一、源码Docker镜像部署

        github地址：https://github.com/openclaw/openclaw
        下载源码到本地。
OpenClaw本地Docker安装部署+自定义配置国内大模型-1.png


        1.第一步：安装Node.js

        安装地址：https://nodejs.org/zh-cn
OpenClaw本地Docker安装部署+自定义配置国内大模型-2.png


        2.第二步：配置环境变量

        复制示例环境文件，也可以直接创建一个空的.env文件
  1. copy .env.example .env
复制代码
       解释几个需要填写参数：           
OPENCLAW_GATEWAY_TOKEN：访问 Gateway 的认证密钥（关键核心配置）。Gateway 启动后会暴露 WebSocket 和 HTTP 接口，没有这个 token 任何人都能连进来。相当于你家门的钥匙，必须设置。
OPENCLAW_CONFIG_DIR：OpenClaw 存放配置文件（后续可修改模型配置）（openclaw.json、频道凭证、身份信息等）的目录。Docker 容器通过 volume 挂载这个目录，这样容器重启后配置不会丢失。
OPENCLAW_WORKSPACE_DIR： Agent 的工作目录（后续可查看agent操作文件），它在这里读写文件、执行任务。
OPENCLAW_GATEWAY_PORT：Gateway 监听的端口，默认 18789。
OPENCLAW_GATEWAY_BIND：决定 Gateway 监听哪个网卡。loopback = 只有本机能访问（127.0.0.1），但 Docker bridge 网络下宿主机也访问不到；lan = 监听所有网卡（0.0.0.0），宿主机和局域网都能访问，Docker 部署必须用这个。
  1. # .env文件内容
  2. OPENCLAW_GATEWAY_TOKEN=xxxxxxxxx  # 需自定义修改（类似账户密码）
  3. OPENCLAW_CONFIG_DIR=X:xxx/openclaw   # 本地创建一个文件夹，填写绝对路径
  4. OPENCLAW_WORKSPACE_DIR=X:xxx/openclaw/workspace  # 本地创建一个文件夹，填写绝对路径
  5. OPENCLAW_GATEWAY_PORT=18789
  6. OPENCLAW_GATEWAY_BIND=lan
复制代码
OPENCLAW_GATEWAY_TOKEN随机生成指令方式：
  1. # Powershell方式
  2. -join ((1..32) | ForEach-Object { '{0:x2}' -f (Get-Random -Max 256) })
  4. # Python方式
  5. python -c "import secrets; print(secrets.token_hex(32))"
复制代码
       复制打印的字符串token即可。
OpenClaw本地Docker安装部署+自定义配置国内大模型-3.png


        3.第三步：构建镜像

        配置docker中镜像源加速
  1. # docker配置镜像源
  2. {
  3.   "builder": {
  4.     "gc": {
  5.       "defaultKeepStorage": "20GB",
  6.       "enabled": true
  7.     }
  8.   },
  9.   "experimental": false,
  10.   "registry-mirrors": [
  11.     "https://docker.m.daocloud.io",
  12.     "https://dockerproxy.com",
  13.     "https://hub-mirror.c.163.com"
  14.   ]
  15. }
复制代码
OpenClaw本地Docker安装部署+自定义配置国内大模型-4.png


        源码路径下cmd，使用构建指令，耐心等待镜像构建完成。
  1. docker build -t openclaw:local .
复制代码
       完成后可以看到docker镜像images中新添内容
OpenClaw本地Docker安装部署+自定义配置国内大模型-5.png


        4.第四步：初始化openclaw配置

        使用以下指令进入docker容器内部openclaw安装初始化
  1. docker compose run --rm openclaw-cli onboard --mode local --no-install-daemon
复制代码
       选择Yes
OpenClaw本地Docker安装部署+自定义配置国内大模型-6.png


        选QuickStart。先跑起来，后续可以随时用 openclaw configure 补充配置；Manual 模式会逐项填写所有配置项，比较繁琐
OpenClaw本地Docker安装部署+自定义配置国内大模型-7.png


       模型服务商选择， 先跳过Skip for now，后期自己配置。
OpenClaw本地Docker安装部署+自定义配置国内大模型-8.png


        模型平台的 API key。还没有任何 API key，选 All providers 先跳过，后面再配。
OpenClaw本地Docker安装部署+自定义配置国内大模型-9.png


        默认选择模型。第一个就好，后期可自行设置
OpenClaw本地Docker安装部署+自定义配置国内大模型-10.png


        这一步是选择想通过哪个聊天平台来使用 AI 助手。
        比如选  Feishu/Lark (飞书)，配置好认证 token 之后，你就可以直接在  Feishu/Lark (飞书) 里跟 AI 对话；选 Twitch 就在 Twitch  里对话，以此类推。
        选 Skip for now 跳过，后续有需求再配。
OpenClaw本地Docker安装部署+自定义配置国内大模型-11.png


        下面选项是给 AI 助手配置联网搜索能力。
        配置平台 API key 之后，在跟 AI 对话时它可以主动去搜索最新信息，比如"帮我查一下今天的新闻"、"搜索某个技术文档"之类的。
        没有对应平台的 API key 的话，选 Skip for now 跳过，不影响基本使用，AI 还是能正常对话，只是没有联网搜索功能。
OpenClaw本地Docker安装部署+自定义配置国内大模型-12.png


        下一个Skills 是给 AI 助手扩展能力的插件，比如读取文件、执行代码、操作浏览器等工具能力。
         选 No 跳过就行，先把基础跑通，Skills 后面有需要再单独配置。安装skills需谨慎，以防投毒风险。
OpenClaw本地Docker安装部署+自定义配置国内大模型-13.png


        Hooks 是自动化触发器，当特定事件发生时自动执行某些操作。
        几个选项的含义：
                boot-md — 每次 agent 启动时自动加载一个 markdown 文件作为上下文
                 bootstrap-extra-files — 启动时自动注入额外的文件到 agent 上下文
                 command-logger — 记录所有命令日志
                 session-memory — 执行 /new 或 /reset 重置会话时，自动把当前会话内容保存到记忆里，下次还能记住
         现在先选 Skip for now 跳过，把主流程跑通再说。
OpenClaw本地Docker安装部署+自定义配置国内大模型-14.png


        5.第五步：启动容器

        先设置运行访问来源地址
  1. docker compose run --rm openclaw-cli config set gateway.controlUi.allowedOrigins "["http://localhost:18789"]" --strict-json
复制代码
       使用命令直接启动
  1. docker compose up -d openclaw-gateway
复制代码
       启动后，网页访问 http://localhost:18789 （.env文件中配置的本地端口）
        ci'hc输入.env文件中配置的OPENCLAW_GATEWAY_TOKEN即可登录。
OpenClaw本地Docker安装部署+自定义配置国内大模型-15.png


        此时还不能登录，需要后台允许设备访问。
（关键步骤）继续需要配置允许设备访问：
        下面指令查看已配对的设备
  1. docker compose run --rm openclaw-cli devices list
复制代码
       下面指令修改最后的设备id为上述查询到的Pending Request下的字符串
  1. docker compose run --rm openclaw-cli devices approve xxxxxx  # 修改xxxxx为实际设备id
复制代码
       修改成功后，可正常登录到使用界面
OpenClaw本地Docker安装部署+自定义配置国内大模型-16.png


二、配置国内模型API

        回顾第二步配置环境文件.env中的两个参数OPENCLAW_CONFIG_DIR、OPENCLAW_WORKSPACE_DIR，这两个配置的本机路径，就是映射到docker容器中的相关文件了。
        可以直接在windows系统下，到配置的本机目录下找到 openclaw 配置文件 openclaw.json 进行文本修改，无需进入容器的bash交互麻烦。
OpenClaw本地Docker安装部署+自定义配置国内大模型-17.png

配置自定义的外部模型API：
     1.方法一：交互式配置

        如果还不熟悉 openclaw，可以使用其提供的命令行CLI工具进行自动化配置。
  1. # 交互式配置模型
  2. docker compose run --rm openclaw-cli models auth login
复制代码
        实际就是重新进入第四步安装界面进行配置
OpenClaw本地Docker安装部署+自定义配置国内大模型-18.png


      2.方法二：openclaw CLI 命令工具

        直接用 config set 命令逐项写入
  1. # 设置 provider 配置（base URL + API key + 模型定义）
  2. docker compose run --rm openclaw-cli config set models.providers.my-provider "{"baseUrl":"https://dashscope.aliyuncs.com/compatible-mode/v1","api":"openai-completions","apiKey":"sk-你的key","models":[{"id":"qwen-plus","name":"qwen-plus","reasoning":false,"input":["text"],"contextWindow":128000,"maxTokens":4096,"cost":{"input":0,"output":0,"cacheRead":0,"cacheWrite":0}}]}" --strict-json
  4. # 设置默认模型
  5. docker compose run --rm openclaw-cli models set "my-provider/qwen-plus"
复制代码
3.方法三：直接修改配置文件

        熟悉的话，可以直接在本地docker映射的目录下，找到 openclaw.json 文件直接修改。但是修改完之后要重新 docker 以生效
  1. # 修改配置完之后运行
  2. docker compose restart openclaw-gateway
复制代码
  1. "models": {
  2.     "providers": {
  3.       "my-provider": {
  4.         "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  5.         "apiKey": "sk-xxxxx",
  6.         "api": "openai-completions",
  7.         "models": [
  8.           {
  9.             "id": "qwen-plus",
  10.             "name": "qwen-plus",
  11.             "reasoning": false,
  12.             "input": [
  13.               "text"
  14.             ],
  15.             "cost": {
  16.               "input": 0,
  17.               "output": 0,
  18.               "cacheRead": 0,
  19.               "cacheWrite": 0
  20.             },
  21.             "contextWindow": 128000,
  22.             "maxTokens": 4096
  23.           }
  24.         ]
  25.       }
  26.     }
  27.   },
  28.   "agents": {
  29.     "defaults": {
  30.       "model": {
  31.         "primary": "my-provider/qwen-plus"
  32.       },
  33.       "models": {
  34.         "my-provider/qwen-plus": {}
  35.       },
  36.       "workspace": "/home/node/.openclaw/workspace"
  37.     }
  38.   },
复制代码
OpenClaw本地Docker安装部署+自定义配置国内大模型-19.png


阶段性完结

        上述任一方法配置完模型后，再次访问 http://localhost:18789 ，就可以正常对话了。
OpenClaw本地Docker安装部署+自定义配置国内大模型-20.png


        后续继续发布使用openclaw基础功能、openclaw插件安装、skills使用、3D可视化Agent工作......

原文地址：https://blog.csdn.net/qq_58718853/article/details/159350686
回复

使用道具 举报

返回列表 发表新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

AI小编高级会员

关注0

粉丝0

帖子219

发布主题
推荐阅读更多+
阅读排行更多+
用心服务创业者
www.llms-ai.com
AI创想

Powered by Discuz! X3.4© 2001-2013 Discuz Team.( 京ICP备17022993号-3 )