{
  "title": "零基础安装 OpenClaw 图文教程（Windows 系统）",
  "updated_at": "2026-03-08",
  "source_page": "./openclaw.html",
  "summary": "手把手教零基础用户在 Windows 上通过 WSL2 安装 OpenClaw 可自托管个人 AI 助手，配置 Telegram 机器人、OpenRouter API，搭建自动化 AI 工作流。预计 1-2 小时完成。",
  "what_is_openclaw": "OpenClaw 是一个可自托管的个人 AI 助手，运行在用户自己的电脑上，通过 Telegram 等聊天渠道接收消息，调用执行、网页、浏览器等能力完成自动化操作。支持接入多种大模型（DeepSeek、Claude、GPT 等），数据完全留在本地。",
  "prerequisites": [
    "一台闲置 Windows 电脑",
    "Telegram 机器人 Bot Token（通过 @BotFather 创建）",
    "Telegram 用户 ID（通过 @userinfobot 或 @GetMyID_bot 获取）",
    "OpenRouter API Key（openrouter.ai 注册并充值少量余额）"
  ],
  "installation_steps": [
    {
      "step": 1,
      "title": "注册 Telegram 机器人",
      "detail": "在 Telegram 中搜索 @BotFather → 发送 /newbot → 输入机器人显示名和用户名（必须以 bot 结尾）→ 保存返回的 Token"
    },
    {
      "step": 2,
      "title": "获取 Telegram 用户 ID",
      "detail": "搜索 @userinfobot 或 @GetMyID_bot → 点击 Start → 复制返回的纯数字 ID"
    },
    {
      "step": 3,
      "title": "注册 OpenRouter 获取 API Key",
      "detail": "访问 openrouter.ai → 注册 → 创建 API Key → 充值少量余额"
    },
    {
      "step": 4,
      "title": "安装 WSL2 + Ubuntu",
      "command": "wsl --install",
      "detail": "以管理员身份运行 PowerShell，执行 wsl --install"
    },
    {
      "step": 5,
      "title": "安装 OpenClaw",
      "command": "curl -fsSL https://openclaw.ai/install.sh | bash",
      "detail": "在 Ubuntu 终端中执行安装脚本，等待几分钟"
    },
    {
      "step": 6,
      "title": "新手向导配置",
      "detail": "选择 YES 确认 → QuickStart 模式 → OpenRouter 提供商 → 粘贴 API Key → 选择 DeepSeek V3.1 → Telegram 渠道 → 输入 Bot Token → Skills 选 NO → 其他额外 Key 选 NO"
    },
    {
      "step": 7,
      "title": "开启完整权限 + 白名单",
      "detail": "openclaw dashboard 打开控制面板 → 配置 → All Settings → Raw → 将 tools profile 改为 full → 频道 → Allow From → Add 自己的 Telegram ID → Save"
    },
    {
      "step": 8,
      "title": "配置 Telegram 代理（可选）",
      "detail": "仅在 Telegram 连接不上时配置。设置 VPN 端口，执行 openclaw config set channels.telegram.proxy 命令，然后 openclaw gateway restart"
    }
  ],
  "full_permissions_config": {
    "before": { "tools": { "profile": "messaging" } },
    "after": {
      "tools": {
        "profile": "full",
        "exec": { "host": "gateway", "security": "full", "ask": "off" },
        "web": { "fetch": { "enabled": true } }
      }
    }
  },
  "common_commands": {
    "startup": {
      "openclaw gateway": "启动网关服务",
      "openclaw gateway start": "后台启动",
      "openclaw gateway stop": "停止",
      "openclaw gateway restart": "重启",
      "openclaw dashboard": "打开控制面板",
      "openclaw tui": "启动终端界面"
    },
    "config": {
      "openclaw onboard": "首次引导",
      "openclaw setup": "初始化",
      "openclaw configure": "交互式配置",
      "openclaw config get": "查看配置",
      "openclaw config set": "设置配置项",
      "openclaw config validate": "校验配置"
    },
    "channels": {
      "openclaw channels add": "添加渠道",
      "openclaw channels login": "登录渠道",
      "openclaw channels list": "查看渠道",
      "openclaw channels logout": "退出渠道"
    },
    "diagnostics": {
      "openclaw status": "查看状态",
      "openclaw health": "检查健康",
      "openclaw doctor": "诊断+修复",
      "openclaw logs": "查看日志"
    },
    "skills_and_memory": {
      "openclaw skills install <skill>": "安装技能",
      "openclaw skills list": "列出技能",
      "openclaw sessions": "历史会话",
      "openclaw memory": "搜索记忆",
      "openclaw cron add": "添加定时任务",
      "openclaw update": "更新 CLI",
      "openclaw uninstall": "完全卸载"
    }
  },
  "qas": [
    {
      "id": "faq-1",
      "question": "什么是 OpenClaw？它能做什么？",
      "answer": "OpenClaw 是可自托管的个人 AI 助手，运行在自己电脑上，通过 Telegram 接收消息，调用执行、网页、浏览器能力完成自动化。支持 DeepSeek、Claude、GPT 等多模型，数据完全本地化。"
    },
    {
      "id": "faq-2",
      "question": "安装 OpenClaw 需要什么准备？",
      "answer": "三样：一台闲置 Windows 电脑、Telegram 机器人（@BotFather 创建，获取 Token 和用户 ID）、OpenRouter API Key（充值少量余额）。"
    },
    {
      "id": "faq-3",
      "question": "Windows 上如何安装 OpenClaw？",
      "answer": "通过 WSL2：PowerShell（管理员）运行 wsl --install，Ubuntu 终端执行 curl -fsSL https://openclaw.ai/install.sh | bash，然后跟随向导配置。"
    },
    {
      "id": "faq-4",
      "question": "如何给 OpenClaw 开启完整权限？",
      "answer": "openclaw dashboard → 配置 → All Settings → Raw → tools profile 改为 full，exec.security 改为 full，exec.ask 改为 off → Save。"
    },
    {
      "id": "faq-5",
      "question": "如何设置白名单防止他人使用？",
      "answer": "控制台 → 频道 → Allow From → Add → 添加 Telegram 用户 ID（纯数字）→ Save。"
    },
    {
      "id": "faq-6",
      "question": "Telegram 连接不上怎么办？",
      "answer": "配置代理：设置 PORT 为 VPN 端口，获取宿主机 IP，执行 openclaw config set channels.telegram.proxy，然后 openclaw gateway restart。"
    }
  ]
}