OpenClaw 安装与环境配置:从零到有
如果你是个内容创作者,想用 AI 提升效率,但又担心数据安全、成本控制和定制自由度,那 OpenClaw 值得认真考虑。
开源:代码公开,社区驱动 本地部署:所有数据在自己机器上,不依赖云端 Obsidian 原生集成:Markdown + YAML frontmatter 就是你的内容数据库 技能丰富:虾评Skill 等平台有数百个现成技能可用
OpenClaw 是你能掌控的 AI 内容助手,不是黑盒 SaaS。
系统要求与准备工作
推荐环境
操作系统:WSL2(Ubuntu 22.04)或原生 Linux。macOS 也能跑,但部分权限配置有差异 Node.js:v20+ LTS 版本 内存:4GB 起步,想同时跑多个 Agent 建议 8GB 磁盘:预留 5GB 空间
快速检查
先快速检查环境是否就绪:
node --versionnpm --version如果没装 Node,按你的系统选一条:
Ubuntu/Debian:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt-get install -y nodejsHomebrew(macOS):
brew install node安装 OpenClaw 三步走
3.1 全局安装
npm install -g openclaw它会下载核心二进制文件,大约 150MB。等它跑完。
3.2 初始化工作区
openclaw initcd ~/.openclaw/workspace这会生成默认配置结构:
~/.openclaw/├── openclaw.json # 主配置├── workspace/ # 工作区(脚本、记忆文件)└── logs/ # 运行日志3.3 启动网关
openclaw gateway startopenclaw status看到 Runtime: running 说明启动成功。
配置飞书通道(可选)
如果你常用飞书,配置后可以直接在群里指挥 OpenClaw。
4.1 创建飞书应用
登录 飞书开放平台[1] 进入「应用开发」→「自建应用」 填写应用名称(如 OpenClaw Agent)在「权限管理」申请: im:message(接收/发送消息)im:chat(群组/单聊)在「基础信息」获取 App ID和App Secret
4.2 编辑配置文件
用 vim 或 nano 打开 ~/.openclaw/openclaw.json,找到 channels.feishu:
{"channels":{"feishu":{"enabled":true,"appId":"你的App ID","appSecret":"你的App Secret","connectionMode":"websocket","domain":"feishu","groupPolicy":"allowlist","groupAllowFrom":["*"]}}}注意:
groupAllowFrom: ["*"]表示接收所有群消息。如果只想让部分群可交互,填群 ID 列表connectionMode必填"websocket"JSON 格式要正确(可用 python -m json.tool校验)
4.3 重启网关
openclaw gateway restart然后 tail 日志确认没报错:
tail -f /tmp/openclaw/openclaw-*.log看到 Gateway started on port 18789 就对了。
验证安装成功
三件事:
Dashboard:浏览器打开 openclaw status里显示的地址(一般是 http://127.0.0.1:18789/)[2]飞书端测试:在任意群 @你的应用,发个「在吗」,看会不会应 健康检查: openclaw doctor跑一遍,有警告就改配置
都绿灯,安装成功。
常见问题与解决
port 18789 already in use | gateway.port 或杀掉占用进程 | |
invalid appId | appId 和 appSecret 是否复制正确 | |
groupPolicy | open 或 allowlist + groupAllowFrom: ["*"] | |
openclaw: command not found | npm install -g openclaw 重装,确认 npm 路径在 PATH 中 |
下一步
安装只是开始。接下来:
配置 IDENTITY.md、MEMORY.md,让 Agent 更有“人味”安装第一个 Skill(如 wechat-publisher),实现公众号自动发布熟悉 CLI 命令: status、gateway restart、sessions list
这些我们会在后续章节展开。
搞定这一步,你已经超过了 80% 的观望者。
引用链接
[1]飞书开放平台: https://open.feishu.cn/
[2]http://127.0.0.1:18789/): http://127.0.0.1:18789/%EF%BC%89
夜雨聆风