Windows10 安装 OpenClaw 常用命令速查表

QQ_1787492092805.png

启用 TLS 1.3 的操作步骤

你可以通过以下两种方法之一来完成:

方法一:使用注册表文件(推荐,最简单)

  1. 打开记事本,将以下内容复制并粘贴进去:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.3\Client]
"DisabledByDefault"=dword:00000000
"Enabled"=dword:00000001
  1. 将文件保存为 EnableTLS13.reg(注意扩展名是 .reg)。

  2. 双击运行这个 .reg 文件,并在系统提示时选择“是”以确认导入。

  3. 重启你的电脑,使更改生效。

方法二:手动修改注册表

  1. 按下Win + R键,输入

    regedit

    并回车,打开注册表编辑器。

  2. 在左侧导航栏中,依次展开到以下路径。如果路径中某些项不存在,请手动右键新建“项”来创建它们:

    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.3\Client
  3. 在右侧的空白区域,右键选择 新建 -> DWORD (32位) 值

    • 创建

      DisabledByDefault

      ,并确保其数值数据为 0

    • 创建

      Enabled

      ,并确保其数值数据为 1

  4. 确认修改无误后,关闭注册表编辑器并重启电脑。

OpenClaw 常用命令速查表

以下是在 Windows 10 LTSC 环境下安装和配置 OpenClaw 后,最终确认可用的命令合集,按用途分类整理。


一、启动与运行

启动 OpenClaw(最常用)

powershell -ExecutionPolicy Bypass -Command "openclaw"

直接启动(若已修改执行策略)

openclaw

二、Gateway 管理

重启 Gateway

powershell -ExecutionPolicy Bypass -Command "openclaw gateway restart"

启动 Gateway

powershell -ExecutionPolicy Bypass -Command "openclaw gateway start"

停止 Gateway

powershell -ExecutionPolicy Bypass -Command "openclaw gateway stop"

查看 Gateway 状态

powershell -ExecutionPolicy Bypass -Command "openclaw gateway status"

查看 Gateway 调试日志

powershell -ExecutionPolicy Bypass -Command "openclaw gateway --log-level debug"

三、配置与诊断

以下命令在 OpenClaw 界面(Crestodian 会话中)直接输入:

运行诊断

doctor

验证配置

validate config

查看整体状态

status

health

退出当前会话

/exit

或按 Ctrl+C


四、配置文件相关

以下命令在 PowerShell 中执行:

自动修复配置文件

powershell -ExecutionPolicy Bypass -Command "openclaw doctor --fix"

验证配置文件格式

powershell -ExecutionPolicy Bypass -Command "openclaw config validate"

配置文件路径

C:\Users\yinzeyi\.openclaw\openclaw.json

五、环境变量配置(硅基流动)

变量名:

OPENAI_API_KEY


变量值:

sk-xxxxxxxxxxxxxxxx

(你的硅基流动 API 密钥)


用途:硅基流动 API 密钥


变量名:

OPENAI_BASE_URL


变量值:

https://api.siliconflow.cn/v1


用途:硅基流动 API 地址

设置方法:Win + R →

sysdm.cpl

→ 高级 → 环境变量 → 用户变量 → 新建



六、日后维护

更新 OpenClaw

powershell -ExecutionPolicy Bypass -Command "npm update -g openclaw"

查看已安装版本

powershell -ExecutionPolicy Bypass -Command "openclaw --version"

切换或添加新模型

直接在环境变量中修改

OPENAI_API_KEY

OPENAI_BASE_URL

,然后重启 Gateway + OpenClaw。


查看详细日志排查问题

powershell -ExecutionPolicy Bypass -Command "openclaw --log-level debug"

📌 今日排错小结

  1. TLS 1.3 启用:已通过注册表开启(路径:HKEY_LOCAL_MACHINE\...\SCHANNEL\Protocols\TLS 1.3\Client)

  2. Node.js 安装:手动从官网下载安装

  3. 执行策略问题:用

    -ExecutionPolicy Bypass

    绕过,或永久设置

    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  4. 模型配置:用环境变量代替配置文件,避开 JSON 格式风险

  5. 配置文件损坏:用

    openclaw doctor --fix

    修复

📌 openclaw.json配置文件

{
  "agents": {                                    // 智能体配置
    "defaults": {                                // 默认配置(所有智能体继承)
      "workspace": "C:\\Users\\yinzeyi\\.openclaw\\workspace",  // 工作目录:智能体的家
      "models": {                                // 模型允许列表(只有列出来的模型才能用)
        "teamorouter/deepseek-v4-flash-free": {},  // 免费模型:teamorouter 中转站
        "siliconflow/deepseek-ai/DeepSeek-V4-Flash": {},  // 硅基流动的 DeepSeek V4 Flash
        "deepseek/deepseek-v4-flash": {},        // DeepSeek 官网 Flash
        "deepseek/deepseek-v4-pro": {}           // DeepSeek 官网 Pro(更强)
      },
      "model": {                                 // 默认模型设置
        "primary": "teamorouter/deepseek-v4-flash-free",  // 主模型:优先用免费版,省钱
        "fallbacks": [                           // 回退链:主模型挂了才用
          "siliconflow/deepseek-ai/DeepSeek-V4-Flash"  // 一级回退:硅基流动
        ]
      }
    }
  },
  "gateway": {                                   // 网关配置(OpenClaw 核心服务)
    "mode": "local",                             // 运行模式:本地
    "auth": {                                    // 认证设置
      "mode": "token",                           // 认证方式:Token
      "token": "eaf4***355d7"  // 访问令牌(相当于密码,这里用*模糊了)
    },
    "port": 18789,                               // 网关端口
    "bind": "loopback",                          // 只监听本机(安全,不对外网)
    "tailscale": {                               // Tailscale 组网设置
      "mode": "off",                             // 关闭
      "resetOnExit": false                       // 退出时不重置
    },
    "controlUi": {                               // 控制台网页设置
      "allowInsecureAuth": true                  // 允许本地网页用简单认证
    },
    "nodes": {                                   // 节点权限(手机/电脑上的 OpenClaw 客户端)
      "denyCommands": [                          // 禁止执行的命令列表(隐私保护)
        "camera.snap",                           // 禁止拍照
        "camera.clip",                           // 禁止录像
        "screen.record",                         // 禁止录屏
        "contacts.add",                          // 禁止添加联系人
        "calendar.add",                          // 禁止加日历事件
        "reminders.add",                         // 禁止加提醒
        "sms.send",                              // 禁止发短信
        "sms.search"                             // 禁止查短信
      ]
    }
  },
  "session": {                                   // 会话设置
    "dmScope": "per-channel-peer"                // 私聊按人隔离(不同人看不到彼此对话)
  },
  "tools": {                                     // 工具配置
    "profile": "coding"                          // 工具预设:编程相关工具
  },
  "wizard": {                                    // 安装向导记录(不用管)
    "securityAcknowledgedAt": "2026-08-23T12:09:15.123Z",  // 安全须知确认时间
    "lastRunAt": "2026-08-23T12:09:15.144Z",     // 上次运行时间
    "lastRunVersion": "2026.7.1-2",              // 上次运行的版本号
    "lastRunCommand": "onboard",                 // 上次运行的命令
    "lastRunMode": "local"                       // 上次运行模式
  },
  "meta": {                                      // 元信息(不用管)
    "lastTouchedVersion": "2026.7.1-2",          // 最后修改的版本
    "lastTouchedAt": "2026-08-23T12:09:15.175Z"  // 最后修改时间
  },
  "models": {                                    // 模型提供商配置
    "providers": {                               // 各模型服务商
      "teamorouter": {                           // 服务商①:teamorouter(免费中转)
        "baseUrl": "https://api.teamorouter.com/v1",  // API 地址
        "apiKey": "sk-teamo-***",  // 密钥
        "api": "openai-completions",             // 接口格式:OpenAI 兼容
        "models": [                              // 该服务商提供的模型
          { "id": "deepseek-v4-flash-free", "name": "TR DeepSeek-V4-Flash-Free" }  // 免费 Flash
        ]
      },
      "siliconflow": {                           // 服务商②:硅基流动
        "baseUrl": "https://api.siliconflow.cn/v1",  // API 地址
        "api": "openai-completions",             // 接口格式:OpenAI 兼容
        "apiKey": "sk-***",  // 密钥
        "models": [                              // 该服务商提供的模型
          { "id": "deepseek-ai/DeepSeek-V4-Flash", "name": "SF DeepSeek-V4-Flash" }  // 硅基流动 Flash
        ]
      },
      "deepseek": {                              // 服务商③:DeepSeek 官网
        "baseUrl": "https://api.deepseek.com",   // API 地址
        "api": "openai-completions",             // 接口格式:OpenAI 兼容
        "apiKey": "***",                        // 密钥(去 platform.deepseek.com 拿)
        "models": [                              // 该服务商提供的模型
          { "id": "deepseek-v4-flash", "name": "DeepSeek-V4-Flash" },  // 官网 Flash
          { "id": "deepseek-v4-pro", "name": "DeepSeek-V4-Pro" }       // 官网 Pro
        ]
      }
    }
  }
}


发表评论

访客

看不清,换一张

◎欢迎参与讨论,请在这里发表您的看法和观点。