openclaw添加自定义agent

文档

1. ubuntu安装openclaw-docker安装openclaw
2. openclaw添加大模型-千问大模型-qwen3-max

openclaw添加agent

1. 观察openclaw.json中，agents部分的现有配置

   "agents": {
       "defaults": {
           "model": {
               "primary": "custom-dashscope-aliyuncs-com/qwen3-max-2026-01-23"
           },
           "models": {
               "custom-dashscope-aliyuncs-com/qwen3-max-2026-01-23": {}
           },
           "compaction": {
               "mode": "safeguard"
           },
           "maxConcurrent": 4,
           "subagents": {
               "maxConcurrent": 8
           }
       }
   }
   

   • 这里只看到了defaults配置，表示的是默认的配置信息，但defaults并不是一个agent
   • 有一个隐含的main agent，是系统内置的，如果不做修改，自动使用defaults中的配置，工作路径是：/home/node/.openclaw/agents/main，容器内部的路径

2. 进入到容器里

   docker exec -it openclaw-gateway sh
   

3. 执行配置命令，添加一个编码的agent：coder

   openclaw agents add coder
   

   会有如下交互：

   • Workspace directory

     • /home/node/.openclaw/workspace-coder，会返回默认的工作路径，容器内部的路径

   • Configure model/auth for this agent now?

     • Yes

   • Model/auth provider

     • Custom Provider，就填这个，不要选择Ali开头的，选择那个会加载出很多没用的模型

   • Configure chat channels now?

     • Yes

     配置结束。

4. 退出容器

5. 此时看agents部分的配置

   "agents": {
       "defaults": {
           "model": {
               "primary": "custom-dashscope-aliyuncs-com/qwen3-max-2026-01-23"
           },
           "models": {
               "custom-dashscope-aliyuncs-com/qwen3-max-2026-01-23": {}
           },
           "compaction": {
               "mode": "safeguard"
           },
           "maxConcurrent": 4,
           "subagents": {
               "maxConcurrent": 8
           }
       },
       "list": [
           {
               "id": "main"
           },
           {
               "id": "coder",
               "name": "coder",
               "workspace": "/home/node/.openclaw/workspace-coder",
               "agentDir": "/home/node/.openclaw/agents/coder/agent"
           }
       ]
   }
   

   • 可以发现，已经创建了coder agent，但并没有为coder agent配置专有模型
   • 目前没有找到为agent配置专有模型的命令

6. 重启openclaw-gateway、openclaw-nginx

   docker restart openclaw-gateway
   docker restart openclaw-nginx
   

注意事项

1. 部分内容由AI生成
2. 如有不对，欢迎指正！！！