【OpenClaw】配置指南:从零搭建你的AI工作环境

昨天我们聊了OpenClaw是什么——一个能跑在你电脑上、帮你干各种活的开源AI助手平台。今天直接进入实操环节：怎么把它从零装好、配好，让它真正开始为你干活。

一条命令装起来

OpenClaw的安装出奇简单。不管你是Mac、Linux还是Windows，本质上就是一条命令。

Mac或Linux用户打开终端：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows用户打开PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

前提是你电脑上得先有Node.js——24版最佳，22.19以上也行。Windows用户推荐用WSL2，稳定性更强。装完后跑一遍 openclaw onboard –install-daemon，引导向导会带你选模型、填API Key、配好基础设置，大概两分钟搞定。

装好之后，用 openclaw gateway status 确认网关跑起来了，浏览器打开 http://127.0.0.1:18789 看到控制面板——恭喜，你的AI助手已经就位了。

配置文件：一张地图管全局

OpenClaw的行为由 ~/.openclaw/openclaw.json 这一个文件控制。它用的是JSON5格式，比标准JSON友好——支持写注释、尾部逗号也不报错，新手编辑不容易手滑。

配置文件的顶层大致分这几块：

agents：AI助手的身份、工作区、记忆系统、模型选择

channels：对接微信、公众号、Telegram、Discord、WhatsApp等聊天平台

providers：模型厂商的API Key和地址配置

cron：定时任务，让AI自动执行预设工作

tools：工具权限控制，哪些命令可以直接跑、哪些需要确认

你不用一次性全搞懂。新手最常见的操作无非就三样：加一个微信通道、指定默认模型、设个工作目录。这三个配好，日常使用就够了。

比如连微信公众号，配置块长这样：

{          “channels”: {          “wechat-mp”: {          “appId”: “wx开头的ID”,          “appSecret”: “你的密钥”,          “token”: “你设的Token”          }          }          }

注意各通道的 allowFrom 和 groupPolicy 其实很重要——它决定了谁能跟你的AI说话。默认策略是陌生人来消息需要配对码确认，防止被骚扰和滥用API额度。

新手最常踩的三个坑

坑1：配置文件格式。 JSON5虽然允许注释，但键名必须用双引号，字符串值也得双引号。手写的时候多打少打一个引号，网关直接拒绝启动。建议每次改完配置跑一下 openclaw config validate，省得排查半天发现是个语法错误。

坑2：API Key放错地方。 很多人以为API Key写在配置文件里某个叫 models 的字段下，其实键名是 providers。比如接Anthropic的Claude应该这样写：

{          “providers”: {          “anthropic”: {          “apiKey”: “sk-ant-xxxxx”          }          }          }

坑3：通道不生效。 配了微信通道，重启网关后还是收不到消息——多半是因为通道配置写好了但网关没正确重启，或者 allowFrom 列表里没加自己的微信号。建议用 openclaw gateway restart 确保完整重启，然后在后台日志里确认通道已注册成功。

改配置不用重启

一个特别方便的特性：OpenClaw支持热加载。你直接编辑 openclaw.json 保存，网关会自动检测到文件变化并应用新配置，完全不用手动重启。

日常管理配置除了直接改文件，还有三种姿势：openclaw configure 打开配置向导点点点；openclaw config set agents.defaults.model “xxx” 命令行一键修改；或者浏览器打开控制面板的Config标签，表单界面直观操作。四种方式随便选，效果一样。

总结

OpenClaw的配置设计挺有意思：它追求的是一份文件管所有，但每个模块的默认值又足够聪明，让你可以渐进式学习。第一天你只需要装好、连上一个通道、发条消息。第二天配好定时任务，让AI早上自动给你推新闻。第三天装上技能，让它学会写文档、画图、搜网页。

从零搭建这件事，最难的不是技术，是开始。装好了就先用起来，哪里不够再回来调配置。下一篇我们聊技能系统——那是OpenClaw真正拉开差距的地方，让AI从”会聊天”变成”会干事”。