AI创想

标题: macos 部署 openclaw [打印本页]
作者: AI小编    时间: 前天 07:53
标题: macos 部署 openclaw
作者：CSDN博客
一、安装 node

node官方
1. 安装 node 虚拟环境
  1. curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
复制代码
2. 配置 nvm

命令行中可以直接使用 nvm。不配置需要进入到 ~/.nvm 目录执行
  1. # 将下面三行放入 .zshrc 中命令行可以直接使用 nvm 命令。
  2. export NVM_DIR="$HOME/.nvm"
  3. [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 这行加载 nvm
  4. [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 命令补全
复制代码
3. nvm 相关操作
  1. # 查看远程可安装的 node 版本
  2. nvm ls-remote
复制代码
  1. # 安装指定版本 node
  2. nvm install v24.12.0
复制代码
  1. # 使用指定版本
  2. nvm use v24.12.0
复制代码
  1. # 查看本地已安装版本
  2. nvm ls
复制代码
二、安装 openclaw

openclaw 官方
1. 使用 npm 安装 openclaw
  1. npm install -g openclaw@latest
复制代码
2. 初始化 openclaw
  1. openclaw onboard --install-daemon
复制代码
选项作用解释
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拥有跨会话的长期记忆。即使你开启了新对话，它也能回忆起之前聊过的重要信息，让交互更有连续性。

三、openclaw 目录结构

目录在 ~/.openclaw
  1. .
  2. ├── agents
  3. │   └── main
  4. │       ├── agent
  5. │       │   └── models.json
  6. │       └── sessions
  7. │           ├── faf8ec2c-238b-4aa8-88ef-7233dcbcd4e0.jsonl
  8. │           └── sessions.json
  9. ├── canvas
  10. │   └── index.html
  11. ├── cron
  12. │   └── jobs.json
  13. ├── devices
  14. │   ├── paired.json
  15. │   └── pending.json
  16. ├── identity
  17. │   ├── device-auth.json
  18. │   └── device.json
  19. ├── logs
  20. │   ├── config-audit.jsonl
  21. │   ├── gateway.err.log
  22. │   └── gateway.log
  23. ├── memory
  24. │   └── main.sqlite
  25. ├── openclaw.json
  26. ├── update-check.json
  27. └── workspace
  28.     ├── AGENTS.md
  29.     ├── BOOTSTRAP.md
  30.     ├── HEARTBEAT.md
  31.     ├── IDENTITY.md
  32.     ├── SOUL.md
  33.     ├── TOOLS.md
  34.     └── 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.mdPrompt定义 Agent 类型和行为
workspace/BOOTSTRAP.mdPromptAgent 启动时的 system prompt
workspace/HEARTBEAT.mdPromptAgent 心跳 / 状态更新规则
workspace/IDENTITY.mdPromptAgent 身份定义
workspace/SOUL.mdPromptAgent 行为哲学 / 规则
workspace/TOOLS.mdPromptAgent 可用工具说明
workspace/USER.mdPrompt用户信息与偏好
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 配置文件
  1. {"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.1C1234567890:"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.portDashboard 端口
gateway.auth.token登录 token
models.providersAI 模型提供商
agents.defaults.workspaceAgent 工作目录
tools.profile模型权限，full 系统所有权限
五、安装 skill

ClawHub 是 OpenClaw 生态里的 插件 / 模块仓库管理工具。
1. 安装 clawhub
  1. 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 + agentopenclaw start
openclaw stop停止 OpenClawopenclaw 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登录模型 provideropenclaw 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查看 agentopenclaw agents list
openclaw agents add添加 agentopenclaw agents add coder
openclaw agents remove删除 agentopenclaw agents remove coder
openclaw agents restart重启 agentopenclaw 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 shellopenclaw shell
11. 更新

命令作用示例
openclaw update更新 OpenClawopenclaw update
openclaw upgrade升级组件openclaw upgrade

原文地址：https://blog.csdn.net/weixin_43729266/article/details/158837298



欢迎光临 AI创想 (https://llms-ai.com/) Powered by Discuz! X3.4