macos 部署 openclaw_macos. openclaw clawhub-CSDN博客
一、安装 node
node官方
1. 安装 node 虚拟环境
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
2. 配置 nvm
命令行中可以直接使用 nvm。不配置需要进入到 ~/.nvm 目录执行
# 将下面三行放入 .zshrc 中命令行可以直接使用 nvm 命令。
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 这行加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 命令补全
3. nvm 相关操作
# 查看远程可安装的 node 版本
nvm ls-remote
# 安装指定版本 node
nvm install v24.12.0
# 使用指定版本
nvm use v24.12.0
# 查看本地已安装版本
nvm ls
二、安装 openclaw
openclaw 官方
1. 使用 npm 安装 openclaw
npm install -g openclaw@latest
2. 初始化 openclaw
openclaw onboard --install-daemon
- 这里选 yes
- 然后选 QuickStart
- 这里选择模型，我选择的 OpenAI
- 这里填写 key 或者使用 open Codex。
我使用的是 Codex
- 这里会在游览器自动打开一个 openai 的登录页面，登录就行。
- 然后选择模型版本。这里我要用 0011.ai 代理就选默认了。代理稍后在配置中配置。
- 然后选择使用的聊天选件。我本地用就不选这个了。
skip for now跳过
- 然后安装 skills。这个可以后面在安装。
- 然后是安装 hooks，这里面有几个选项
选项
作用
解释
boot-md
启动时运行 BOOT.md
当 Gateway 启动且内部钩子启用时，此钩子会执行工作区根目录下的 BOOT.md 文件里的指令。
适合放一些启动时需要自动执行的任务。比如，在 BOOT.md 里写上发送一条“我上线了”的消息，或者初始化某个服务的指令。
bootstrap-extra-files
注入额外的启动文件
在 Agent 启动流程 (agent:bootstrap 事件) 中，这个钩子可以将你额外指定的文件注入到 Agent 的工作区上下文中。
适合让每次对话都自动加载一些特定文件。比如一些固定的参考文档、代码片段等，不用每次手动/load。
command-logger
记录所有指令日志
它会监听所有的命令事件，并将记录保存到 ~/.openclaw/logs/commands.log 文件中。
相当于一个操作记录员。开启后，在 OpenClaw 里执行过的所有命令都会被记录下来，方便日后排查问题或审计。
session-memory
保存会话记忆
当你执行 /new 命令开始一个新会话时，它会自动将当前会话的上下文保存到你的 Agent 工作区中。
可以让OpenClaw拥有跨会话的长期记忆。即使你开启了新对话，它也能回忆起之前聊过的重要信息，让交互更有连续性。
- 然后他会安装 gateway。等一会儿就行了，然后选择使用命令行对话还是 UI 对话。建议先用 UI 里面很多信息比较清楚。
- 完成后会自动在游览器打开 UI 页面。没打开也没事，日志里面可以看到。自己打开就行了
- 现在可以发送聊天尝试。我这里报错，是因为我要使用 0011.ai 代理。没有配。后面在
openclaw.json中配置
三、openclaw 目录结构
目录在 ~/.openclaw
.
├── agents
│ └── main
│ ├── agent
│ │ └── models.json
│ └── sessions
│ ├── faf8ec2c-238b-4aa8-88ef-7233dcbcd4e0.jsonl
│ └── sessions.json
├── canvas
│ └── index.html
├── cron
│ └── jobs.json
├── devices
│ ├── paired.json
│ └── pending.json
├── identity
│ ├── device-auth.json
│ └── device.json
├── logs
│ ├── config-audit.jsonl
│ ├── gateway.err.log
│ └── gateway.log
├── memory
│ └── main.sqlite
├── openclaw.json
├── update-check.json
└── workspace
├── AGENTS.md
├── BOOTSTRAP.md
├── HEARTBEAT.md
├── IDENTITY.md
├── SOUL.md
├── TOOLS.md
└── USER.md
路径
类型
作用
openclaw.json
主配置
OpenClaw 主配置文件，包含 gateway 端口、token、provider API、models、agents 配置
update-check.json
更新记录
记录 OpenClaw 是否检查过新版本
memory/main.sqlite
数据库
Agent 长期记忆数据库（对话、上下文、状态）
logs/gateway.log
日志
Gateway 正常运行日志
logs/gateway.err.log
日志
Gateway 错误日志
logs/config-audit.jsonl
日志
记录配置文件修改历史
workspace/
工作区
Agent 执行任务、生成代码、存放文件的目录
workspace/AGENTS.md
Prompt
定义 Agent 类型和行为
workspace/BOOTSTRAP.md
Prompt
Agent 启动时的 system prompt
workspace/HEARTBEAT.md
Prompt
Agent 心跳 / 状态更新规则
workspace/IDENTITY.md
Prompt
Agent 身份定义
workspace/SOUL.md
Prompt
Agent 行为哲学 / 规则
workspace/TOOLS.md
Prompt
Agent 可用工具说明
workspace/USER.md
Prompt
用户信息与偏好
identity/
认证
身份认证
identity/device-auth.json
认证
设备 / 客户端认证信息
identity/device.json
设备信息
记录当前设备标识
cron/
调度系统
OpenClaw 内置 cron scheduler 的配置目录
cron/jobs.json
定时任务配置
存储 OpenClaw 的 定时任务（cron jobs）
devices/
设备管理
OpenClaw 的 设备配对系统
devices/paired.json
设备列表
已经授权的设备（Dashboard / CLI / Remote）
devices/pending.json
配对队列
等待授权的设备
四、配置 openclaw。
1. openclaw.json 配置文件
{
"wizard": {
// 上次运行初始化向导的时间
"lastRunAt": "2026-03-09T01:29:44.906Z",
// 上次运行向导时的 OpenClaw 版本
"lastRunVersion": "2026.3.2",
// 最后执行的初始化命令（通常是 onboard）
"lastRunCommand": "onboard",
// 运行模式：local / cloud
"lastRunMode": "local"
},
"agents": {
"defaults": {
// Agent 的工作目录
// AI 生成文件、执行任务都会在这里
"workspace": "/Users/xxx/.openclaw/workspace",
"compaction": {
// 上下文压缩策略
// safeguard = 防止上下文爆炸
"mode": "safeguard"
},
// 同时运行的最大 agent 数
"maxConcurrent": 4,
"subagents": {
// 子 agent 最大并发数量
"maxConcurrent": 8
}
}
},
"tools": {
// 工具权限配置。这里控制模型是否有权限访问本机电脑。full 为所有权限
// messaging / standard / full
"profile": "messaging"
},
"messages": {
// 消息确认范围
// group-mentions = 只响应提及
"ackReactionScope": "group-mentions"
},
"commands": {
// 是否使用本地原生命令
"native": "auto",
// 是否自动加载 native skills
"nativeSkills": "auto",
// 命令执行失败是否自动重启
"restart": true,
// 命令执行者显示方式
// raw = 显示真实用户名
"ownerDisplay": "raw"
},
"session": {
// DM 会话范围
// per-channel-peer = 每个频道独立会话
"dmScope": "per-channel-peer"
},
"hooks": {
"internal": {
// 是否启用内部 hook 系统
"enabled": true,
"entries": {
"boot-md": {
// 启动时加载 workspace 中的 BOOTSTRAP.md
"enabled": true
},
"command-logger": {
// 记录命令执行日志
"enabled": true
},
"session-memory": {
// 启用会话记忆系统
"enabled": true
}
}
}
},
"gateway": {
// OpenClaw Web Dashboard 端口
"port": 18789,
// gateway 运行模式
// local = 仅本地访问
"mode": "local",
// 监听地址
// loopback = 127.0.0.1
"bind": "loopback",
"auth": {
// 认证方式
// token / none
"mode": "token",
// Dashboard 登录 token
"token": "372ec8cbcfe557ee947ec76bccd63f33022bb673c282de48"
},
"tailscale": {
// 是否启用 Tailscale 远程访问
"mode": "off",
// 程序退出时是否重置网络
"resetOnExit": false
},
"nodes": {
// 禁止 AI 执行的系统命令
"denyCommands": [
"camera.snap",
"camera.clip",
"screen.record",
"contacts.add",
"calendar.add",
"reminders.add",
"sms.send"
]
}
},
"models": {
// provider 合并模式
// merge = 合并多个 provider
"mode": "merge",
"providers": {
"anthropic": {
// API 代理地址
"baseUrl": "https://aicoding.2233.ai",
// API Key
"apiKey": "sk-c4pBAcG",
// API 类型
// anthropic-messages = Claude Messages API
"api": "anthropic-messages",
"models": [
{
// 模型 ID
"id": "claude-opus-4",
// 模型显示名称
"name": "claude-opus-4"
}
]
}
}
},
"auth": {
"profiles": {
"anthropic:default": {
// 使用哪个 provider
"provider": "anthropic",
// 认证模式
// api_key / oauth
"mode": "api_key"
}
}
},
channels: {
// 根据聊天平台 + 频道 ID 自动选择模型
modelByChannel: {
discord: {
// Discord 频道 ID
// 如果用户在这个频道聊天
// OpenClaw 会使用 Claude Opus
"123456789012345678": "anthropic/claude-opus-4-6",
},
slack: {
// Slack channel ID
// 在这个频道里聊天会使用 GPT-4.1
C1234567890: "openai/gpt-4.1",
},
telegram: {
// Telegram 群 ID
// 所有消息默认使用 GPT-4.1 mini
"-1001234567890": "openai/gpt-4.1-mini",
// Telegram topic (论坛模式)
// 格式：
// group_id:topic:topic_id
//
// 在 topic 99 里使用 Claude Sonnet
"-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
},
},
},
"meta": {
// 最后修改配置的 OpenClaw 版本
"lastTouchedVersion": "2026.3.2",
// 最后修改时间
"lastTouchedAt": "2026-03-09T01:29:44.914Z"
}
}
2. 常用配置
配置
作用
gateway.port
Dashboard 端口
gateway.auth.token
登录 token
models.providers
AI 模型提供商
agents.defaults.workspace
Agent 工作目录
tools.profile
模型权限，full 系统所有权限
五、安装 skill
ClawHub 是 OpenClaw 生态里的 插件 / 模块仓库管理工具。
1. 安装 clawhub
npm install -g clawhub
2. 常用参数和用法
命令
作用
示例
clawhub search
搜索模块
clawhub search discord
clawhub install
安装模块
clawhub install discord
clawhub remove
删除模块
clawhub remove discord
clawhub list
查看已安装模块
clawhub list
clawhub info
查看模块信息
clawhub info discord
clawhub update
更新模块
clawhub update discord
clawhub upgrade
更新所有模块
clawhub upgrade
clawhub enable
启用模块
clawhub enable discord
clawhub disable
禁用模块
clawhub disable discord
clawhub doctor
检查模块问题
clawhub doctor
clawhub repo add
添加仓库
clawhub repo add <url>
clawhub repo list
查看仓库
clawhub repo list
clawhub repo remove
删除仓库
clawhub repo remove <url>
六、openclaw 常用命令
1. 基础命令
命令
作用
示例
openclaw
显示帮助
openclaw
openclaw version
查看版本
openclaw version
openclaw help
查看帮助
openclaw help
openclaw status
查看运行状态
openclaw status
2. 初始化
命令
作用
示例
openclaw onboard --install-daemon
完整安装向导和安装系统服务
openclaw onboard --install-daemon
openclaw onboard
安装向导
openclaw onboard
openclaw start
启动 gateway + agent
openclaw start
openclaw stop
停止 OpenClaw
openclaw stop
openclaw restart
重启服务
openclaw restart
3. 日志
命令
作用
示例
openclaw logs
查看日志
openclaw logs
openclaw logs --follow
实时日志
openclaw logs --follow
openclaw logs --errors
只看错误日志
openclaw logs --errors
4. 模型 管理
命令
作用
示例
openclaw models list
查看可用模型
openclaw models list
openclaw models auth login
登录模型 provider
openclaw models auth login
openclaw models auth logout
退出登录
openclaw models auth logout
openclaw models test
测试模型连接
openclaw models test
5. 系统 插件
命令
作用
示例
openclaw plugins list
查看插件
openclaw plugins list
openclaw plugins install
安装插件
openclaw plugins install discord
openclaw plugins remove
删除插件
openclaw plugins remove discord
openclaw plugins update
更新插件
openclaw plugins update
6. Agent 管理
命令
作用
示例
openclaw agents list
查看 agent
openclaw agents list
openclaw agents add
添加 agent
openclaw agents add coder
openclaw agents remove
删除 agent
openclaw agents remove coder
openclaw agents restart
重启 agent
openclaw agents restart
7. 设备管理
命令
作用
示例
openclaw devices list
查看已配对设备
openclaw devices list
openclaw devices approve
批准设备
openclaw devices approve
openclaw devices remove
移除设备
openclaw devices remove
8. 配置管理
命令
作用
示例
openclaw config show
查看配置
openclaw config show
openclaw config edit
编辑配置
openclaw config edit
openclaw config reset
重置配置
openclaw config reset
9. 调试 / 诊断
命令
作用
示例
openclaw doctor
检查系统问题
openclaw doctor
openclaw debug
调试模式
openclaw debug
openclaw env
查看环境信息
openclaw env
10. 开发工具
命令
作用
示例
openclaw run
运行 agent 任务
openclaw run
openclaw exec
执行命令
openclaw exec
openclaw shell
打开 agent shell
openclaw shell
11. 更新
命令
作用
示例
openclaw update
更新 OpenClaw
openclaw update
openclaw upgrade
升级组件
openclaw upgrade
原网址: 访问
创建于: 2026-03-19 14:06:44
目录: default
标签: 无
未标明原创文章均为采集，版权归作者所有，转载无需和我联系，请注明原出处，南摩阿彌陀佛，知识，不只知道，要得到
最新评论