🦞 OpenClaw (龙虾) 小白安装完整配置手册

基于你实际走过的成功路径

📋 适用对象

  • 使用 小白快速安装教程(一键脚本)的用户
  • 不需要手动安装 Node.js、Git
  • 目标:配置 DeepSeek 模型并正常运行

第一部分:安装 OpenClaw(小白版)

步骤1:以管理员身份打开 PowerShell

  • 按  Win + X,选择  "Windows PowerShell (管理员)"

步骤2:执行一键安装命令

powershell
curl -fsSL https://openclaw.ai/install.ps1 | iex

步骤3:按照向导提示

  • 看到安全警告,输入  Yes 并按回车
  • 安装模式选择  QuickStart(快速开始)
  • 模型选择  Skip for now(后面再配置)
  • 其他选项都选默认或跳过

安装成功标志:看到绿色的 Installation complete! 字样。

第二部分:获取 DeepSeek API Key

步骤1:注册/登录 DeepSeek

  • 支持手机号、微信扫码登录

步骤2:创建 API Key

  1. 进入控制台 →  API Keys
  2. 点击  "创建 API Key"
  3. 输入名称(如 "openclaw")
  4. 立即复制保存生成的 Key(以  sk- 开头)
    ⚠️  重要:关闭窗口后就看不到了!
保存好你的 Key,格式如:sk-69732335b50c475f929aa9cbed12345

第三部分:核心配置(最关键的一步)

小白安装方式的配置文件和手动安装的路径是一样的

步骤1:找到配置文件

powershell
notepad C:\Users\lenovo\.openclaw\openclaw.json

步骤2:完全替换为以下配置

{
  "meta": {
    "lastTouchedVersion": "2026.3.8",
    "lastTouchedAt": "2026-03-11T02:42:14.751Z"
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "179d532677bc4dcaf41d95a8d3a0967e68350b5da412345"
    }
  },
  "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"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "command-logger": {
          "enabled": true
        }
      }
    }
  }
}

步骤3:修改两处关键信息

  1. apiKey:替换为你的 DeepSeek Key
json
"apiKey": "sk-69732335b50c475f929aa9cbedb7bb18"
2.token:可以保持原样,或者用你自己的

步骤4:保存文件

  • 按  Ctrl+S 保存
  • 关闭记事本

第四部分:启动与测试

步骤1:启动网关

powershell
openclaw gateway start

步骤2:查看网关状态

powershell
openclaw gateway status
期望看到
  • Runtime: running
  • RPC probe: ok

步骤3:打开网页界面

powershell
openclaw dashboard
浏览器会自动打开,或者显示一个带 Token 的链接。

步骤4:测试对话

在网页聊天框里输入:
text
你好,请介绍一下自己

或者在命令行测试

powershell
openclaw agent --agent main --message "你好,现在能正常工作了吗?"

第五部分:日常使用命令

操作
命令
启动网关
openclaw gateway start
停止网关
openclaw gateway stop
重启网关
openclaw gateway restart
查看状态
openclaw gateway status
打开网页
openclaw dashboard
查看日志
openclaw logs --follow

常见问题

Q1:网页打不开,显示"连接被拒绝"

解决:执行 openclaw gateway start 启动网关

Q2:Token 无效

解决:重新查看配置文件中的 Token
powershell
type C:\Users\lenovo\.openclaw\openclaw.json | findstr token
然后用新 Token 的链接访问。

Q3:还是报"Unknown model"

解决:检查配置文件中的 apiKey 是否正确,然后重启网关
powershell
openclaw gateway restart

Q4:API Key 在哪里获取?

解决:在 DeepSeek 开放平台 创建

最后提醒

  1. API Key 保密:不要分享给他人
  2. 网关要保持运行:关掉 PowerShell 窗口网关就会停
  3. 配置文件备份:修改前先备份
  4. DeepSeek 需要充值:Key 有效但余额不足也会失败
Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐