2026全网最详细 OpenClaw 安装教程 - 从零搭建你的私人AI助手（Windows/Mac/Linux）

{
  // AI 模型配置
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "你的DeepSeek API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat (V3)",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "deepseek-reasoner",
            "name": "DeepSeek Reasoner (R1)",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },

  // 智能体配置
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    },
    "list": [
      {
        "id": "main",
        "default": true,
        "identity": {
          "name": "MyAI",
          "theme": "你是一个全能AI助手，默认中文交流。",
          "emoji": "🤖"
        },
        "tools": {
          "profile": "coding",
          "elevated": { "enabled": true }
        }
      }
    ]
  },

  // 网关配置
  "gateway": {
    "port": 18789,
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "设置一个安全的令牌"
    }
  }
}

{
  "env": {
    "GEMINI_API_KEY": "你的Gemini API Key"
  }
}

{
  "channels": {
    "telegram": {
      "botToken": "你从BotFather获取的Token",
      "dmPolicy": "allowlist",
      "allowFrom": ["tg:你的用户ID"],
      "streaming": "partial",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

"proxy": "http://127.0.0.1:7890"

"proxy": "http://127.0.0.1:10809"

"customCommands": [
  { "command": "status", "description": "查看服务运行状态" },
  { "command": "logs", "description": "查看最近的错误日志" },
  { "command": "deploy", "description": "部署最新代码" },
  { "command": "seo", "description": "SEO优化建议" }
]

"workspace": "D:/Projects/my-project"

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallbacks": ["google/gemini-2.0-flash"]
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 300
    },
    "list": [
      {
        "id": "main",
        "default": true,
        "workspace": "D:/Projects/my-project",
        "identity": {
          "name": "MainAI",
          "theme": "全能型个人AI管家。精通技术开发、网站运营、服务器管理。默认中文交流，回答简洁精准。",
          "emoji": "🤖"
        },
        "tools": {
          "profile": "coding",
          "elevated": { "enabled": true }
        }
      },
      {
        "id": "coder",
        "model": {
          "primary": "deepseek/deepseek-reasoner",
          "fallbacks": ["deepseek/deepseek-chat"]
        },
        "workspace": "D:/Projects/my-project",
        "identity": {
          "name": "CodeMaster",
          "theme": "资深全栈工程师，精通 Python/TypeScript/React。写代码追求简洁优雅，注释使用中文。",
          "emoji": "💻"
        },
        "tools": {
          "profile": "coding",
          "elevated": { "enabled": true }
        }
      },
      {
        "id": "ops",
        "workspace": "D:/Projects/my-project",
        "identity": {
          "name": "OpsGuard",
          "theme": "Linux运维专家，精通 Docker/Nginx/Redis。输出结构化运维报告，执行危险操作前必须确认。",
          "emoji": "🛡️"
        },
        "tools": {
          "profile": "coding",
          "elevated": { "enabled": true }
        }
      },
      {
        "id": "content",
        "model": {
          "primary": "google/gemini-2.0-flash",
          "fallbacks": ["deepseek/deepseek-chat"]
        },
        "workspace": "D:/Projects/my-project",
        "identity": {
          "name": "ContentPro",
          "theme": "资深内容运营专家，擅长 SEO 优化文章、社交媒体文案。中文交流。",
          "emoji": "✍️"
        },
        "tools": {
          "profile": "coding",
          "allow": ["browser"],
          "elevated": { "enabled": true }
        }
      }
    ]
  }
}

{
  // Telegram 多 Bot 配置
  "channels": {
    "telegram": {
      "defaultAccount": "default",
      "accounts": {
        "default": {
          "name": "主助手",
          "botToken": "第一个Bot的Token"
        },
        "content": {
          "name": "内容助手",
          "botToken": "第二个Bot的Token"
        }
      },
      "dmPolicy": "allowlist",
      "allowFrom": ["tg:你的用户ID"],
      "proxy": "http://127.0.0.1:7890"
    }
  },

  // 路由绑定：将不同 Bot 绑定到不同智能体
  "bindings": [
    {
      "agentId": "main",
      "match": { "channel": "telegram", "accountId": "default" }
    },
    {
      "agentId": "content",
      "match": { "channel": "telegram", "accountId": "content" }
    }
  ],

  // 会话隔离
  "session": {
    "scope": "per-sender",
    "dmScope": "per-account-channel-peer",
    "reset": {
      "mode": "idle",
      "idleMinutes": 240
    },
    "resetTriggers": ["/new", "/reset"]
  }
}

"tools": {
  "profile": "coding",
  "elevated": { "enabled": true }
}

"model": {
  "primary": "deepseek/deepseek-chat",
  "fallbacks": ["google/gemini-2.0-flash", "deepseek/deepseek-reasoner"]
}

{
  // OpenClaw 完整配置示例
  // 文件位置：~/.openclaw/openclaw.json

  // 环境变量
  "env": {
    "GEMINI_API_KEY": "你的Gemini API Key"
  },

  // AI 模型
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "你的DeepSeek API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat (V3)",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "deepseek-reasoner",
            "name": "DeepSeek Reasoner (R1)",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },

  // 智能体
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallbacks": ["google/gemini-2.0-flash"]
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 300
    },
    "list": [
      {
        "id": "main",
        "default": true,
        "workspace": "你的项目路径",
        "identity": {
          "name": "MyAI",
          "theme": "全能型AI助手，默认中文交流。",
          "emoji": "🤖"
        },
        "tools": {
          "profile": "coding",
          "elevated": { "enabled": true }
        }
      }
    ]
  },

  // Telegram 渠道
  "channels": {
    "telegram": {
      "botToken": "你的Bot Token",
      "dmPolicy": "allowlist",
      "allowFrom": ["tg:你的用户ID"],
      "streaming": "partial",
      "proxy": "http://127.0.0.1:7890"
    }
  },

  // 会话管理
  "session": {
    "scope": "per-sender",
    "reset": {
      "mode": "idle",
      "idleMinutes": 240
    },
    "resetTriggers": ["/new", "/reset"]
  },

  // 网关
  "gateway": {
    "port": 18789,
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "设置一个安全的随机令牌"
    }
  }
}

"gateway": {
  "mode": "local"
}