AI创想

标题: OpenClaw详细版配置教程 [打印本页]
作者: 创想小编    时间: 前天 08:22
标题: OpenClaw详细版配置教程
作者：CSDN博客
1. 简介

        openClaw就是一个开源的AI助手项目，接下来介绍一下windows系统的本地部署教程。
2. 步骤

        由于官方推荐在windows系统中使用WSL2运行openclaw。原因是windows也可以运行，但某些插件可能出现兼容性不足的问题，问题比较多；而WSL2是经过官方稳定测试的，因此需要先安装一个WSL2。
2.1 安装WSL2到D盘

        0. 以管理员身份打开 PowerShell 或 命令提示符 (CMD)，逐条运行以下命令，开启WSL2所需的功能。
2.2 在WSL2中部署openClaw

        1、首先按住win+x，选择windows终端(管理员)，然后在终端下输入官网推荐的命令，如下图：
  1. curl -fsSL https://openclaw.ai/install.sh | bash
复制代码
在运行上述命令之前，一定要确保在WSL2里已安装Cmake（版本大于3.9），最后输入openclaw --version检验是否安装成功。
        2、等待安装好之后运行向导，输入以下命令：
  1. openclaw onboard --install-daemon
复制代码
       3、敲击回车之后，开始运行向导，如下图所示：
(, 下载次数: 0)


        4、此处个人选择的是minimax，因为注册之后会送TOKEN，可以先用来体验一下，当然，有实力的更推荐Anthropic。接下来按住回车，进入下一项选择，如下图：
(, 下载次数: 0)


        5、接下来选择第一项即可，然后此时会自动跳转到minimax的网页，授权即可。然后下一步选择接入平台，这里你可以接入飞书等，我这里暂时不接入，所以选择跳过，如下图：
(, 下载次数: 0)


        6、然后选择是否配置skill，skill就是封装的一个流程化的工作流，这里我先选择跳过，有需要可以后边再进行配置，如下图：
(, 下载次数: 0)


        7、接下来将下图四个都选择，按住空格就可以选择，如下图：
(, 下载次数: 0)


        8、下边就是安装网关gateway，默认点击即可。最后选择do this later，如下图：
(, 下载次数: 0)


        9、接下来运行下述命令：
  1. openclaw dashboard
复制代码
       然后回车，此时就会跳转到web界面，即开始chat，提需求和执行任务了，如下图：
(, 下载次数: 0)


3. 故障排查

  Q1：执行命令：wsl --install -d Ubuntu-20.04后出现下述信息：Installing, this may take a few minutes... 参考的对象类型不支持尝试的操作。

     解决方法如下：
Q2：wsl --import Ubuntu D:\WSL\Ubuntu-20.04 D:\WSL\Ubuntu-20.04\Ubuntu-20.04.tar --version 2 WSL 2 执行完上述命令，显示：需要更新其内核组件。

        解决方法如下：
Q3：输入openclaw --version命令后返回openclaw: command not found。

        解决方法：
      在终端中运行以下命令，查看全局 npm 包列表：
             npm list -g --depth=0 | grep openclaw
        如果输出类似 openclaw@2026.2.26，说明包已安装，但命令不可用，问题出在 PATH。
  1.确定 npm 全局 bin 目录
        运行以下命令获取 npm 的全局安装根目录：
        bash
         npm config get prefix
        输出可能类似 /home/liu/.npm-global 或 /usr/local。那么 bin 目录就是在这个路径后面加上 /bin，例如 /home/liu/.npm-global/bin 或 /usr/local/bin。
2.将目录添加到 PATH
        假设你找到的 bin 目录是 /home/liu/.npm-global/bin，执行：
        bash
        export PATH=/home/liu/.npm-global/bin:$PATH
        然后测试：
        bash
        openclaw --version
  3.如果能显示版本号，说明成功。然后将其永久添加到 ~/.bashrc：
        bash
        echo 'export PATH=/home/liu/.npm-global/bin:$PATH' >> ~/.bashrc
         source ~/.bashrc
Q4：运行openclaw gateway start失败

1、先在wsl终端运行sudo vi /etc/wsl.conf，加入以下内容：
  1. [boot]
  2. systemd=true
复制代码
        注意[boot]与systemd之间不能有空隙，然后保存。
2、关闭所有终端，重新打开wsl2，先运行systemctl --user status，看systemd会话是否成功运行，如果显示绿灯则成功。
        3、如果显示绿灯，接下来运行下边命令安装网关：
  1. openclaw gateway install
复制代码
       4、最后运行下述命令：
  1. # 启动服务
  2. systemctl --user start openclaw-gateway.service
复制代码
       5、使用下述命令进行验证，如果显示active(running)则表示成功：
  1. systemctl --user status openclaw-gateway.service
复制代码
       6、接下来运行自检程序，输入以下命令：
  1. openclaw doctor
复制代码
       7、然后重启网关，输入以下命令：
  1. openclaw gateway restart
复制代码
       8、最后打开tui，尝试对话，命令如下：
  1. openclaw tui
复制代码
4、openclaw接入deepseek步骤

1、获取 DeepSeek API 密钥
2、 在 OpenClaw 中配置 DeepSeek 模型
        首先输入以下命令：
  1. openclaw configure --section model
复制代码
       然后按提示操作：
3、输入以下命令重启网关使配置生效：
  1. systemctl --user restart openclaw-gateway.service
复制代码
4、最后输入以下命令验证配置是否成功：
  1.         openclaw models status
复制代码
确认输出中：
5、输入以下命令测试聊天：
  1. openclaw tui
复制代码
       输入任意消息，例如“你好”，观察是否能正常回复。
6、在 TUI 中使用（可选）
        如果启动 TUI 后仍提示旧模型认证错误（如 openai-codex），可在 TUI 中手动切换模型：
  1. /model deepseek-2/deepseek-reasoner
复制代码
或重置会话后重启 TUI：
  1. openclaw session reset --agent main --session main
  2.         openclaw tui
复制代码
原文地址：https://blog.csdn.net/weixin_52247452/article/details/158266627



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