一、快速部署

1、执行初始化命令openclaw onboard

 

 

2、提示是否知晓风险，选择YES就行。

 

3、选择“QuickStart”简易配置模式

 

 

4、OpenClaw默认支持多平台国际大模型，该配置页面的Kimi、MiniMax、GLM需使用国际版接口。

如需接入国内大模型，拉到最底下选择跳过此步骤。

 

 

 

 

 

 

5、配置Openclaw默认使用的网络搜索功能。

 

| 需求                | 推荐选择                  |

| :---------------- | :-------------------- |

| 注重隐私、想要结构化筛选      | **Brave Search**（默认）✓ |

| 需要中文搜索/国内访问       | **Kimi**              |

| 需要 X/Twitter 实时数据 | **Grok**              |

| 习惯谷歌搜索结果          | **Gemini**            |

| 需要详细引用来源          | **Perplexity**        |

| 暂时不用搜索            | **Skip for now**      |

6、新手暂时无需添加额外技能包，选中 “No” 跳过。

 

7、设置启用记忆功能。（启用记忆功能，支持多轮对话上下文关联，避免每次聊天都需要重复说明需求）。

 

| 选项                           | 含义                                                   |

| ---------------------------- | ---------------------------------------------------- |

| **Skip for now**             | 暂时跳过，不启用任何钩子                                         |

| **�� boot-md**               | 在网关启动时自动运行 `BOOT.md` 文件。这是一个启动脚本/说明文档，通常包含初始化命令或环境设置 |

| **�� bootstrap-extra-files** | 通过 glob 模式或路径模式注入额外的工作空间引导文件。用于自动加载配置文件、脚本等到工作空间     |

| **�� command-logger**        | 命令日志记录器，会记录你在网关中执行的所有命令                              |

| **�� session-memory**        | 会话记忆功能，允许网关在会话间保留某些状态或数据                             |

 

8、选中“Do this later”完成初始化设置。

 

 

二.链接访问

1、安装完后会提示访问路径地址，默认只能本机访问。

 

开启公网访问依次输入以下命令：

1、openclaw config set gateway.bind lan     #修改配置，监听所有网络接口

2、openclaw config set gateway.controlUi '{"allowedOrigins":["http://localhost:18789","http://127.0.0.1:18789","http://公网IP:18789"],"allowInsecureAuth":true,"dangerouslyDisableDeviceAuth":true}'     #授权访问UI界面IP

3、openclaw gateway restart     #重启网关

关闭公网访问依次输入一下命令：

1、openclaw config set gateway.bind "loopback"     #修改仅本地回环，关闭公网访问

2、openclaw gateway restart    #重启网关

 

若忘记了访问token值，可在openclaw默认安装路径下的~/.openclaw/openclaw.json找回

 

 

 

三、设置模型

1.可以使用以下通用模板接入任何兼容OpenAI协议的模型：

openclaw config set 'models.providers.{provider_name}' --json '{

"baseUrl": "https://{baseurl}",

"apiKey": "",

"api": "openai-completions",

"models": [

{ "id": "{model_id}", "name": "{model_name}" }

]

}'

例：

 

 

 

openclaw config set 'models.providers.deepseek' --json '{

  "baseUrl": "https://api.deepseek.com/v1",

  "apiKey": "",

  "api": "openai-completions",

  "models": [

    { "id": "deepseek-chat", "name": "DeepSeek Chat" },

    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }

  ]

}'

2.设置 models.mode 为 merge

openclaw config set models.mode merge

设置默认模型

openclaw models set {provider_name}/{model_id}

# 示例：添加deepseek作为默认模型

openclaw models set deepseek/deepseek-chat

设置备用模型（主模型不可用时自动切换，可不设置）

openclaw models fallbacks add {provider_name}/{model_id}

# 示例：添加kimi作为备用

openclaw models fallbacks add kimi-code/kimi-for-coding

验证模型状态

openclaw models list

 

 

正常连接会显示configgured。

 

 

出现missing则模型配置异常。

 

模型连通测试

openclaw models status --probe

该命令会发送真实请求（可能产生费用），若“Status”显示“ok”，说明模型调用正常。

 

 

 

对话场景验证：

1.cli验证

openclaw agent --agent main --message "今天星期几？"

2.网页端验证

http://ip地址:18789/?token=xxxx