准备
操作系统: macOS 12+、Linux 或 Windows 10/11
共同依赖:
安装node
Node.js v22或更高版本: https://nodejs.org/zh-cn/download
安装git
Git(用于源码拉取及部分插件安装):https://git-scm.com/book/zh/v2/%E8%B5%B7%E6%AD%A5-%E5%AE%89%E8%A3%85-Git
下面这两个是别人的推广
一个AI模型API密钥:https://platform.minimaxi.com/subscribe/coding-plan?code=IPoaV45nH2&source=link
○ 阿里云百炼(Coding Plan 新客首月7.9元):https://www.aliyun.com/benefit/ai/aistar?clubBiz=subTask..12413271..10263..
安装openclaw
openclaw官网:https://openclaw.ai/
我是按下面这个网址安装成功的
https://docs.openclaw.ai/zh-CN/install
macos/linux命令:
curl -fsSL https://openclaw.ai/install.sh | bash
windows命令(powershell管理员):
iwr -useb https://openclaw.ai/install.ps1 | iex
常用命令:
健康检查 + 安全提醒(必跑!)
openclaw doctor
查看运行状态
openclaw status
查看网关状态
openclaw gateway status
浏览器控制面板(最快上手测试)
openclaw dashboard
停止后台服务
openclaw gateway stop
启动后台服务
openclaw gateway start
重启网关
openclaw gateway restart
添加社交平台
openclaw channels add
查看实时运行日志(排查错误必看)
openclaw logs
列出当前已安装的技能
openclaw skills list
启动“新手引导”。它会带你一步步配置模型和权限。
openclaw onboard
Yes(启动 QuickStart 向导)
模型提供商(可选 OpenAI、Qwen、Minimax、Anthropic 等)——示例:选 minimax → 自动跳转至 minimax 控制台授权页面,登录后获取 API Key
权限确认:点击浏览器中 “Confirm” 按钮完成 OAuth 授权
通信渠道(飞书/ Telegram / Slack):可选 Skip for now 暂不配置
配置过程
操作:键盘上下左右键选择/回车确认/空格选中
首先是类似于用户协议的 yes即可

QiuickStart(快速开始模式)

配置模型

配置api key,一般选国内的

复制apikey,粘贴到这里

配置权限

新版本更新后权限默认是关掉的,也就是ai没有办法读写文件执行命令。解决办法是 去 ~/.openclaw/openclaw.json (如图所示)里设置: "tools": { "profile": "full" } 如图所示
有时候mac下的文件是隐藏的,这个就是
打开任意一个 访达(Finder) 窗口(比如桌面、文稿文件夹)。
按下快捷键组合:Command + Shift + .(英文句号)。
按下一次:显示所有隐藏文件(文件名以 . 开头的文件 / 文件夹,如 .openclaw)。
再按一次:重新隐藏文件。
然后重启网关 重启命令openclaw gateway restart
然后建立一个新会话

配置tg-bot
- 在 Telegram 中搜索 @BotFather
- 发送 /newbot 创建新机器人
- 获取 Bot Token
- 配置到 OpenClaw
openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"openclaw config set channels.telegram.enabled true - 在 Telegram 中搜索机器人username并开始对话
配置飞书
文档地址:https://github.com/m1heng/clawdbot-feishu?tab=readme-ov-file#%E4%B8%AD%E6%96%87
skills安装
安装clawhub,有时候安装不上,加个sudo就能安装上了。

sudo npm install -g clawhub
查看已经安装了什么插件
openclaw plugins list
1. 安装 Tavily 插件
openclaw plugins install openclaw-tavily
启动网关(默认端口18789)
openclaw gateway --port 18789
调试模式(输出详细日志)
openclaw gateway --port 18789 --verbose
强制启动(解决端口占用)
openclaw gateway --force
网关启动后终端需保持运行,关闭则服务停止。
访问 Web 控制台:http://127.0.0.1:18789。
卸载命令
命令1
openclaw uninstall --all --yes
命令2
npm uninstall -g openclaw