乐于分享
好东西不私藏

OpenClaw 安装与环境配置:从零到有

OpenClaw 安装与环境配置:从零到有

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 nodejs

Homebrew(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. 登录 飞书开放平台[1]
  2. 进入「应用开发」→「自建应用」
  3. 填写应用名称(如 OpenClaw Agent
  4. 在「权限管理」申请:
    • im:message(接收/发送消息)
    • im:chat(群组/单聊)
  5. 在「基础信息」获取 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 就对了。


验证安装成功

三件事:

  1. Dashboard:浏览器打开 openclaw status 里显示的地址(一般是 http://127.0.0.1:18789/)[2]
  2. 飞书端测试:在任意群 @你的应用,发个「在吗」,看会不会应
  3. 健康检查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 中

下一步

安装只是开始。接下来:

  1. 配置 IDENTITY.mdMEMORY.md,让 Agent 更有“人味”
  2. 安装第一个 Skill(如 wechat-publisher),实现公众号自动发布
  3. 熟悉 CLI 命令:statusgateway restartsessions list

这些我们会在后续章节展开。


搞定这一步,你已经超过了 80% 的观望者。

引用链接

[1]飞书开放平台: https://open.feishu.cn/

[2]http://127.0.0.1:18789/): http://127.0.0.1:18789/%EF%BC%89