Picoclaw setup on Oracle Cloud (with Ollama)

Watch the YouTube tutorial

1. Download Telegram App on phone and register
2. Download Telegram Desktop App on computer and login
3. On a terminal

# install Ollama
curl -fsSL https://ollama.com/install.sh | sh # for  Linux

You will see this:
"Created symlink /etc/systemd/system/default.target.wants/ollama.service → /etc/systemd/system/ollama.service.
>>> The Ollama API is now available at 127.0.0.1:11434."
You can copy the address and open it on your browser to check Ollama running status.

# Pull the desired model
Ollama pull qwen3-vl:8b # replace with your model

# Check the model list
Ollama ls


# install Go
wget https://go.dev/dl/go1.23.5.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.5.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

# install Picoclaw and build
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
make build
make install

# Initialize
picoclaw onboard

# if error occurs: "picoclaw: command not found"
(# Add the directory to your .bashrc file
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# Reload the configuration for the current session
source ~/.bashrc)

# configuration file
sudo nano ~/.picoclaw/config.json

# Paste the following content in the config.json file:

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "ollama/qwen3-vl:8b", # replace with your model
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "ollama": {
      "api_key": "dummy",
      "api_base": "http://localhost:11434/v1"
    }
  },
  "tools": {
    "web": {
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "", # your token from telegram
      "allowFrom": ["6961858793"]
    }
  },
  "cron": {
    "exec_timeout_minutes": 5 # change to a larger number if using a thinking model
   },
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}


# Test agent
picoclaw agent -m "Hi"

# Start gateway
picoclaw gateway

4. Test it on telegram and enjoy using your assistant Picoclaw