前提说明
系统：windows
环境：安装nodejs（安装自己查，安装v24版本的）

1.安装后打开命令行输入：

npm install -g openclaw@latest

（安装检查是否安装成功，使用命令）

openclaw--version

或者打开powershell（我自己用这个方法）

iwr -useb https://openclaw.ai/install.ps1 | iex

安装成功显示如下（有大logo）：

2.配置程序：
运行命令：

openclaw onboard

• 向导会引导你完成:

1. 1. AI 模型配置 – 输入 API Key

1. 1. 工作目录设置 – 默认 ~/openclaw

1. 1. 渠道启用 – 选择要连接的聊天平台（看情况安装，新手最好先跳过 ）

1. 1. 守护进程安装 – 让 Gateway 后台持续运行

配置openclaw文件执行权限（读写）（2026.03.02）

OpenClaw 默认情况下工具权限非常受限。你的配置中只有 web.search，没有启用文件系统工具（read, write, edit 等），所以 Agent 无法执行文件操作。

# 设置全局工具 profile 为 coding（包含 group:fs 文件操作组）
openclaw config set tools.profile "coding"
 
# 或者设置为 full（无限制，适合本地开发）
openclaw config set tools.profile "full"

Profile 说明：

minimal：仅 session_status（你的当前状态可能接近这个）

coding：包含 group:fs（read/write/edit/apply_patch）、group:runtime（exec/process）、group:sessions 等

messaging：仅消息相关工具

full：无限制，所有工具可用

我用的full模式。

打开网页程序：

openclaw dashboard

或者

openclaw gateway

然后在浏览器输入：127.0.0.1:18789

开始聊天

附：操作文档位置

打开命令行终端对话模式（TUI）:

部分用户可能存在网页UI打不开的情况，先试试TUI能不能用

openclaw tui

官网

https://openclaw.ai/

安装官方教程：

https://docs.openclaw.ai/zh-CN/install

当发生一些意外的Bug时，请打开powershell，尝试使用修复命令：

openclaw doctor --fix

自定义大模型API参考
https://mp.csdn.net/mp_blog/creation/editor/157542782

20260309 大坑（2026.03.07版本编译有问题，慎用）

点击web ui上的update，给我openclaw删了，尼玛

当安装报错如下时，我用的是2G内存的服务器

root@iv-yefekgokxs5i3z2zeyx2 ~]# npm i -g openclaw
⠇Killed
[root@iv-yefekgokxs5i3z2zeyx2 ~]# npm i -g openclaw
⠧Killed
[root@iv-yefekgokxs5i3z2zeyx2 ~]# curl -fsSL https://openclaw.ai/install.sh | bash

  🦞 OpenClaw Installer
  Because Siri wasn't answering at 3AM.

✓ Detected: linux

Install plan
OS: linux
Install method: npm
Requested version: latest

[1/3] Preparing environment
✓ Node.js v24.14.0 found
· Active Node.js: v24.14.0 (/root/.nvm/versions/node/v24.14.0/bin/node)
· Active npm: 11.9.0 (/root/.nvm/versions/node/v24.14.0/bin/npm)

[2/3] Installing OpenClaw
✓ Git already installed
· Installing OpenClaw v2026.3.7
main: line 638: 247670 Killed                  "${cmd[@]}" > "$log" 2>&1
! npm install failed for openclaw@latest
  Command: env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm --loglevel error --silent --no-fund --no-audit install -g openclaw@latest
  Installer log: /tmp/tmp.pNNFBZ8shZ
! npm install failed; showing last log lines
! npm install failed; retrying
main: line 638: 248169 Killed                  "${cmd[@]}" > "$log" 2>&1
! npm install failed for openclaw@latest
  Command: env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm --loglevel error --silent --no-fund --no-audit install -g openclaw@latest
  Installer log: /tmp/tmp.x3RUih8v3w
! npm install failed; showing last log lines
[root@iv-yefekgokxs5i3z2zeyx2 ~]# 

用方法：加内存置换空间

# 1. 禁用当前的交换文件
sudo swapoff -v /swapfile

# 2. 删除旧的交换文件
sudo rm /swapfile

# 3. 创建新的 4GB 交换文件
sudo fallocate -l 4G /swapfile
# 如果 fallocate 失败，可以使用 dd 命令（但较慢）：
# sudo dd if=/dev/zero of=/swapfile bs=1M count=4096

# 4. 设置正确的权限
sudo chmod 600 /swapfile

# 5. 格式化为交换空间
sudo mkswap /swapfile

# 6. 启用新的交换文件
sudo swapon /swapfile

# 7. 由于你之前已经添加到 /etc/fstab，现在需要更新
# 先检查 /etc/fstab 中是否有旧的条目
sudo grep -n "/swapfile" /etc/fstab

# 如果有，编辑 /etc/fstab 修改配置
sudo nano /etc/fstab
# 或使用 sed 命令直接替换
sudo sed -i 's/\/swapfile none swap sw 0 0/\/swapfile none swap sw 0 0/' /etc/fstab
# 注意：这行命令实际上没做修改，因为内容一样，只是路径检查