数字化技能提升教程，数字化时代生存宝典

首页 / 数字化 / 人工智能 / OpenClaw教程

OpenClaw配置指南

浏览：79
OpenClaw
OpenClaw
类型：人工智能

OpenClaw（曾用名：Clawdbot、Moltbot），一款可以部署在个人电脑上的AI代理，采用“龙虾”图标设计，核心开发语言为TypeScript。如果你想快速上手OpenClaw却不知从何开始，本系列教程就是你的一站式指南！站长百科会手把手拆解OpenClaw安装的前置条件、OpenClaw安装部署的关键步骤，以及OpenClaw使用个性化配置与平台对接技巧，让你从配置到实操，每一步都清晰易懂。

OpenClaw小龙虾交流群：1087382156

百科词条 访问网站

对于正在使用本地AI、折腾OpenClaw的用户而言，掌握核心配置命令是高效使用OpenClaw的基础。无论是刚完成安装、环境崩溃需要重置，还是配置模型、工作空间等核心功能，都离不开基础配置操作。本节将带大家快速配置OpenClaw，适配本地AI各类使用场景。

一、初始化OpenClaw

该命令主要用于两种场景：一是刚刚安装完OpenClaw，需要完成初始配置；二是软件环境出现故障、无法恢复时，用于重置OpenClaw至初始状态。

openclaw onboard

二、配置OpenClaw

该命令是核心配置入口，可配置工作空间、模型厂商、web工具、网关、通道、技能、健康检查等所有核心功能，大部分手动配置操作在此处进行效率更高。

openclaw config

OpenClaw配置

1、Workspace-工作空间配置

选择Workspace选项，可修改OpenClaw的工作空间路径。默认情况下，OpenClaw会安装在Windows系统C盘的用户目录下（路径：.openclaw/wordspace），不更改也可正常使用。但如果长期使用、技能和数据较多，工作空间会逐渐变大，建议修改路径至文档目录，方便后续数据迁移和管理。

Workspace

2、Model-配置模型

Model

配置大模型的操作非常简单，只需前往对应大模型厂商购买Token，将Token填入对应配置项即可。

Coding Plan汇总看这篇：《Agent开发者省钱指南：国内AI Coding Plan对比》

核心配置步骤（重点）

在终端执行以下命令，打开Web UI：

openclaw dashboard
  • 在Web UI左侧菜单栏中，依次选择「配置」>「All Settings」>「RAW」。

    将以下JSON内容复制到「Raw JSONS」输入框，替换原有内容；

  • 若需保留已有配置，请勿直接全量替换，需在原有配置文件中找到models、agents和gateway字段，将Coding Plan的配置信息粘贴到对应字段下；
  • 将JSON中的「YOUR_API_KEY」替换为你购买的阿里云百炼Coding Plan专属API Key。

{ "meta": { "lastTouchedVersion": "2026.3.2", "lastTouchedAt": "2026-03-03T07:28:22.400Z" }, "models": { "mode": "merge", "providers": { "bailian": { "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "apiKey": "YOUR_API_KEY", "api": "openai-completions", "models": [ { "id": "qwen3.5-plus", "name": "qwen3.5-plus", "api": "openai-completions", "reasoning": false, "input": [ "text", "image" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 1000000, "maxTokens": 65536 }, { "id": "qwen3-max-2026-01-23", "name": "qwen3-max-2026-01-23", "api": "openai-completions", "reasoning": false, "input": [ "text" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 262144, "maxTokens": 65536 }, { "id": "qwen3-coder-next", "name": "qwen3-coder-next", "api": "openai-completions", "reasoning": false, "input": [ "text" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 262144, "maxTokens": 65536 }, { "id": "qwen3-coder-plus", "name": "qwen3-coder-plus", "api": "openai-completions", "reasoning": false, "input": [ "text" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 1000000, "maxTokens": 65536 }, { "id": "MiniMax-M2.5", "name": "MiniMax-M2.5", "api": "openai-completions", "reasoning": false, "input": [ "text" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 131072 }, { "id": "glm-5", "name": "glm-5", "api": "openai-completions", "reasoning": false, "input": [ "text" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 202752, "maxTokens": 16384 }, { "id": "glm-4.7", "name": "glm-4.7", "api": "openai-completions", "reasoning": false, "input": [ "text" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 202752, "maxTokens": 16384 }, { "id": "kimi-k2.5", "name": "kimi-k2.5", "api": "openai-completions", "reasoning": false, "input": [ "text", "image" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 262144, "maxTokens": 32768 } ] } } }, "agents": { "defaults": { "model": { "primary": "bailian/qwen3.5-plus" }, "models": { "bailian/qwen3.5-plus": {}, "bailian/qwen3-max-2026-01-23": {}, "bailian/qwen3-coder-next": {}, "bailian/qwen3-coder-plus": {}, "bailian/MiniMax-M2.5": {}, "bailian/glm-5": {}, "bailian/glm-4.7": {}, "bailian/kimi-k2.5": {} }, "compaction": { "mode": "safeguard" } } }, "commands": { "native": "auto", "nativeSkills": "auto", "restart": true, "ownerDisplay": "raw" }, "gateway": { "mode": "local", "auth": { "mode": "token", "token": "__OPENCLAW_REDACTED__" } } }

单击右上角「Save」保存配置，然后单击「Update」使配置生效。

保存成功后，apiKey将显示为“OPENCLAW_REDACTED”，这是正常的脱敏保护，仅用于前端界面隐藏，不影响实际调用。

apiKey

温馨提示：对于新手小白而言，配置大模型可能存在一定难度，不同厂商的配置Url和复杂程度有所差异。如果无法完成大模型配置，可私信咨询，协助完成配置。

注意：OpenClaw使用过程中会消耗大量Token，若按Token计费，短短几轮对话就可能产生较高成本，建议优先选择包月套餐，且优先选择按次对话计费的套餐，性价比更高。

网页搜索是很多用户使用OpenClaw的核心需求之一，实现该功能的前提是拥有Brave Search API。配置Brave Search API key后，可轻松实现OpenClaw网页搜索功能；若没有API key，也可通过浏览器插件完成网页搜索。

网页搜索

注意：若在国内使用Brave Search，配置API key后必须开启代理，否则无法正常访问Brave Search服务。

Brave Search

4、Gateway-网关配置

若没有特殊需求，不建议随意修改网关配置。网关主要用于配置访问端口、是否支持IP访问、映射到公网等高级功能，属于进阶操作，本章暂不详细概述。

5、Daemon-服务管理

主要用于对网关服务进行管理，包括重启、安装、跳过等基础操作，操作简单，无需额外复杂配置。

6、Channel-配置通道

主流APP链接OpenClaw的教程篇幅较长，将在后续篇章单独讲解，本章暂不概述。

Skills-技能安装

7、Skills-技能安装

参考：《OpenClaw常用Skill分享及安装教程》

三、修复OpenClaw

当修改配置错误导致网关无法启动时，可使用以下命令尝试自我修复，或查看具体报错信息，便于排查问题。

openclaw doctor --fix

四、卸载OpenClaw

若本地环境混乱，需要彻底卸载OpenClaw，可使用以下命令完成卸载。

openclaw uninstall

五、OpenClaw常用指令汇总

1、网关管理

openclaw gateway status # 查看网关状态 openclaw gateway start # 启动网关 openclaw gateway stop # 停止网关 openclaw gateway restart # 重启网关

2、帮助与信息

openclaw help # 查看所有命令 openclaw gateway --help # 网关命令帮助 openclaw status # 查看系统状态

3、模型管理（会话窗口）

/model <provider/model> # 切换模型 /models # 浏览所有提供商 /models <provider> # 查看某提供商的模型 /model status # 查看当前模型状态

4、会话管理（会话窗口）

/reasoning # 切换推理模式 /status # 查看会话状态（用量/时间/成本）

5、其他实用命令

openclaw version # 查看版本

更多命令：《OpenClaw命令大全》

广告合作

广告合作

QQ群号：4114653

QQ群号：4114653

温馨提示：

  1. 本网站发布的内容(图片、视频和文字)以原创、转载和分享网络内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。邮箱：2942802716#qq.com（#改为@）。
  2. 本站原创内容未经允许不得转裁，转载请注明出处“站长百科”和原文地址。
OpenClaw
上一篇OpenClaw添加模型 下一篇OpenClaw常见问题