OpenClaw入门——OpenClaw安装
OpenClaw入门
想要快速上手OpenClaw？咱们一步步来。这个过程其实很顺畅，只要跟着下面的指示操作，很快就能让你的智能助手跑起来。
安装OpenClaw
开始之前，首要任务是确保你的基础环境已经就位。最核心的前置条件，就是Node.js版本不低于22。
怎么查看当前版本呢？打开你的命令行工具，输入下面这个简单的命令看看：
node -v
如果版本符合要求，就可以进入正式的安装环节了。这里提供了几种主流安装方式，可以根据你的使用习惯和环境来选择。
npm安装
对于大多数开发者来说，通过npm进行全局安装是最直接的方法。只需执行：
npm i -g openclaw
如果你配置了第三方npm镜像源，为了避免潜在的兼容性问题，建议在安装时临时指定官方源：
npm i -g openclaw --registry=https://registry.npmjs.org/
powershell安装
如果你是Windows用户，并且偏爱PowerShell，那么下面这条命令可以让你一键完成安装：
iwr -useb https://openclaw.ai/install.ps1 | iex
docker安装
喜欢容器化部署？Docker镜像自然少不了。拉取镜像并运行容器的命令如下：
docker pull openclaw/openclaw:latest
docker run -d --name openclaw -p 3000:3000 -v ~/.openclaw:/root/.openclaw --env-file ~/.openclaw/.env openclaw/openclaw:latest
离线安装
在网络受限的环境下，可以从源码开始构建。先克隆仓库，然后安装依赖并构建：
git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm run build
pnpm run openclaw onboard
验证安装
安装完成后，可别急着走。运行下面几个检查命令，确认一切就绪，是确保后续步骤顺利的关键。
查询OpenClaw版本号，这能最直接地确认安装是否成功：
openclaw --version
运行“医生”诊断命令，它会全面检查Node.js版本、项目依赖、配置文件状态以及网络连通性，帮你提前发现问题：
openclaw doctor
申请API-KEYS
有了工具，下一步就是为其注入“灵魂”——大模型能力。这需要获取相应的API访问密钥。目前支持多种渠道，这里以华为云和DKAPI为例。
华为云
通过华为云获取服务，主要有两种路径。
方式一：登录华为开发者空间，找到《华为开发者空间 - ModelArts Studio大模型通用代金券领取使用指导》这份案例文档。重点参照其中“二、开通MaaS平台大模型”章节的指引。完成代金券领取和模型开通后，你就能获得所需的API地址、模型名称和API Key。
方式二：同样是华为开发者空间，这次参考《华为云MaaS平台大模型Tokens领取使用指导》案例。按照“二、领取MaaS平台大模型Tokens”章节的步骤操作，领取针对DeepSeek V3系列模型的Tokens代金券，购买相应套餐包并开通服务，最终拿到访问凭证。
https://developer.huaweicloud.com/space/developerspace/tokens.html#section-3
DKAPI
对于想快速体验和测试的用户，DKAPI提供了一个更便捷的入口。它为新用户提供了额度可观的免费Tokens，可以用来体验多个主流模型，非常适合初期上手。
配置openclaw
万事俱备，只欠配置。OpenClaw提供了一个非常友好的交互式配置向导，它会手把手带你完成所有关键设置。
启动向导的命令是：
openclaw onboard
首先，系统会进行信息安全确认，这里需要选择yes来继续。
接着，向导会提供配置模式选择。初次使用，选择QuickStart模式无疑是最快的路径。
然后来到关键的一步：选择模型。如果从华为云或DKAPI获取了专属的API，这里就需要选择custom（自定义）接入点，以便填入你独有的API地址和密钥。
下一步，选择需要对接的channel（渠道或应用），比如你希望它在哪个聊天平台上运行。
最后，配置SKILLs（技能）。系统内置了多种技能模块，你可以根据需求勾选。关于更多高级技能的使用方法，后续会有详细介绍。
这里有一个需要特别注意的地方：如果选择了自定义模型，务必记得修改其上下文长度（context window）限制。许多自定义接口默认的长度较小（如4096tokens），而OpenClaw的某些功能需要至少16000tokens的长度支持，否则会报错提示“model context window too small (4096 tokens). Minimum is 16000”。
参考解决方案可以查看相关文档：OpenClaw安装后报错model context window too small (4096 tokens). Minimum is 16000。
完成以上所有步骤，配置就大功告成了！接下来，就可以开始与你专属的智能助手进行愉快对话了。
