OpenClaw 安装及配置接入 API 方法#
准备工作#
1.
下载并安装 Node.js :推荐 Node 24(也支持 Node 22.14+) 2.
创建一个我们平台的密钥 API令牌,建议用default默认分组; 可使用 node --version 检查你的 Node 版本。如果版本不符合要求,可运行以下命令将旧版OpenClaw + Node.js + npm 版本管理器残留一起清掉。
/bin/bash -c 'set -u; echo "== 开始彻底清理 OpenClaw / Node.js / npm =="; command -v openclaw >/dev/null 2>&1 && openclaw uninstall || true; command -v brew >/dev/null 2>&1 && { brew uninstall --cask openclaw 2>/dev/null || true; brew uninstall node 2>/dev/null || true; brew cleanup 2>/dev/null || true; }; pkill -f openclaw 2>/dev/null || true; pkill -if "OpenClaw" 2>/dev/null || true; sudo rm -rf /Applications/OpenClaw.app /opt/homebrew/Caskroom/openclaw /usr/local/bin/node /usr/local/bin/npm /usr/local/bin/npx /usr/local/lib/node_modules /usr/local/include/node /usr/local/share/man/man1/node.1 /usr/local/share/doc/node /usr/local/share/systemtap/tapset/node.stp /opt/homebrew/bin/node /opt/homebrew/bin/npm /opt/homebrew/bin/npx /opt/homebrew/lib/node_modules /opt/homebrew/include/node /opt/homebrew/share/man/man1/node.1; rm -rf "$HOME/.openclaw" "$HOME/.npm" "$HOME/.nvm" "$HOME/.node-gyp" "$HOME/.npmrc" "$HOME/.pnpm-store" "$HOME/.yarn" "$HOME/.volta" "$HOME/.fnm" "$HOME/.nodebrew" "$HOME/.asdf/installs/nodejs" "$HOME/.asdf/plugins/nodejs" "$HOME/.local/share/mise/installs/node" "$HOME/Library/Application Support/OpenClaw" "$HOME/Library/Caches/OpenClaw" "$HOME/Library/Preferences/com.openclaw.plist"; rm -rf "$HOME"/Library/LaunchAgents/*openclaw* "$HOME"/Library/Preferences/*openclaw* "$HOME"/Library/Caches/*openclaw* 2>/dev/null || true; for f in "$HOME/.zshrc" "$HOME/.bashrc" "$HOME/.bash_profile" "$HOME/.profile"; do [ -f "$f" ] || continue; cp "$f" "$f.bak.$(date +%Y%m%d%H%M%S)" 2>/dev/null || true; /usr/bin/sed -i "" "/openclaw/d;/NVM_DIR/d;/nvm.sh/d;/bash_completion.*nvm/d;/nodebrew/d;/fnm/d;/volta/d;/asdf.*nodejs/d;/mise.*node/d" "$f" 2>/dev/null || true; done; if command -v openclaw >/dev/null 2>&1; then sudo rm -f "$(command -v openclaw)" 2>/dev/null || true; fi; hash -r 2>/dev/null || true; export SHELL_BIN="${SHELL:-/bin/zsh}"; echo; echo "== 检查结果 =="; "$SHELL_BIN" -lc '"'"'command -v openclaw >/dev/null 2>&1 && echo "openclaw -> $(command -v openclaw)" || echo "openclaw not found"; command -v node >/dev/null 2>&1 && echo "node -> $(command -v node)" || echo "node not found"; command -v npm >/dev/null 2>&1 && echo "npm -> $(command -v npm)" || echo "npm not found"'"'"'; echo "== 完成 =="'
openclaw not found
node not found
npm not found
安装及配置 OpenClaw#
第一步:运行安装脚本#
打开终端命令行工具运行以下安装脚本,这是最快的安装方式。它会检测你的操作系统,在需要时安装 Node,安装 OpenClaw,并启动新手引导。第二步:运行初始化向导#
安装后会自动进入配置向导,或者使用以下命令启动配置向导向导会交互式引导你完成所有配置,包括:AI 模型、聊天渠道、技能、Hooks、Gateway 服务安装等。2.
选择启动模式:推荐选择 QuickStart 快速启动:
3.
选择AI模型提供商:选择 Custom Provider:
端点默认的 OpenAI-compatible 即可
模型ID:输入模型广场支持的模型ID如:gpt-5.4
7.
选择Skills:使用空格键选择你需要的技能,也可以直接跳过:
8.
启用Hooks:推荐启用这三个钩子(用于内容引导、日志和会话记录):
第三步:修改配置文件#
根据自己系统找到 OpenClaw 配置文件的存放目录 .openclaw ,一般位于:
• Windows: C:\Users\用户名文件夹\ .openclaw
• Mac / Linux: ~/.claude
macOS 在访达界面按下 “Command+Shift+G”,输入路径 ~/.openclaw 回车,即可打开这个目录在配置目录下找到 openclaw.json 这个配置文件,对应修改 contextWindow 和 maxTokens 这两项配置其他各项配置你也可以根据需要手动编 辑修改配置文件启动及使用 OpenClaw#
打开终端聊天界面 TUI 命令(你可以在终端中与 Bot 对话)💡 退出 TUI(Ctrl+C)不会停止 Gateway,聊天软 件仍然可以正常使用。打开 Web UI 页面命令(你也可以通过浏览器和 Bot 对话)onboard 向导已经自动安装了 Gateway 的 systemd 服务(Linux),Bot 会在后台持续运行。查看状态:看到 Gateway service: running 就说明一切正常。